Pobierz dane lokalizacji firmy
W sekwencjach zadań, które wykorzystują dane lokalizacji firmy, możesz użyć akcji Pobierz dane lokalizacji firmy, aby pobrać informacje o lokalizacji firmy ze sklepu.
Konfiguracja
Pola
Akcja Pobierz dane lokalizacji 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ą zostać zwrócone przez wybrane zapytanie wyszukiwania. Jednorazowo można zwrócić do 100 wyników. |
| Zapytanie | Wymagane. Wybierz jedno z popularnych zapytań lub opcję Zaawansowane, aby utworzyć własne. |
Ciąg zapytania
Oto przykładowe zapytanie dotyczące pobierania lokalizacji firm, które zostały zaktualizowane w ciągu ostatniego dnia:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Zmienna updated_at to filtr dostępny w zapytaniu o lokalizacje firm, który może być używany wielokrotnie lub łączony z innymi zmiennymi. Zmienna Liquid scheduledAt jest dostępna w sekwencjach zadań, w których użyto wyzwalacza Zaplanowany czas. Tag Liquid date_minus to specjalny tag Flow, który umożliwia odjęcie czasu od daty.
Podczas tworzenia zapytań o dane warto wiedzieć o następujących kwestiach:
- Lista dostępnych filtrów lokalizacji firmy
- 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źć w dokumentacji API. Alternatywnie wartości pól można często znaleźć w adresach URL w panelu administracyjnym podczas filtrowania. 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żna uruchomić lub przetestować zapytanie w sklepie za pomocą aplikacji Shopify GraphiQL.
- Należy pamiętać, co się stanie, jeśli zapytanie zakończy się niepowodzeniem. Często API zwróci wszystkie wyniki (zamiast żadnego).
Zwracane dane
Wszystkie akcje typu Pobierz dane zwracają listę od 0 do 100 zasobów. W zależności od przypadku użycia dane te można wykorzystać na różne sposoby:
- Jeśli chcesz obsługiwać każdą pozycję listy indywidualnie, na przykład w celu dodania tagu do każdej z nich, 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 Licz lub Sumuj.
- Jeśli chcesz wyprowadzić listę, np. 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 lokalizacji firmy, która jest listą lokalizacji firm. Możesz użyć tej zmiennej zarówno w warunkach, jak i w akcjach. Na przykład możesz wysłać listę lokalizacji w akcji Wyślij wewnętrzną wiadomość e-mail w następujący sposób:
{% for single_company in GetCompanyLocationData %}
* {{ single_company.name }}
{% endfor %}Wyzwalacze
Możesz użyć tej akcji w dowolnej sekwencji zadań, w tym z wyzwalaczem Zaplanowany czas. W sekwencji zadań, która korzysta z wyzwalacza Zaplanowany czas, sekwencja zadań rozpoczyna się o określonej przez Ciebie godzinie, a nie w wyniku zdarzenia. Ponieważ nie ma określonego zdarzenia w sklepie lub z aplikacji, które uruchamia sekwencję zadań, żadne dane nie są automatycznie uwzględniane.