Pobierz dane katalogu

W przepływach pracy, które wymagają danych katalogu, możesz użyć akcji Pobierz dane katalogu, aby pobrać informacje o katalogu B2B ze sklepu. Katalogi to grupy produktów z niestandardowymi cenami dla określonych klientów B2B lub lokalizacji firmy.

Na tej stronie

Konfiguracja

Pola

Akcja Pobierz dane katalogu zawiera następujące pola:

Pola używane w akcjach Pobierz dane.
Pole	Opis
Sortuj dane według	Wymagane. Parametry, według których sortowane są dane zwracane przez zapytanie wyszukiwania.
Maksymalna liczba wyników	Wymagane. Maksymalna liczba wyników, które mogą zostać zwrócone przez wybrane zapytanie wyszukiwania. Jednocześnie można zwrócić do 100 wyników.
Zapytanie	Wymagane. Wybierz z typowych zapytań lub wybierz opcję Zaawansowane, aby utworzyć własne.

Ciąg znaków zapytania

Oto przykładowe zapytanie umożliwiające pobranie wszystkich aktywnych katalogów:

status:ACTIVE

Zmienna status to filtr dostępny w zapytaniu o katalogi, którego można użyć wielokrotnie lub połączyć z innymi zmiennymi.

Podczas tworzenia zapytań o dane warto wiedzieć, że:

Lista dostępnych filtrów katalogów
Zapytania muszą być zgodne z określoną składnią
Wartości pól zapytań nie zawsze są udokumentowane. W niektórych przypadkach można je znaleźć, sprawdzając dokumentację API. Często wartości pól można też znaleźć w adresach URL w panelu administracyjnym podczas filtrowania. Na przykład, aby znaleźć niektóre wartości zapytań dla zamówień, pofiltruj stronę 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.
Należy pamiętać o tym, co się stanie w przypadku niepowodzenia zapytania. Często API zwraca wszystkie wyniki (zamiast żadnego).

Zwrócone dane

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

Jeśli musisz przetwarzać każdą pozycję na liście indywidualnie, np. w celu dodania tagu do każdej z nich, możesz użyć akcji Dla każdego.
Jeśli musisz zagregować dane, np. policzyć zwrócone wyniki, możesz użyć akcji Zlicz lub Suma.
Jeśli musisz wygenerować listę, np. aby 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 dane katalogu, która jest listą katalogów. Możesz jej używać zarówno w warunkach, jak i w akcjach. Na przykład możesz wysłać listę katalogów w akcji Wyślij wewnętrzny e-mail podobnej do poniższej:

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

Wyzwalacze

Tej akcji możesz użyć w dowolnym przepływie pracy, w tym w przepływach z wyzwalaczem Zaplanowany czas. Przepływ pracy wykorzystujący wyzwalacz Zaplanowany czas rozpoczyna się o określonej przez Ciebie godzinie, a nie w wyniku wystąpienia zdarzenia. Ponieważ w Twoim sklepie ani w aplikacji nie ma konkretnego zdarzenia, które uruchamia przepływ pracy, żadne dane nie są uwzględniane automatycznie.

Dokumentacja API

Więcej informacji o interfejsie API używanym w tej akcji można znaleźć w opisie zapytania o katalogi.