Wyzwalacz metapola „Przeniesienie zapasów”

Wyzwalacz metapola „Przeniesienie zapasów”

Skopiuj stronę

Uruchamiaj przepływ pracy w Shopify Flow przy każdej zmianie metapola przeniesienia zapasów i otrzymuj starą oraz nową wartość, np. numeru przewoźnika.

Sprzedawca przenosi towary między magazynami i wpisuje numer referencyjny przewoźnika w polu metadanych Numer referencyjny przewoźnika (custom.carrier_reference). Zaraz po wprowadzeniu tej informacji magazyn odbiorczy powinien ją otrzymać.

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

Co jest potrzebne

  • Definicja metapola. Proszę utworzyć ją w panelu administracyjnym Shopify w sekcji Ustawienia > Metapola i metaobiekty > Przeniesienia. Metapola bez definicji nie może być śledzona.
  • Uprawnienie Dostęp do danych dotyczących transferów magazynowych. Należy je przyznać na stronie Uprawnienia aplikacji; więcej informacji można znaleźć w sekcji Uprawnienia i dostęp do danych.

1. Śledzenie metapola

  1. W aplikacji otwórz sekcję Wyzwalacze metapól i kliknij opcję Dodaj wyzwalacz.
  2. Proszę wybrać typ zasobu Transfer.
  3. Zaznacz pole metadanych, w tym przypadku Numer referencyjny przewoźnika. 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 „Transfer” oraz zaznaczonym metapolem „Odniesienie do przewoźnika” (custom.carrier_reference)
Typ zasobu: Transfer, pole metadanych zaznaczone. Opcja „Wszystkie pola metadanych” śledzi zami tego wszystkie pola metadanych tego typu.

Wyzwalacz jest od razu aktywny. Gdy aplikacja po raz pierwszy odczytuje dane dotyczące przeniesienia zapasów, zapisuje aktualną wartość bez uruchamiania przepływu pracy; każda kolejna zmiana powoduje jego uruchomienie.

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 TRANSFER
resourceId Identyfikator operacji przeniesienia zapasów, na przykład gid://shopify/InventoryTransfer/1234567890
metafieldKey Przestrzeń nazw i klucz, w tym przypadku custom.carrier_reference
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 TRANSFER. Proces aktualizacji metapola uruchamia się dla każdego śledzonego typu zasobu, więc warunek ten ogranicza ten przepływ pracy do transferów magazynowych. Jeśli śledzą Państwo kilka metapól tego typu, proszę dodać jako drugie kryterium warunek: metafieldKey jest równe custom.carrier_reference.
  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 TRANSFER 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ę dodać warunek „metafield.previousValue jest puste”, aby reakcja następowała wyłącznie wtedy, gdy pole to zostanie wypełnione po raz pierwszy.
  • Proszę przesłać numer referencyjny do systemu magazynu odbiorczego za pomocą funkcji Wyślij żądanie HTTP.
  • W przypadku śledzenia kilku metapól transferu proszę dodać warunek dotyczący metafieldKey.

Jak szybko reaguje

Shopify nie wysyła w tej sprawie żadnych powiadomień, dlatego aplikacja odczytuje śledzone metapola mniej więcej raz na minutę. Proszę spodziewać się uruchomienia procesu w ciągu jednej lub dwóch minut.

Warto wiedzieć

  • Monitorowane są transfery utworzone w ciągu ostatnich 90 dni. Zmiana metapola w starszym transferze nie uruchamia żadnego przepływu pracy.
  • Nowe przesunięcie jest wykrywane po raz pierwszy w ciągu około jednej minuty. Wartość, jaką metapole posiada już w tym momencie, stanowi jego wartość początkową i nie uruchamia żadnego przepływu pracy; każda późniejsza zmiana powoduje jego uruchomienie.

Więcej