Meta nesne girişlerini al
İsteğe bağlı sorguya göre mağazanızdan bir meta nesneyle ilgili girişlerin listesini almak üzere Meta nesne girişlerini al işlemini kullanabilirsiniz. Daha fazla bilgi için meta nesne belgelerine bakın.
Yapılandırma
Alanlar
Meta nesne girişlerini al işlemi, meta nesne tanımını belirtmeye yarayan bir açılan listenin yanı sıra sorguyu oluşturmak için kullanılan aşağıdaki alanları içerir:
Alan | Açı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. |
Sorgu | Gerekli. Yaygın sorgulardan birini seçin veya kendi sorgunuzu oluşturmak için Gelişmiş'i seçin. |
Sorgu Dizesi
Bu, email
alanının değeri bir siparişteki e-posta adresiyle eşleşiyorsa meta nesne girişlerini almaya yarayan bir örnek sorgudur:
{{fields.email}}:"{{order.email}}"
Bu, son gün içinde güncellenen meta nesne girişlerini almaya yarayan örnek bir sorgudur:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'
updated_at
değişkeni, Meta nesneler sorgusunda kullanılabilen 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 kullanılabilir. date_minus
Liquid etiketi, bir tarihten zaman eksiltmenize olanak sağlayan özel bir Flow etiketidir.
Veri sorgusu yaparken şunları bilmek faydalıdır:
- Kullanılabilir meta nesne filtrelerinin listesi
- Meta nesneleri alan değerine göre sorgulama, meta nesnede filtrelemenin etkin olmasını gerektirir; filtreleme özelliği Shopify yöneticisindeki özel veri seçeneklerinden etkinleştirilebilir. - Sorgular belirli bir sözdizimine sahip olmalıdır
- 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 meta nesne girişlerinin listesi olan Meta nesne girişlerini al adlı değişkeni kullanın. Bu değişkeni hem durumlarda hem işlemlerde kullanabilirsiniz. Örneğin meta nesne girişlerine yönelik anahtar-değer çiftlerinin listesini, aşağıdakine benzer şekilde Dahili e-posta gönder işlemiyle gönderebilirsiniz:
{% for getMetaobjectEntries_item in getMetaobjectEntries %}
Key-value pairs for entry:
{% for fields_item in getMetaobjectEntries_item.system.fields %}
{{fields_item.key}}:{{fields_item.value}}
{% endfor %}
{% 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.