Wyzwalacz metapola firmy

Wyzwalacz metapola firmy

Skopiuj stronę

Uruchom przepływ pracy w Shopify Flow po zmianie metapola firmy B2B, np. limitu kredytowego, i uzyskaj starą i nową wartość w Workflow Trigger Extensions.

Hurtownik zapisuje uzgodniony limit kredytowy każdego klienta B2B w metapolu firmy Limit kredytowy (custom.credit_limit). Gdy dział finansowy podwyższy lub obniży ten limit, opiekun klienta powinien zostać o tym poinformowany przed złożeniem kolejnego zamówienia.

Na tej stronie przedstawiono, jak uruchomić przepływ pracy w Shopify Flow w momencie zmiany metapola firmy, korzystając z rozszerzeń wyzwalających przepływ pracy (Workflow Trigger Extensions). Kroki są takie same dla każdego metapola tego typu zasobu; w przykładzie wykorzystano limit kredytowy (custom.credit_limit).

Co jest potrzebne

  • Definicja metapola. Proszę utworzyć ją w panelu administracyjnym Shopify w sekcji Ustawienia > Metapola i metaobiekty > 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.
  • Firmy stanowią część segmentu B2B w platformie Shopify. Ten typ zasobu ma zastosowanie wyłącznie w sklepach, w których występują firmy.

1. Śledzenie metapola

  1. W aplikacji otwórz sekcję Wyzwalacze metapól i kliknij opcję Dodaj wyzwalacz.
  2. Proszę wybrać typ zasobu Firma.
  3. Zaznacz pole metadanych - w tym przypadku Limit kredytowy. 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 „Firma” oraz zaznaczonym metapolem „Limit kredytowy” (custom.credit_limit)
Typ zasobu: „Firma”, 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 firm, 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 COMPANY
resourceId Identyfikator firmy, na przykład gid://shopify/Company/1234567890
metafieldKey Przestrzeń nazw i klucz, w tym przypadku custom.credit_limit
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 COMPANY. Proces aktualizacji metapola uruchamia się dla każdego śledzonego typu zasobu, więc warunek ten ogranicza ten przepływ pracy wyłącznie do firm. Jeśli śledzą Państwo kilka metapól tego typu, proszę dodać jako drugie kryterium warunek: metafieldKey jest równe custom.credit_limit.
  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 „FIRMA” 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ę porównać metafield.previousValue z metafield.value, aby odróżnić podwyżkę od obniżki.
  • Proszę przesłać nowy limit do systemu ERP za pomocą funkcji Wyślij żądanie HTTP.
  • W przypadku śledzenia kilku metapól firmy należy dodać warunek dotyczący metafieldKey.

Jak szybko reaguje

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

Więcej