Pobierz dane strony

W przepływach pracy, które wymagają danych strony, możesz użyć akcji Get page data, aby pobrać informacje o stronie ze swojego sklepu. Strony to strony internetowe w sklepie online, które zawierają rzadko zmieniające się informacje, takie jak strona O nas lub Kontakt.

Uwaga

Jest to rodzaj akcji Get data. Aby dowiedzieć się, jak używać tego typu akcji z wyzwalaczem Scheduled time i pętlami For each, zapoznaj się z artykułem Harmonogramy, pobieranie danych i przepływy pracy w pętli w aplikacji Shopify Flow.

Konfiguracja

Pola

Akcja Get page data zawiera następujące pola:

Pola używane w akcjach Get data.

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. Jednorazowo możesz zwrócić maksymalnie 100 wyników.
Zapytanie	Wymagane. Wybierz spośród popularnych zapytań lub wybierz opcję Advanced, aby utworzyć własne.

Ciąg zapytania

Oto przykładowe zapytanie służące do pobierania opublikowanych stron:

published_status:published

Zmienna published_status to filtr dostępny w zapytaniu Pages query, którego można używać wielokrotnie lub w połączeniu z innymi zmiennymi.

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

• Lista dostępnych filtrów stron

• 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 także odnaleźć w adresach URL w panelu administracyjnym podczas filtrowania. Przykładowo, aby znaleźć niektóre wartości zapytania dotyczącego zamówień, przefiltruj stronę Zamówienia w panelu administracyjnym, a następnie sprawdź adres URL.

• Możesz uruchomić lub przetestować zapytanie w swoim sklepie, korzystając z aplikacji Shopify GraphiQL app.

• Pamiętaj o tym, co się stanie w przypadku niepowodzenia zapytania. Często API zwraca wszystkie wyniki (zamiast żadnego).

Zwrócone dane

Wszystkie akcje typu Get data zwracają listę zawierającą od 0 do 100 zasobów. W zależności od przypadku użycia danych tych można użyć na różne sposoby:

• Jeśli musisz przetworzyć każdą pozycję z listy z osobna, na przykład, aby dodać do niej tag, możesz użyć akcji For each.
• Jeśli musisz zagregować dane, na przykład policzyć zwrócone wyniki, możesz użyć akcji Count lub Sum.
• Jeśli chcesz wygenerować listę jako wynik, na przykład 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 Get page data, która jest listą stron. Możesz używać tej zmiennej zarówno w warunkach, jak i w akcjach. Możesz na przykład wysłać listę stron w akcji Send internal email, jak poniżej:

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

Uwaga

Jeśli akcja Get data jest używana wielokrotnie w jednym przepływie pracy, do nazwy zmiennej dodawany jest numer. Na przykład w przepływie pracy, który używa akcji Get order data dwa razy, pierwszą zmienną dla zwróconych danych jest getOrderData, a drugą getOrderData1. Tej nazwy nie można dostosować.

Wyzwalacze

Możesz użyć tej akcji w dowolnym przepływie pracy, włączając w to wyzwalacz Scheduled time. W przepływie pracy korzystającym z wyzwalacza Scheduled time przepływ pracy rozpoczyna się w określonym przez Ciebie czasie, a nie w wyniku zdarzenia. Ponieważ w sklepie lub z poziomu aplikacji nie ma konkretnego zdarzenia, które uruchamiałoby przepływ pracy, żadne dane nie są dołączane automatycznie.

Dokumentacja API

Aby uzyskać więcej informacji na temat API używanego w tej akcji, zobacz zapytanie Pages query.