Wyzwalacz pola meta produktu
Uruchamiaj przepływ pracy w Shopify Flow, gdy zmienia się metapole produktu, np. status produkcji. Otrzymaj starą i nową wartość pola w wyzwalaczu.
Producent rejestruje etap produkcji w polu metadanych produktu Status produkcji (custom.production_status). Za każdym razem, gdy etap ulega zmianie, na przykład z in_production na quality_check, zespół odpowiedzialny za kolejny etap powinien zostać o tym poinformowany.
Na tej stronie przedstawiono, jak uruchomić przepływ pracy w Shopify Flow w momencie zmiany metapola produktu przy użyciu rozszerzeń Workflow Trigger Extensions. Kroki są takie same dla każdego metapola tego typu zasobu; w przykładzie wykorzystano status produkcji (custom.production_status).
Co jest potrzebne
- Definicja metapola. Proszę utworzyć ją w panelu administracyjnym Shopify w sekcji Ustawienia > Metapola i metaobiekty > Produkty. Metapola bez definicji nie może być monitorowana.
- Uprawnienie Dostęp do danych dotyczących produktów, wariantów i kolekcji. 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
- W aplikacji otwórz sekcję Wyzwalacze metapól i kliknij opcję Dodaj wyzwalacz.
- Proszę wybrać typ zasobu Produkt.
- Zaznacz pole metadanych, w tym przypadku Status produkcji. Można zaznaczyć kilka pozycji jednocześnie lub skorzystać z opcji Zaznacz wszystko.
- 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.

Nowy wyzwalacz wyświetla komunikat Inicjalizacja w trakcie, gdy aplikacja odczytuje aktualną wartość metapola w istniejących produktach, 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 |
PRODUCT |
resourceId |
Identyfikator produktu, na przykład gid://shopify/Product/1234567890 |
metafieldKey |
Przestrzeń nazw i klucz, w tym przypadku custom.production_status |
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 |
Aktualizacja metapola produktu stanowi drugi wyzwalacz tej samej zmiany. Uruchamia się on dodatkowo w stosunku do „Aktualizacji metapola” i traktuje produkt jako natywny odnośnik w Shopify Flow, dzięki czemu własne działania Shopify dotyczące produktu działają na nim bez konieczności wykonywania kroku wyszukiwania. Oba wyzwalacze odnoszą się do tego samego zdarzenia, więc użycie obu nie powoduje podwójnego zliczenia. Proszę włączyć tę funkcję na stronie Wyzwalacze w aplikacji lub uruchomić przepływ pracy, który z niej korzysta.
3. Stworzyć schemat pracy
- W Shopify Flow proszę utworzyć przepływ pracy i wybrać wyzwalacz Metafield Update z rozszerzeń wyzwalaczy przepływu pracy (Workflow Trigger Extensions).
- Dodaj warunek:
resourceTypejest równePRODUCT. Proces aktualizacji metapól uruchamia się dla każdego śledzonego typu zasobu, więc warunek ten ogranicza ten przepływ pracy wyłącznie do produktów. Jeśli śledzą Państwo kilka metapól tego typu, proszę dodać jako drugie kryterium warunek:metafieldKeyjest równecustom.production_status. - Proszę dodać żądaną akcję. W poniższym przykładzie wysyłana jest wewnętrzna wiadomość e-mail zawierająca starą i nową wartość.

Zacznij od przykładu
- Proszę pobrać plik
.flow, który znajduje się w załączniku na dole tej strony. - W panelu administracyjnym Shopify otwórz aplikację Shopify Flow, kliknij opcję Importuj i wybierz plik.
- Proszę otworzyć etap Wyślij wiadomość e-mail wewnętrzną i wprowadzić adresata. W pliku celowo nie podano żadnego adresu.
- Włącz proces.
Niech to będzie Państwa
- Proszę dodać drugi warunek dotyczący
metafield.value, aby każdy etap był kierowany do innego zespołu. - Zamiast tego proszę oznaczyć produkt: proszę wybrać opcję Dodaj tagi produktu i wpisać
{{resourceId}}w polu „produkt”. - Proszę porównać
metafield.previousValuezmetafield.value, aby reakcja następowała wyłącznie w przypadku wzrostu lub spadku wartości.
Jak szybko reaguje
Shopify powiadamia aplikację o zapisaniu produktu, więc proces ten zazwyczaj rozpoczyna się w ciągu kilku sekund.
Więcej
- Wyzwalacze metapól: jak działają wyzwalacze metapól dla każdego typu zasobu.
- Uruchamianie Shopify Flow w przypadku zmian w metapolu produktu - przykład z filmem instruktażowym.
- Historia zdarzeń i rozwiązywanie problemów: przeglądaj wszystkie zdarzenia wysłane przez aplikację wraz ze starymi i nowymi wartościami.
