Pobierz dane kolekcji
W workflow, które wymagają danych o kolekcjach, możesz użyć akcji Pobierz dane kolekcji, aby pobrać informacje o kolekcjach ze sklepu.
Konfiguracja
Pola
Akcja Pobierz dane kolekcji zawiera następujące pola.
| 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 kolekcji, 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 kolekcje i może być używana wielokrotnie lub w połączeniu z innymi zmiennymi. Zmienna Liquid scheduledAt jest dostępna w workflow, które korzystają z wyzwalacza „Zaplanowany czas”. Tag Liquid date_minus to specjalny tag Flow, który umożliwia odejmowanie czasu od daty.
Przy wysyłaniu zapytań o dane warto wiedzieć o następujących kwestiach:
- Lista dostępnych filtrów kolekcji
- Zapytania muszą być zgodne z określoną składnią
- Wartości pól zapytań nie zawsze są udokumentowane. W niektórych przypadkach wartości te można znaleźć, przeglądając dokumentację 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 zapytań o zamówienia, 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.
- Miej na uwadze, 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ę od 0 do 100 zasobów. W zależności od przypadku użycia możesz chcieć wykorzystać te dane na różne sposoby:
- Jeśli musisz obsługiwać każdą pozycję na liście osobno, na przykład, aby dodać tag do każdej z nich, możesz użyć akcji Dla każdego.
- Jeśli musisz agregować dane, na przykład policzyć, ile wyników zostało zwróconych, możesz użyć akcji Policz lub Suma.
- Jeśli chcesz wyświetlić listę, na przykład wysłać wiadomość 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 kolekcji, która jest listą kolekcji. Możesz używać tej zmiennej zarówno w warunkach, jak i w akcjach. Na przykład możesz wysłać listę kolekcji w akcji Wyślij wewnętrzną wiadomość e-mail w następujący sposób:
{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% endfor %}Wyzwalacze
Możesz użyć tej akcji w dowolnym workflow, w tym w wyzwalaczu Zaplanowany czas. W workflow, który używa wyzwalacza Zaplanowany czas, workflow uruchamia się o określonej przez Ciebie godzinie, a nie w wyniku zdarzenia. Ponieważ nie ma konkretnego zdarzenia w Twoim sklepie lub z aplikacji, które uruchamia workflow, żadne dane nie są dołączane automatycznie.