Pobierz wpisy metaobiektu

Możesz użyć akcji Pobierz wpisy metaobiektu, aby pobrać listę wpisów dla metaobiektu ze swojego sklepu na podstawie opcjonalnego zapytania. Więcej informacji można znaleźć w dokumentacji metaobiektów.

Konfiguracja

Pola

Akcja Pobierz wpisy metaobiektu zawiera menu rozwijane do określania definicji metaobiektu oraz następujące pola, które służą do tworzenia zapytania:

Ciąg zapytania

Oto przykład zapytania do pobierania wpisów metaobiektów w przypadku, gdy wartość pola email jest zgodna z adresem e-mail w zamówieniu:

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

Oto przykład zapytania do pobierania wpisów metaobiektów, które zostały zaktualizowane w ostatnim dniu:

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

Zmienna updated_at jest filtrem dostępnym w zapytaniu o metaobiekty i może być używana wielokrotnie lub łączona z innymi zmiennymi. Zmienna Liquid scheduledAt jest dostępna w workflow, w których zastosowano wyzwalacz Czas zaplanowany. Tag Liquid date_minus jest specjalnym tagiem Flow, który pozwala odjąć czas od daty.

Podczas wykonywania zapytań o dane warto wiedzieć:

• Lista dostępnych filtrów metaobiektów
• Wykonywanie zapytań o metaobiekty według wartości pola wymaga, aby metaobiekt miał włączone filtrowanie, co można włączyć w opcjach danych niestandardowych panelu administracyjnego Shopify.
• Zapytania muszą być zgodne z określoną składnią
• Wartości pól zapytań nie zawsze są udokumentowane. W niektórych przypadkach wartości te można znaleźć, przeglądając dokumentację API. Alternatywnie wartości pól często można znaleźć w adresach URL w panelu administracyjnym po zastosowaniu filtrów. Na przykład, aby znaleźć wartości zapytań dotyczących zamówień, odfiltruj pozycje na stronie Zamówienia w panelu administracyjnym, a następnie sprawdź adres URL.
• Możesz uruchomić lub przetestować zapytanie w swoim sklepie za pomocą aplikacji Shopify GraphiQL.
• Zwróć uwagę na to, co się stanie, jeśli zapytanie zakończy się niepowodzeniem. Często API zwróci wszystkie wyniki (zamiast żadnego).

Zwrócone dane

Wszystkie akcje typu Pobierz dane zwracają listę zawierającą od 0 do 100 zasobów. W zależności od przypadku użycia możesz chcieć wykorzystać te dane na różne sposoby:

• Jeśli chcesz obsługiwać każdą pozycję z listy indywidualnie, np. dodać tag dla każdej z nich, możesz użyć akcji Dla każdego.
• Jeśli chcesz agregować dane, np. policzyć, ile wyników zostało zwróconych, możesz użyć akcji Policz lub Zsumuj.
• Jeśli chcesz przekazać listę, np. wysłać e-mail ze wszystkimi pozycjami, możesz użyć zwróconych danych bezpośrednio w kolejnych akcjach.

Aby uzyskać dostęp do zwróconych danych w krokach następujących po tej akcji, użyj zmiennej o nazwie Pobierz wpisy metaobiektów, która jest listą wpisów metaobiektów. Możesz użyć tej zmiennej zarówno w warunkach, jak i w akcjach. Na przykład możesz wysłać listę par klucz-wartość dla wpisów metaobiektów w akcji Wyślij wewnętrzną wiadomość e-mail w następujący sposób:

{% 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 %}

Wyzwalacze

Możesz użyć tej akcji w dowolnym workflow, w tym z wyzwalaczem Czas zaplanowany. W workflow, który używa wyzwalacza Czas zaplanowany, workflow uruchamia się o określonej przez Ciebie godzinie, a nie w wyniku zdarzenia. Ponieważ nie ma określonego zdarzenia w Twoim sklepie lub z aplikacji, które uruchamia workflow, żadne dane nie są dołączane automatycznie.

Szczegóły API

• Zasób metaobiektu
• Filtry zapytań o metaobiekty
• Wykonywanie zapytań o metaobiekty według wartości pola