Wyzwalacz metapola „Order”

Wyzwalacz metapola „Order”

Skopiuj stronę

Uruchom przepływ w Shopify Flow przy zmianie metapola zamówienia, np. wiadomości do prezentu. Otrzymaj starą i nową wartość w Workflow Trigger Extensions.

Klient zwraca się do działu obsługi klienta z prośbą o dodanie wiadomości do prezentu po złożeniu zamówienia. Dział obsługi klienta wpisuje ją w polu metadanych zamówienia Wiadomość do prezentu (custom.gift_message), a zespół pakujący musi ją sprawdzić przed wysłaniem przesyłki.

Na tej stronie przedstawiono, jak uruchomić przepływ pracy w Shopify Flow w momencie zmiany metapola zamówienia przy użyciu rozszerzeń Workflow Trigger Extensions. Kroki są takie same dla każdego metapola tego typu zasobu; w przykładzie wykorzystano pole Wiadomość dołączona do prezentu (custom.gift_message).

Co jest potrzebne

  • Definicja metapola. Proszę utworzyć ją w panelu administracyjnym Shopify w sekcji Ustawienia > Metapola i metaobiekty > Zamówienia. Metapola bez definicji nie może być monitorowana.
  • Uprawnienie Dostęp do danych. 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 Dodaj wyzwalacz.
  2. Proszę wybrać typ zasobu Zamówienie.
  3. Zaznacz pole meta, w tym przypadku Wiadomość dołączona do prezentu. 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 „Zamówienie” oraz zaznaczonym metapolem „Komunikat dotyczący prezentu” (custom.gift_message)
Typ zasobu: Zamówienie, zaznaczone pole metadanych. Opcja „Wszystkie pola metadanych” śledzi zamiast tego wszystkie pola metadanych tego typu.

Nowy wyzwalacz wyświetla komunikat Inicjalizacja w trakcie, gdy aplikacja odczytuje aktualną wartość metapola w Państwa istniejących zamówieniach, a następnie przechodzi w stan Aktywny. To właśnie dzięki temu pierwszemu odczytowi już pierwsza zmiana jest dostarczana 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 ORDER
resourceId Identyfikator zamówienia, na przykład gid://shopify/Order/1234567890
metafieldKey Przestrzeń nazw i klucz, w tym przypadku custom.gift_message
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 pola metadanych zamówienia stanowi drugi wyzwalacz dla tej samej zmiany. Uruchamia się on dodatkowo w stosunku do „Aktualizacji pola metadanych” i przenosi dane zamówienia jako natywny odnośnik w Shopify Flow, dzięki czemu własne działania Shopify związane z zamówieniem działają na tych danych 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

  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 ORDER. Proces aktualizacji metapól uruchamia się dla każdego śledzonego typu zasobu, więc warunek ten ogranicza ten przepływ pracy wyłącznie do zamówień. Jeśli śledzą Państwo kilka metapól tego typu, proszę dodać jako drugie kryterium warunek: metafieldKey jest równe custom.gift_message.
  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 ORDER 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

  • Oznacz zamówienie: proszę wykonać czynność Dodaj tagi zamówienia i wpisać {{resourceId}} w odpowiednim polu.
  • Proszę dodać warunek „metafield.value nie jest puste”, aby usunięta wiadomość nie wysyłała żadnych danych.
  • Proszę skorzystać z opcji Aktualizacja metapola zamówienia, gdy w ramach przepływu pracy konieczne jest odczytanie pozycji zamówienia lub adresu wysyłki.

Jak szybko reaguje

Shopify powiadamia aplikację o zapisaniu zamówienia, więc proces ten zazwyczaj rozpoczyna się w ciągu kilku sekund.

Warto wiedzieć

  • Domyślnie aplikacja monitoruje zamówienia utworzone w ciągu ostatnich 60 dni. W przypadku starszych zamówień konieczny jest pełny dostęp do historii zamówień na stronie „Uprawnienia” oraz ustawienie dłuższego okresu w opcjach historii zamówień w aplikacji.

Więcej