Wyzwalacz pola metadanych „Lokalizacja firmy”

Wyzwalacz pola metadanych „Lokalizacja firmy”

Skopiuj stronę

Uruchamiaj przepływ pracy w Shopify Flow, gdy zmienia się metapole lokalizacji firmy B2B. Otrzymasz starą i nową wartość pola.

Klient z sektora B2B posiada kilka oddziałów, a każdy z nich przyjmuje dostawy w innych godzinach. Godziny te są zapisane w metapolu lokalizacji firmy Okno dostawy (custom.delivery_window), a dział logistyki musi zostać poinformowany o wszelkich zmianach przed zaplanowaniem kolejnej wysyłki.

Na tej stronie przedstawiono, jak uruchomić przepływ pracy w Shopify Flow za każdym razem, gdy zmienia się metapole lokalizacji firmy, przy użyciu rozszerzeń Workflow Trigger Extensions. Kroki są takie same dla każdego metapola tego typu zasobu; w przykładzie wykorzystano pole Okno dostawy (custom.delivery_window).

Co jest potrzebne

  • Definicja metapola. Proszę utworzyć ją w panelu administracyjnym Shopify w sekcji Ustawienia > Metapola i metaobiekty > Lokalizacje firmy. Metapola bez definicji nie może być monitorowana.
  • Uprawnienie Dostęp do danych dotyczących firmy i lokalizacji firmy (B2B). Należy je przyznać na stronie Uprawnienia w aplikacji; więcej informacji można znaleźć w sekcji Uprawnienia i dostęp do danych.
  • Lokalizacje firm stanowią część funkcji B2B w platformie Shopify. Ten typ zasobu ma zastosowanie wyłącznie w sklepach, w których zarejestrowano firmy.

1. Śledzenie metapola

  1. W aplikacji otwórz sekcję Wyzwalacze metapól i kliknij opcję Dodaj wyzwalacz.
  2. Proszę wybrać typ zasobu Lokalizacja firmy.
  3. Zaznacz pole metadanych, w tym przypadku Okres dostawy. Można zaznaczyć kilka pozycji jednocześnie lub skorzystać z opcji Zaznacz wszystko.
  4. Proszę kliknąć przycisk Dodaj wyzwalacz.

Aby śledzić wszystkie metapola tego typu zasobu, w tym te, które utworzą Państwo w przyszłości, proszę wybrać opcję Wszystkie metapola zamiast zaznaczać poszczególne pola, a następnie kliknąć przycisk Śledź wszystkie metapola.

Okno dialogowe „Dodaj wyzwalacz metapola” z typem zasobu „Lokalizacja firmy” oraz zaznaczonym metapolem „Okno dostawy” (custom.delivery_window)
Typ zasobu: Lokalizacja firmy - zaznaczono pole metadanych. Opcja „Wszystkie pola metadanych” śledzi natomiast wszystkie pola metadanych tego typu.

Nowy wyzwalacz wyświetla komunikat Inicjalizacja w trakcie, gdy aplikacja odczytuje aktualną wartość metapola dla istniejących lokalizacji Państwa firmy, a następnie przechodzi w stan Aktywny. To właśnie dzięki temu pierwszemu odczytowi już pierwsza zmiana pojawia się wraz z prawidłową wartością poprzednią.

Jeśli meta-pole nie znajduje się na liście, proszę kliknąć przycisk Odśwież meta-pola na stronie „Wyzwalacze meta-pól”: aplikacja zapamiętuje listę definicji przez godzinę.

2. Co trafia do przepływu pracy

Każda zmiana uruchamia zdarzenie Metafield Update w usłudze Shopify Flow z następującymi wartościami:

Zmienna Wartość
resourceType COMPANYLOCATION
resourceId Identyfikator lokalizacji firmy, na przykład gid://shopify/CompanyLocation/1234567890
metafieldKey Przestrzeń nazw i klucz, w tym przypadku custom.delivery_window
metafield.value Nowa wartość
metafield.previousValue Wartość przed zmianą; pusta, gdy metapole zostało ustawione po raz pierwszy
metafield.type Typ metapola, na przykład single_line_text_field

3. Stworzyć schemat pracy

  1. W Shopify Flow proszę utworzyć przepływ pracy i wybrać wyzwalacz Metafield Update z rozszerzeń wyzwalaczy przepływu pracy (Workflow Trigger Extensions).
  2. Dodaj warunek: resourceType jest równe COMPANYLOCATION. Proces aktualizacji metapola uruchamia się dla każdego śledzonego typu zasobu, więc warunek ten ogranicza ten przepływ pracy do lokalizacji firmy. Jeśli śledzą Państwo kilka metapól tego typu, proszę dodać jako drugie kryterium warunek: metafieldKey jest równe custom.delivery_window.
  3. Proszę dodać żądaną akcję. W poniższym przykładzie wysyłana jest wewnętrzna wiadomość e-mail zawierająca starą i nową wartość.
Przykładowy przebieg procesu w Shopify Flow: aktualizacja metapola, warunek dotyczący typu zasobu COMPANYLOCATION oraz wysłanie wewnętrznej wiadomości e-mail
Przykładowy przebieg procesu: wyzwalacz, warunek dotyczący typu zasobu oraz jedna akcja.

Zacznij od przykładu

  1. Proszę pobrać plik .flow, który znajduje się w załączniku na dole tej strony.
  2. W panelu administracyjnym Shopify otwórz aplikację Shopify Flow, kliknij opcję Importuj i wybierz plik.
  3. Proszę otworzyć etap Wyślij wiadomość e-mail wewnętrzną i wprowadzić adresata. W pliku celowo nie podano żadnego adresu.
  4. Włącz proces.

Niech to będzie Państwa

  • Proszę przesłać nowe okno do swojego operatora lub narzędzia do planowania za pomocą funkcji Wyślij żądanie HTTP.
  • W przypadku śledzenia kilku metapól dotyczących lokalizacji firmy należy dodać warunek dotyczący metafieldKey.
  • Proszę zachować poprzednią wartość w wiadomości e-mail za pomocą metafield.previousValue, aby nikt nie musiał jej wyszukiwać.

Jak szybko reaguje

Shopify powiadamia aplikację w momencie zapisania lokalizacji firmy. W przypadku zmiany, która dotyczy wyłącznie metapola, czasami nie wysyła powiadomienia, dlatego aplikacja sprawdza lokalizacje Państwa firmy mniej więcej raz na minutę. Proszę spodziewać się realizacji zadania w ciągu kilku sekund, a najpóźniej po upływie jednej lub dwóch minut.

Więcej