元字段觸發器

當特定元字段的定義發生變更時,元字段觸發器便會觸發,且適用於 10 種擁有者類型中的任何一種。您可以選擇要監控的元字段,每次僅監控一個定義,因此,即使某間商店擁有數百個元字段,觸發器也只會在工作流程所關心的那些元字段發生變更時觸發。

支援的擁有者類型

產品、產品變體、系列、客戶、訂單、公司、公司地點、部落格、部落格文章及頁面。

設定一個

本頁面的範例監控一個名為「評分」(custom.rating)的產品元資料欄位,這正是評論應用程式所寫入的值類型。

1. 選擇元資料欄位

  1. 在應用程式導覽中開啟「元欄位觸發器」。
  2. 按一下「新增觸發器」。
  3. 選擇該元資料欄位所屬的資源類型,例如「產品」。
  4. 從清單中選擇元欄位定義(若項目眾多,請依名稱搜尋),然後點擊「新增觸發器」。

僅會列出已定義的元欄位(Shopify 管理員、設定、自訂資料)。此清單會保留一小時,因此您剛才建立的定義可能未顯示:請點擊「新增觸發器」旁邊的「重新整理元欄位」,並再次開啟對話方塊。

「新增元資料欄位觸發器」對話方塊,其中資源類型為「產品」,並選取了元資料欄位「評分」(custom.rating)
先選擇資源類型,再選擇元資料欄位定義。若數量眾多,可利用搜尋功能。

2. 該元欄位現已加入監控清單

該元欄位在清單中顯示為「已啟用」。無需執行其他操作來啟用它:在此處新增該欄位_即表示_已啟用。刪除該欄位則會停止監控它。

該應用程式會先記錄您現有記錄中該元欄位的當前值,因此首次編輯時便會以正確的舊值觸發操作。

包含產品元字段「Rating」及「custom.rating」的「元字段觸發器」清單,狀態顯示為「已啟用」
受監控的元資料欄位「Active」。「重新整理元資料欄位」會重新載入定義清單。

3. 一場活動所蘊含的意義

從此之後,對該元欄位的每次編輯都會觸發 Shopify Flow 中的 Metafield Update 事件。該事件攜帶命名空間與鍵值、所屬的記錄、新值,以及 previousValue - - 即該元欄位先前所儲存的值。當元欄位剛被首次設定時,previousValue 為空。

在此範例中,評分從 4.5 降至 2.5。當評分降至 3 以下時,工作流程條件「值小於 3 且先前值為 3 或以上」會觸發一次,而非在後續每次編輯時觸發。詳細步驟請參閱:元欄位觸發器,逐步解說

「事件歷史記錄」中的事件:某產品的「元資料欄位」更新,值為 2.5,先前值為 4.5
一個活動已開啟:目前評分是 2.5,而 previousValue 顯示先前評分為 4.5。

通用觸發器與具型別的觸發器

有兩種方式可以處理元欄位變更:

觸發器 封面 提供
元欄位更新 全部 10 種業主類型 命名空間、金鑰、擁有者 ID、舊值與新值
「元字段更新」指令 僅限訂單 與上述相同,此外還包含作為原生 Flow 參考的命令
產品元資料欄位更新 僅限產品 與上述相同,此外將該產品作為原生參照
客戶元資料更新 僅限客戶 與上述相同,此外將客戶作為內建參考
產品變體元資料欄位更新 僅限產品變體 與上述相同,此外還將父產品作為原生參考

當您的工作流程需要對資源本身進行操作時(例如為訂單添加標籤或讀取其明細項目),請使用「指定類型」觸發器。由於採用原生參照,Flow 可以直接對該資源使用其專屬的「Shopify」動作,無需進行查詢步驟。

當您僅需得知某個值已變更,或是正在監控某個沒有類型變體的「擁有者類型」時,請使用通用觸發器。

每種指定類型的觸發器在「觸發器」頁面上都有各自的開關(啟用一個使用該觸發器的 Flow 工作流程即等同於啟用該觸發器),且會與通用觸發器_同時_觸發。由於它們共用同一個事件,因此同時啟用兩者並不會使您的配額被重複計算。