Pobierz dane lokalizacji

W procesach workflow wymagających danych lokalizacji możesz użyć czynności Pobierz dane lokalizacji w celu pobrania ze sklepu Shopify informacji o lokalizacji. Lokalizacja to dowolne miejsce, w którym przechowujesz zapasy, sprzedajesz produkty, wysyłasz lub realizujesz zamówienia.

Na tej stronie

Konfiguracja

Pola

Czynność Pobierz dane lokalizacji zawiera następujące pola.

Pola używane w czynnościach 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. Jednorazowo możesz zwrócić maksymalnie 100.
Zapytanie	Wymagane. Wybierz jedno z typowych zapytań lub opcję Zaawansowane, aby utworzyć własne.

Ciąg znaków zapytania

Przykładowe zapytanie o lokalizację z włączoną opcją odbioru w sklepie:

pickup_in_store:enabled

Zmienna pickup_in_store jest filtrem dostępnym w zapytaniu o lokalizacje. Można jej używać wielokrotnie lub w połączeniu z innymi zmiennymi.

Podczas zapytywania o dane warto znać:

Lista dostępnych filtrów lokalizacji
Zapytania muszą być zgodne z określoną składnią
Wartości pól zapytania nie zawsze są dokumentowane. W niektórych przypadkach wartości można znaleźć w dokumentach API. Wartości pól można też często znaleźć w adresach URL w panelu administracyjnym podczas filtrowania. Na przykład, aby znaleźć wartości zapytań o zamówienie, przefiltruj 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.
Zwróć uwagę na to, co dzieje się, gdy zapytanie kończy się błędem. Często API zwraca wszystkie wyniki (zamiast żadnego).

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 Pobierz dane lokalizacji, która jest listą lokalizacji. Możesz użyć tej zmiennej zarówno dla warunków, jak i dla czynności. Możesz na przykład wysłać listę lokalizacji w ramach czynności Wyślij wewnętrzną wiadomość e-mail, np.:

{% for single_location in GetLocationData %}
- {{ single_location.id }}
{% 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.

Referencja API

Więcej informacji na temat API używanego w tej akcji można znaleźć w zapytaniu Locations.