Sipariş verilerini al

Sipariş verileri gerektiren iş akışlarında mağazanızdan sipariş verilerini almak için Sipariş verilerini al işlemini kullanabilirsiniz.

Yapılandırma

Alanlar

Sipariş verilerini al işlemi, sorguyu oluşturmak için kullanılan aşağıdaki alanları içerir:

Veri al işlemlerinde kullanılan alanlar.
AlanAçıklama
Verileri sıralama ölçütüGereklidir. Arama sorgusu tarafından döndürülen verilerin sıralanmasında kullanılan parametreler.
Maksimum sonuç sayısıGerekli. Seçtiğiniz arama sorgusu tarafından döndürülebilecek maksimum sonuç sayısı. Bir seferde 100 adede kadar sonuç döndürebilirsiniz.
SorguGerekli. Yaygın sorgulardan birini seçin veya kendi sorgunuzu oluşturmak için Gelişmiş'i seçin.

Sorgu Dizesi

Bu, son bir gün içinde güncellenen siparişleri almaya yönelik örnek bir sorgudur:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

updated_at değişkeni, Siparişler sorgusunda bulunan bir filtredir ve bir defadan fazla kullanılabilir veya diğer değişkenlerle birleştirilebilir. scheduledAt Liquid değişkeni, Planlanan zaman tetikleyicisini kullanan iş akışlarında bulunur. date_minus Liquid etiketi, bir tarihten zaman eksiltmenize olanak sağlayan özel bir Flow etiketidir.

Veri sorgusu yaparken şunları bilmek faydalıdır:

  • Mevcut sipariş filtrelerinin listesi - Sorgular belirli bir sözdizimine sahip olmalıdır
  • Tüm sorgular için sorgu alanı adları, QueryRoot nesnesi ile ilgili geliştirici belgelerinde bulunabilir.
  • Sorgu alanı değerleri her zaman belgelenmez. Bazı durumlarda değerler, API belgelerine bakarak bulunabilir. Alternatif olarak, filtreleme yaparken alan değerlerini genellikle Yöneticideki URL'lerde bulabilirsiniz. Örneğin, bazı Sipariş sorgusu değerlerini bulmak için Yöneticideki Siparişler sayfasını filtreleyin ve URL'yi kontrol edin.
  • Shopify GraphiQL uygulamasını kullanarak mağazanızda bir sorguyu çalıştırabilir veya test edebilirsiniz.
  • Sorgunuz başarısız olursa ne olacağına dikkat etmeniz gerekir. Genellikle API tüm sonuçları (sıfır sonuç yerine) döndürür.

Döndürülen veriler

Tüm Veri al işlemleri, 0 ile 100 arasında kaynağın bir listesini döndürür. Kullandığınız duruma bağlı olarak, bu verileri çeşitli şekillerde kullanmak isteyebilirsiniz:

  • Her liste öğesi için ayrı ayrı işlem yapmanız gerekiyorsa (her birine bir etiket eklemek gibi), For each eylemini kullanabilirsiniz.
  • Verileri toplamanız gerekiyorsa (kaç sonuç döndürüldüğünü saymak gibi) Count veya Sum işlemlerini kullanabilirsiniz.
  • Listenin çıktısını almanız gerekiyorsa (tüm öğeleri içeren bir e-posta göndermek gibi) döndürülen verileri sonraki işlemlerde doğrudan kullanabilirsiniz.

Bu işlemi takip eden adımlarda döndürülen verilere erişmek için, siparişlerin bir listesini içeren Sipariş verilerini al adlı değişkeni kullanın. Bu değişkeni hem koşullarda hem de işlemlerde kullanabilirsiniz. Örneğin, aşağıda gösterildiği gibi, gönderim siparişlerinin bir listesini Dahili e-posta gönder işlemiyle gönderebilirsiniz:

{% for single_order in GetOrderData %}
- {{ single_order.name }}
{% endfor %}

Tetikleyiciler

Bu işlemi, Planlanan zaman tetikleyicisi de dahil olmak üzere herhangi bir iş akışında kullanabilirsiniz. Planlanan zaman tetikleyicisini kullanan bir iş akışı, etkinlik sonucunda değil, belirttiğiniz zamanda başlatılır. Mağazanızdan veya iş akışını başlatan bir uygulamadan gelen belirli bir etkinlik olmadığından hiçbir veri otomatik olarak dahil edilmez.

Örnek

Haftada bir kez tekrarlanan, geçen hafta oluşturulan siparişleri kontrol eden ve toplam harcamaları 100 USD veya daha yüksek bir tutara artıran müşterilere etiketler ekleyen iş akışı örneği.

Bu örnek iş akışında, bir iş akışı her pazar saat 09:00'da başlayacak şekilde planlandı. Sipariş verilerini al işlemi, geçen hafta oluşturulan siparişlerin verilerini toplamak için kullanılır. Siparişle ilişkili müşterin toplam harcama tutarı 100 USD'den fazlaysa müşteriye Gold etiketi uygulanır.

API Referansı

Aradığınız cevapları bulamıyor musunuz? Yardımcı olmak için buradayız.