Wyzwalacz metapola sklepu

Wyzwalacz metapola sklepu

Skopiuj stronę

Uruchamiaj przepływ pracy w Shopify Flow przy każdej zmianie metapola sklepu. Śledź wybrane lub wszystkie metapola sklepu bez dodatkowych uprawnień.

Sklep przechowuje jedną informację dotyczącą całego sklepu, np. o dniach zamknięcia, w metapolu sklepu Informacja świąteczna (custom.holiday_notice), a motyw wyświetla tę informację. Gdy ktoś zmieni treść tej informacji, zespół powinien natychmiast zobaczyć nowy tekst.

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

Co jest potrzebne

  • Definicja metapola. Proszę utworzyć ją w panelu administracyjnym Shopify w sekcji Ustawienia > Metapola i metaobiekty > Sklep. Metapola bez definicji nie może być monitorowana.
  • Nie są wymagane żadne dodatkowe uprawnienia. Metapola sklepu mogą być śledzone od momentu zainstalowania aplikacji.

1. Śledzenie metapola

  1. W aplikacji otwórz sekcję Wyzwalacze metapól i kliknij Dodaj wyzwalacz.
  2. Proszę wybrać typ zasobu Sklep.
  3. Zaznacz pole metadanych Informacja o urlopie. 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 „Sklep” oraz zaznaczonym metapolem „Ogłoszenie świąteczne” (custom.holiday_notice)
Typ zasobu: Sklep, pole metadanych zaznaczone. Opcja „Wszystkie pola metadanych” śledzi zami tego wszystkie pola metadanych tego typu.

Wyzwalacz jest aktywny od razu. Gdy aplikacja po raz pierwszy odczytuje dane sklepu, 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 SHOP
resourceId Identyfikator sklepu, na przykład gid://shopify/Shop/1234567890
metafieldKey Przestrzeń nazw i klucz, w tym przypadku custom.holiday_notice
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 SHOP. Proces aktualizacji metapola uruchamia się dla każdego śledzonego typu zasobu, więc warunek ten ogranicza ten przepływ pracy wyłącznie do sklepu. Jeśli śledzą Państwo kilka metapól tego typu, proszę dodać jako drugie kryterium warunek, że metafieldKey jest równe custom.holiday_notice.
  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 SHOP 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

  • W wiadomości e-mail proszę użyć zmiennych metafield.previousValue oraz metafield.value, aby wyświetlić poprzednią i nową informację.
  • Proszę opublikować tę zmianę na czacie zespołowym za pomocą funkcji Wyślij żądanie HTTP.
  • W przypadku śledzenia kilku metapól sklepu należy 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ć

  • Dla każdego sklepu istnieje jeden rekord, więc resourceId jest zawsze ten sam.

Więcej