Pobierz dane artykułu
W przepływach pracy, które wymagają danych artykułu na blogu, możesz użyć akcji Pobierz dane artykułu, aby pobrać informacje o artykule ze sklepu Shopify.
Konfiguracja
Pola
Akcja Pobierz dane artykułu zawiera następujące pola:
| Pole | Opis |
|---|---|
| Sortuj dane według | Wymagane. Parametry określające sposób sortowania danych zwróconych przez zapytanie wyszukiwania. |
| Maksymalna liczba wyników | Wymagane. Maksymalna liczba wyników, które mogą zostać zwrócone przez wybrane zapytanie wyszukiwania. Jednorazowo można zwrócić maksymalnie 100 wyników. |
| Zapytanie | Wymagane. Wybierz spośród typowych zapytań lub wybierz opcję Zaawansowane, aby utworzyć własne. |
Ciąg znaków zapytania
Oto przykładowe zapytanie służące do pobierania artykułów opublikowanych w ciągu ostatniego dnia:
published_at:<='{{ scheduledAt }}' AND published_at:>'{{ scheduledAt | date_minus: "1 day" }}'Zmienna published_at jest filtrem dostępnym w zapytaniu Articles, którego można użyć wielokrotnie lub połączyć z innymi zmiennymi. Zmienna Liquid scheduledAt jest dostępna w przepływach pracy wykorzystujących wyzwalacz Zaplanowany czas. Tag Liquid date_minus to specjalny tag aplikacji Flow, który pozwala na odejmowanie czasu od daty.
Podczas wysyłania zapytań o dane warto wiedzieć, że:
Zapytania muszą być zgodne z określoną składnią
Wartości pól zapytań nie zawsze są udokumentowane. W niektórych przypadkach wartości można znaleźć, przeglądając dokumentację API. Alternatywnie wartości pól można często znaleźć w adresach URL w panelu administracyjnym podczas korzystania z filtrów. Na przykład, aby znaleźć niektóre wartości zapytania Order, przefiltruj stronę Zamówienia w panelu administracyjnym, a następnie sprawdź adres URL.
Zapytanie możesz uruchomić lub przetestować w swoim sklepie za pomocą aplikacji Shopify GraphiQL.
Zwróć uwagę na to, co się stanie, jeśli zapytanie się nie powiedzie. Często API zwraca 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 z danych tych możesz skorzystać na różne sposoby:
- Jeśli musisz przetworzyć każdą pozycję na liście indywidualnie, np. aby dodać tag do każdej z nich, użyj akcji Dla każdego.
- Jeśli potrzebujesz zagregować dane, np. policzyć, ile wyników zostało zwróconych, możesz użyć akcji Policz lub Zsumuj.
- Jeśli musisz wygenerować listę, np. aby 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 Pobierz dane artykułu, która stanowi listę artykułów. Zmiennej tej możesz używać zarówno w warunkach, jak i akcjach. Możesz na przykład wysłać listę artykułów w ramach akcji Wyślij wewnętrzny e-mail podobnie do poniższego przykładu:
{% for single_article in GetArticleData %}
* {{ single_article.title }}
{% endfor %}Wyzwalacze
Możesz użyć tej akcji w dowolnym przepływie pracy, również z wyzwalaczem Zaplanowany czas. W przepływie pracy używającym wyzwalacza Zaplanowany czas przepływ pracy rozpoczyna się w określonym przez Ciebie czasie, a nie w wyniku zdarzenia. Ponieważ w sklepie ani w aplikacji nie ma żadnego konkretnego zdarzenia, które uruchamiałoby przepływ pracy, żadne dane nie są uwzględniane automatycznie.
Materiały referencyjne API
Więcej informacji o API wykorzystywanym w tej akcji znajdziesz w dokumentacji zapytania Articles.