Wyzwalacz metapola wpisu na blogu

Wyzwalacz metapola wpisu na blogu

Skopiuj stronę

Uruchom przepływ pracy w Shopify Flow, gdy zmieni się metapole wpisu na blogu, np. status recenzji. Otrzymasz starą i nową wartość pola.

Wpisy przed opublikowaniem przechodzą kontrolę redakcyjną. Status ten jest zapisywany w polu metadanych wpisu na blogu Status recenzji (custom.review_status), a gdy osiągnie on wartość approved, należy o tym poinformować osobę odpowiedzialną za publikację.

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

Co jest potrzebne

  • Definicja metapola. Proszę utworzyć ją w panelu administracyjnym Shopify w sekcji Ustawienia > Metapola i metaobiekty > Wpisy na blogu. Metapola bez definicji nie może być monitorowana.
  • Uprawnienie Dostęp do danych bloga, wpisów na blogu i stron. 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 Wpis na blogu.
  3. Zaznacz pole metadanych Status recenzji. 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 „Wpis na blogu” oraz zaznaczonym metapolem „Status recenzji” (custom.review_status)
Typ zasobu: wpis na blogu, zaznaczone pole metadanych. Opcja „Wszystkie pola metadanych” śledzi zami tego wszystkie pola metadanych tego typu.

Wyzwalacz jest aktywny od razu. Gdy aplikacja po raz pierwszy odczytuje wpis na blogu, zapisuje bieżącą 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 ARTICLE
resourceId Identyfikator wpisu na blogu, na przykład gid://shopify/Article/1234567890
metafieldKey Przestrzeń nazw i klucz, w tym przypadku custom.review_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

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 ARTICLE. Proces aktualizacji metapól uruchamia się dla każdego śledzonego typu zasobu, więc warunek ten ogranicza ten przepływ pracy wyłącznie do wpisów na blogu. Jeśli śledzą Państwo kilka metapól tego typu, proszę dodać jako drugie kryterium warunek: metafieldKey jest równe custom.review_status.
  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 ARTICLE 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 oparty na metafield.value, aby reagować wyłącznie na wartość approved.
  • Proszę opublikować tę zmianę na czacie zespołowym za pomocą funkcji Wyślij żądanie HTTP.
  • W przypadku śledzenia kilku metapól wpisów na blogu proszę dodać warunek dotyczący metafieldKey.

Jak szybko reaguje

Shopify nie wysyła powiadomień dotyczących blogów, wpisów na blogu ani stron, dlatego aplikacja sprawdza je zgodnie z harmonogramem. Przebieg procesu powinien rozpocząć się w ciągu kilku minut. Nie muszą Państwo w tym celu włączać żadnego innego wyzwalacza.

Warto wiedzieć

  • W przypadku zdarzeń typ zasobu wpisu na blogu to ARTICLE - nazwa, której używa w tym kontekście firma Shopify.
  • Aby wprowadzić zmiany w samym wpisie (tytuł, treść, tagi), proszę skorzystać z wyzwalacza Aktualizacja wpisu na blogu.

Więcej