Pobierz dane umowy subskrypcyjnej

W workflow, które wykorzystują dane umów subskrypcyjnych, możesz użyć akcji Pobierz dane umowy subskrypcyjnej, aby pobrać informacje o umowach subskrypcyjnych ze sklepu.

Na tej stronie

Konfiguracja

Pola

Akcja Pobierz dane umowy subskrypcyjnej zawiera następujące pola, które służą do tworzenia zapytania:

Pola używane w akcjach Pobierz dane.
Pole	Opis
Sortuj dane według	Wymagane. Parametry, według których sortowane są dane zwrócone 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ć do 100 wyników.
Zapytanie	Wymagane. Wybierz spośród popularnych zapytań lub wybierz opcję Zaawansowane, aby utworzyć własne.

Ciąg zapytania

To jest przykładowe zapytanie dotyczące pobierania umów subskrypcyjnych o statusie ACTIVE:

status: ACTIVE

Zmienna status jest filtrem dostępnym w zapytaniu o umowy subskrypcyjne i może być używana wielokrotnie.

Podczas wysyłania zapytań o dane warto wiedzieć:

Lista dostępnych filtró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źć w dokumentacji API. Alternatywnie, wartości pól można często znaleźć w adresach URL w panelu administracyjnym po zastosowaniu filtrów. Na przykład, 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 sklepie za pomocą aplikacji Shopify GraphiQL.
Pamiętaj o tym, co się stanie, jeśli zapytanie zakończy się niepowodzeniem. Często API zwróci wszystkie wyniki (zamiast żadnego).

Zwrócone dane

Wszystkie akcje typu 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 obsłużyć każdą pozycję z listy osobno, np. dodać do każdej tag, możesz użyć akcji Dla każdego.
Jeśli chcesz agregować dane, na przykład zliczyć, ile wyników zostało zwróconych, możesz użyć akcji Zlicz lub Sumuj.
Jeśli chcesz wykorzystać listę, na przykład wysłać e-mail zawierający wszystkie pozycje, 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 kontaktowe subskrypcji, która jest listą umów subskrypcyjnych. Możesz używać tej zmiennej zarówno w warunkach, jak i w akcjach. Na przykład możesz wysłać listę zamówień w akcji Wyślij wewnętrzną wiadomość e-mail w następujący sposób:

{% for single_contract in GetSubscriptionContractData %}
* {{ single_contract.name }}
{% endfor %}

Wyzwalacze

Możesz użyć tej akcji w dowolnym workflow, w tym w wyzwalaczu Zaplanowany czas. W przypadku użycia wyzwalacza Zaplanowany czas workflow uruchamia się o określonej przez Ciebie porze, a nie w wyniku zdarzenia. Ponieważ nie ma określonego zdarzenia w sklepie lub w aplikacji, które uruchamia workflow, żadne dane nie są dołączane automatycznie.