Meta nesne girişlerini al

İsteğe bağlı sorguya göre mağazanızdan bir meta nesneye ait girişlerin listesini almak için Meta nesne girişlerini al eylemini kullanabilirsiniz. Daha fazla bilgi için meta nesnelerle ilgili belgelere bakın.

Yapılandırma

Alanlar

Meta nesne girişlerini al eylemi, meta nesne tanımını belirtmek için bir açılır menünün yanı sıra sorguyu oluşturmak için kullanılan aşağıdaki alanları içerir:

Sorgu dizesi

Bu, bir e-posta alanının değeri bir siparişteki e-posta adresiyle eşleştiğinde meta nesne girişlerini almak için kullanılan örnek bir sorgudur:

{{fields.email}}:"{{order.email}}"

Bu, son gün içinde güncellenen meta nesne girişlerini almak için kullanılan ö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 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 mevcuttur. date_minus Liquid etiketi, bir tarihten zaman çıkarmanıza olanak tanıyan özel bir Flow etiketidir.

Veri sorgularken aşağıdakileri bilmek faydalı olacaktır:

• Kullanılabilir meta nesne filtrelerinin listesi
• Meta nesneleri alan değerine göre sorgulamak, meta nesnede filtrelemenin etkinleştirilmiş olmasını gerektirir. Bu özellik, Shopify yöneticisindeki özel veri seçeneklerinden etkinleştirilebilir.
• Sorgular belirli bir söz dizimine uymalıdır
• Sorgu alanı değerleri her zaman belgelenmez. Bazı durumlarda bu değerler API belgelerine bakılarak bulunabilir. Alternatif olarak, yönetici panelinde filtreleme yaptığınızda alan değerlerini genellikle URL'lerde bulabilirsiniz. Örneğin, bazı Sipariş sorgu değerlerini bulmak için yönetici panelindeki Siparişler sayfasını filtreleyin ve ardından URL'yi kontrol edin.
• Mağazanızda bir sorguyu çalıştırmak veya test etmek için Shopify GraphiQL uygulamasını kullanabilirsiniz.
• 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 birine etiket eklemek gibi, liste öğelerinin her birini ayrı ayrı işlemeniz gerekiyorsa For each eylemini kullanabilirsiniz.
• Döndürülen sonuçların sayısını saymak gibi, verileri toplamanız gerekiyorsa Count veya Sum eylemlerini kullanabilirsiniz.
• Tüm ürünleri içeren bir e-posta göndermek gibi, listenin çıktısını 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 Meta nesne girişlerini al adlı değişkeni kullanın. Bu değişken, bir meta nesne girişleri listesidir. Bu değişkeni hem koşullarda hem de eylemlerde kullanabilirsiniz. Örneğin, Dahili e-posta gönder eyleminde meta nesne girişlerine yönelik anahtar-değer çiftlerinin listesini şu şekilde 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 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 olmaz.

API ayrıntıları

• Meta nesne kaynağı
• Meta nesne sorgu filtreleri
• Meta nesneleri alan değerine göre sorgulama