Pobierz dane firmy
W workflow, które wykorzystują dane firmy, możesz użyć akcji Pobierz dane firmy, aby pobrać informacje o firmie ze swojego sklepu.
Konfiguracja
Pola
Akcja Pobierz dane firmy zawiera następujące pola, które służą do tworzenia zapytania:
| 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ą być 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 firm, 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 firmy 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 firm
- 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 chcesz agregować dane, na przykład policzyć, ile wyników zostało zwróconych, możesz użyć akcji Count lub Sum.
- Jeśli chcesz wykorzystać listę, na przykład wysyłając e-maila 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 Get company data, która jest listą firm. Możesz używać tej zmiennej zarówno w warunkach, jak i w akcjach. Na przykład możesz wysłać listę firm za pomocą akcji Send internal email w następujący sposób:
{% for single_company in GetCompanyData %}
* {{ single_company.name }}
{% endfor %}Wyzwalacze
Możesz używać tej akcji w każdym workflow, w tym z wyzwalaczem Scheduled time. W workflow, który używa wyzwalacza Scheduled time, workflow uruchamia się o określonej przez Ciebie porze, a nie w wyniku zdarzenia. Ponieważ żadne konkretne zdarzenie w sklepie lub z aplikacji nie uruchamia workflow, żadne dane nie są dołączane automatycznie.