Taslak sipariş verilerini al
Taslak sipariş verilerini kullanan iş akışlarında, mağazanızdan taslak sipariş bilgilerini almak için Taslak sipariş verilerini al eylemini kullanabilirsiniz.
Yapılandırma
Alanlar
Taslak sipariş verilerini al eylemi, sorguyu oluşturmak için kullanılan aşağıdaki alanları içerir:
| Alan | Açıklama |
|---|---|
| Verileri sıralama ölçütü | Gerekli. Arama sorgusundan döndürülen verilerin sıralanacağı parametreler. |
| Maksimum sonuç sayısı | Gerekli. Seçtiğiniz arama sorgusunun döndürebileceği maksimum sonuç sayısıdır. Tek seferde en fazla 100 sonuç döndürebilirsiniz. |
| Sorgu | Gerekli. Yaygın sorgular arasından seçim yapın veya kendinizinkini oluşturmak için Gelişmiş'i seçin. |
Sorgu Dizesi
Aşağıda, son gün içinde güncellenen taslak siparişleri almaya yönelik bir örnek sorgu verilmiştir:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'updated_at değişkeni, Taslak siparişler sorgusunda kullanılabilen bir filtredir ve birden çok kez kullanılabilir ya da diğer değişkenlerle birleştirilebilir. scheduledAt Liquid değişkeni, Planlanmış zaman tetikleyicisini kullanan iş akışlarında mevcuttur. date_minus Liquid etiketi, bir tarihten zaman çıkarmanıza olanak tanıyan özel bir Flow etiketidir.
Verileri sorgularken şunları bilmek faydalı olacaktır:
- Kullanılabilir sipariş filtrelerinin listesi
- Sorgular belirli bir söz dizimini izlemelidir
- Sorgu alanı değerleri her zaman belgelenmez. Bazı durumlarda bu değerler, API belgelerine bakılarak bulunabilir. Alternatif olarak, filtreleme yaptığınızda alan değerlerini genellikle Yönetici'deki URL'lerde bulabilirsiniz. Örneğin, bazı Sipariş sorgusu değerlerini bulmak için Yönetici'de Siparişler sayfasını filtreleyin ve ardından URL'yi kontrol edin.
- Mağazanızda bir sorguyu Shopify GraphiQL uygulamasını kullanarak çalıştırabilir veya test edebilirsiniz.
- Sorgunuz başarısız olursa ne olacağına dikkat edin. API genellikle hiçbir sonuç döndürmek yerine tüm sonuçları döndürür.
Döndürülen veriler
Tüm Veri al eylemleri, 0 ila 100 arasında kaynak içeren bir liste döndürür. Kullanım örneğinize bağlı olarak, bu verileri çeşitli şekillerde kullanmak isteyebilirsiniz:
- Her bir liste öğesini ayrı ayrı işlemeniz (örneğin her birine etiket eklemek gibi) gerekiyorsa Her biri için eylemini kullanabilirsiniz.
- Döndürülen sonuçların sayısını saymak gibi toplu veriye ihtiyacınız varsa Sayı veya Toplam eylemlerini kullanabilirsiniz.
- Listeyi çıktı olarak almanız (örneğin tüm ürünleri içeren bir e-posta göndermeniz) gerekiyorsa döndürülen verileri doğrudan sonraki eylemlerde kullanabilirsiniz.
Bu eylemi izleyen adımlarda döndürülen verilere erişmek için taslak siparişlerin bir listesi olan Get draft order data adlı değişkeni kullanın. Bu değişkeni hem koşullarda hem de eylemlerde kullanabilirsiniz. Örneğin, taslak siparişlerin listesini bir Dahili e-posta gönder eyleminde şu şekilde gönderebilirsiniz:
{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% endfor %}Tetikleyiciler
Bu eylemi, Planlanmış zaman tetikleyicisi de dahil olmak üzere herhangi bir iş akışında kullanabilirsiniz. Planlanmış zaman tetikleyicisini kullanan bir iş akışında, iş akışı bir olayın sonucu olarak değil, belirttiğiniz bir zamanda başlar. İş akışını başlatan, mağazanızda veya bir uygulamada gerçekleşen belirli bir olay olmadığından, otomatik olarak eklenen hiçbir veri olmaz.
API ayrıntıları
Şablonlar
Tüm açık Taslak Siparişler ile günlük bildirim gönder
Her gün, açık taslak siparişleri alın, sayın ve bir Slack mesajı gönderin. Planlanmış zaman tetikleyicisini, Taslak sipariş verilerini al ve Say eylemlerini kullanır. Şablonu görüntüle