Pobierz dane wersji roboczej zamówienia

W procesach workflow wykorzystujących dane o wersji roboczej zamówienia możesz użyć czynności Pobierz dane wersji roboczej zamówienia w celu pobrania ze sklepu informacji o wersji roboczej zamówienia.

Konfiguracja

Pola

Czynność Pobierz dane wersji roboczej zamówienia zawiera poniższe 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

To jest przykładowe zapytanie umożliwiające pobranie wersji roboczych zamówień, 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 wersje robocze zamówień. 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ć:

  • Lista dostępnych filtrów zamówień - Zapytania muszą być zgodne z określoną składnią
  • Nazwy pól wszystkich zapytań można znaleźć w dokumentacji programisty dla obiektu QueryRoot.
  • 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 wersji roboczej zamówienia, która jest listą wersji roboczych zamówień. Możesz użyć tej zmiennej zarówno w warunkach, jak i w czynnościach. Przykładowo, możesz wysłać listę wersji roboczych zamówień w ramach czynności Wyślij wewnętrzną wiadomość e-mail, np.:

{% for single_order in GetDraftOrderData %}
- {{ single_order.name }}
{% 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.

Przykład:

Przykładowy workflow, który powtarza się raz w tygodniu, sprawdza wersje robocze zamówień utworzone w ciągu ostatniego tygodnia i wysyła wiadomość e-mail w celu weryfikacji wersji roboczej zamówienia, jeśli całkowita cena wersji roboczej zamówienia wynosi co najmniej 500 USD.

Uruchomienie tego przykładowego workflow jest zaplanowane na każdą niedzielę na godz. 9:00. Czynność Pobierz dane wersji roboczej zamówienia jest używana do gromadzenia danych wersji roboczych zamówień utworzonych w ostatnim tygodniu. Jeśli łączna kwota wersji roboczej zamówienia wynosi co najmniej 500 USD, wysyłana jest wewnętrzna wiadomość e-mail w celu weryfikacji wersji roboczej zamówienia.

Referencja API

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