Koleksiyon verilerini al
Koleksiyon verileri gerektiren iş akışlarında, mağazanızdan koleksiyon bilgilerini almak için Koleksiyon verilerini al eylemini kullanabilirsiniz.
Yapılandırma
Alanlar
Koleksiyon verilerini al eylemi aşağıdaki alanları içerir.
| Alan | Açıklama |
|---|---|
| Verileri sıralama ölçütü | Gerekli. Arama sorgusu tarafından döndürülen verilerin sıralanacağı parametreler. |
| Maksimum sonuç sayısı | Gerekli. Seçtiğiniz arama sorgusu tarafından döndürülebilecek 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 kendi sorgunuzu oluşturmak için Gelişmiş'i seçin. |
Sorgu dizesi
Bu, son bir gün içinde güncellenen koleksiyonları almak için kullanılan örnek bir sorgudur:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'updated_at değişkeni, Koleksiyonlar 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, Zamanlanmış zaman tetikleyicisini kullanan iş akışlarında kullanılabilir. date_minus Liquid etiketi, bir tarihten zaman çıkarmanıza olanak tanıyan özel bir Flow etiketidir.
Veri sorgularken aşağıdakileri bilmek faydalıdır:
- Kullanılabilir koleksiyon filtrelerinin listesi
- Sorgular belirli bir söz dizimine uymalıdır
- Sorgu alanı değerleri her zaman belgelenmez. Bazı durumlarda değerler, API belgelerine bakılarak bulunabilir. Alternatif olarak, filtreleme yaptığınızda alan değerlerini genellikle yönetici panelindeki URL'lerde bulabilirsiniz. Örneğin, bazı Sipariş sorgusu değerlerini bulmak için yönetici panelinde 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 işlemleri, 0 ila 100 arasında kaynak içeren bir liste döndürür. Kullanım senaryonuza bağlı olarak bu verileri çeşitli şekillerde kullanmak isteyebilirsiniz:
- Her birine etiket eklemek gibi, her bir liste öğesini ayrı ayrı işlemeniz gerekiyorsa Her biri için eylemini kullanabilirsiniz.
- Döndürülen sonuçların sayısını bulmak gibi verileri toplamanız gerekiyorsa Sayı veya Toplam eylemlerini kullanabilirsiniz.
- Tüm ürünleri içeren bir e-posta göndermek gibi, listeyi çıktı olarak almanız gerekiyorsa döndürülen verileri sonraki eylemlerde doğrudan kullanabilirsiniz.
Bu eylemi izleyen adımlarda döndürülen verilere erişmek için, bir koleksiyonlar listesi olan Koleksiyon verilerini al adlı değişkeni kullanın. Bu değişkeni hem koşullarda hem de eylemlerde kullanabilirsiniz. Örneğin, koleksiyonlar listesini bir Dahili e-posta gönder eyleminde şu şekilde gönderebilirsiniz:
{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% endfor %}Tetikleyiciler
Bu eylemi, Zamanlanmış zaman tetikleyicisi de dahil olmak üzere tüm iş akışlarında kullanabilirsiniz. Zamanlanmış 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ızdaki veya bir uygulamadaki belirli bir olay olmadığından otomatik olarak eklenen hiçbir veri yoktur.