Pobieranie wpisów metaobiektów

Za pomocą czynności Pobieranie wpisów metaobiektów możesz wywołać listę wpisów dla metaobiektów ze swojego sklepu na podstawie opcjonalnego zapytania. Aby uzyskać więcej informacji, zapoznaj się z dokumentacją dotyczącą metaobiektów.

Konfiguracja

Pola

Czynność Pobieranie wpisów metaobiektów zawiera listę rozwijaną służącą do określania definicji metaobiektu, a także następujące pola, które są używane do tworzenia zapytania:

Pola używane w czynnościach Pobierz dane.
PoleOpis
Sortuj dane wedługWymagane. Parametry, według których sortowane są dane zwracane przez zapytanie wyszukiwania.
Maksymalna liczba wynikówWymagane. Maksymalna liczba wyników, które mogą zostać zwrócone przez wybrane zapytanie wyszukiwania. Jednorazowo możesz zwrócić maksymalnie 100.
ZapytanieWymagane. Wybierz jedno z typowych zapytań lub opcję Zaawansowane, aby utworzyć własne.

Ciąg znaków zapytania

Oto przykład zapytania mającego na celu pobranie wpisów metaobiektów, jeśli wartość pola email odpowiada adresowi e-mail w zamówieniu:

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

To jest przykładowe zapytanie umożliwiające pobranie wpisów metaobiektów, które zostały uaktualnione 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. Można jej używać wielokrotnie lub w połączeniu z innymi zmiennymi. Zmienna Liquid scheduledAt jest dostępna w procesach workflow, w których używany był wyzwalacz Zaplanowany czas. date_minus Tag Liquid jest specjalnym tagiem Flow, który umożliwia odejmowanie czasu od daty.

Podczas zapytywania o dane warto znać:

Zwrócone dane

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

  • Jeśli musisz obsługiwać każdą pozycję listy indywidualnie, np. aby dodać tag dla każdej z nich, możesz użyć czynności Dla każdej.
  • Jeśli chcesz zagregować dane, na przykład policzyć, ile wyników zostało zwróconych, możesz użyć czynności Liczba lub Suma.
  • Jeśli musisz wyprowadzić listę, na przykład wysłać e-mail ze wszystkimi pozycjami, możesz wykorzystać zwrócone dane bezpośrednio w kolejnych działaniach.

Aby uzyskać dostęp do zwróconych danych w krokach następujących po tej czynności, użyj zmiennej o nazwie getMetaobjectEntries, która jest listą metaobiektów. Możesz użyć tej zmiennej zarówno dla warunków, jak i dla czynności. Przykładowo, możesz wysłać listę par klucz-wartość dla wpisów metaobiektów w czynności 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 czynności w każdym workflow, w tym w wyzwalaczu Zaplanowany czas. W workflow, który używa wyzwalacza Zaplanowany czas, workflow rozpoczyna się w określonym czasie, a nie w wyniku zdarzenia. Ponieważ nie ma żadnego konkretnego zdarzenia w Twoim sklepie lub w aplikacji, które uruchamia workflow, żadne dane nie są dołączane automatycznie.

Szczegóły API

Nie możesz znaleźć odpowiedzi, których szukasz? Jesteśmy tutaj, aby Ci pomóc.