Makale verilerini al

Blog makalesi verileri gerektiren iş akışlarında, Shopify mağazanızdan makale bilgilerini almak için Makale verilerini al işlemini kullanabilirsiniz.

Not

Bu, bir tür Veri al işlemidir. Bu işlem türünü Planlanan zaman tetikleyicisi ve Her biri için döngüleriyle nasıl kullanacağınızı anlamak için Shopify Flow'da planlar, veri alma ve döngüsel iş akışları bölümüne bakın.

Yapılandırma

Alanlar

Makale verilerini al işlemi aşağıdaki alanları içerir:

Veri al işlemlerinde kullanılan alanlar.

Alan	Açıklama
Verileri şuna göre sırala	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ç miktarı. 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

Geçtiğimiz gün yayınlanan makaleleri almak için örnek bir sorgu şudur:

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

published_at değişkeni Makale sorgusu üzerinde kullanılabilen bir filtredir ve birden çok kez 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 çıkarmanızı sağlayan özel bir Flow etiketidir.

Verileri sorgularken şunları bilmeniz faydalı olur:

• Kullanılabilir makale filtreleri listesi

• Sorgular belirli bir söz dizimini izlemelidir

• 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 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.

• Sorgunuzun başarısız olması durumunda ne olacağına dikkat edin. Genellikle API (hiçbir sonuç yerine) tüm sonuçları döndürür.

Döndürülen veriler

Tüm Veri al işlemleri 0 ile 100 kaynak arasında bir liste döndürür. Kullanım alanınıza bağlı olarak bu verileri farklı şekillerde kullanmak isteyebilirsiniz:

• Her biri için etiket eklemek gibi işlemleri her bir liste öğesi için ayrı ayrı yapmanız gerekiyorsa Her biri için işlemini kullanabilirsiniz.
• Kaç sonuç döndürüldüğünü saymak gibi işlemleri verileri toplayarak yapmak istiyorsanız Say veya Topla işlemlerini kullanabilirsiniz.
• Tüm öğelerin bulunduğu bir e-posta göndermek gibi işlemlerle listeyi çıkarmanız gerekiyorsa sonraki işlemlerde doğrudan döndürülen verileri kullanabilirsiniz.

Bu işlemi takip eden adımlarda döndürülen verilere erişmek için bir makale listesi olan Makale verilerini al adlı değişkeni kullanın. Bu değişkeni hem koşullarda hem de işlemlerde kullanabilirsiniz. Örneğin, makale listesini şuna benzer bir Şirket içi e-posta gönder işleminde gönderebilirsiniz:

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% endfor %}

Not

Tek bir iş akışında birden fazla kez bir Veri al işlemi kullanılıyorsa değişken adına bir sayı eklenir. Örneğin, Sipariş verilerini al işlemini iki kez kullanan bir iş akışında döndürülen verilerin ilk değişkeni getOrderData, ikinci değişkeni ise getOrderData1 olur. Bu ad özelleştirilemez.

Tetikleyiciler

Bu işlemi, Planlanan zaman tetikleyicisi dahil olmak üzere tüm iş akışlarında kullanabilirsiniz. Planlanan zaman tetikleyicisini kullanan bir iş akışında, iş akışı bir olayın sonucu olarak değil, sizin belirttiğiniz bir zamanda başlar. Mağazanızda veya bir uygulamada iş akışını başlatan belirli bir olay olmadığı için veriler otomatik olarak dahil edilmez.

API referansı

Bu işlemde kullanılan API hakkında daha fazla bilgi edinmek için Makaleler sorgusu sayfasına bakın.