舊價值與新價值:工作流程能如何運用它們
Shopify Flow
Shopify Flow 自身更新的觸發器會將資料記錄以當前狀態傳遞給工作流程。Shopify 的說明頁面針對每個觸發器都明確指出:僅提供當前值,變更前的值則無法取得。對於「某項內容已變更」的警示而言,這樣就足夠了。
許多工作流程需要的不僅如此。「價格下跌超過 10%」需要舊價格;「處理代號變更,請將舊網址重定向」需要舊處理代號;「客戶取消訂閱」則需要知道該客戶先前曾訂閱過。 此應用程式的每個變更觸發器都會攜帶這兩項值,因此這些工作流程僅需設定條件與動作,無需編寫程式碼,也無需手動儲存任何資料。
前面的數值從何而來
該應用程式會針對每筆記錄,記住其監控欄位的最後已知值。當 Shopify 回報更新時,系統會進行比對;若監控欄位的值有所不同,便會觸發觸發器並傳遞兩個值。實際操作中有兩點細節值得注意:
- 當應用程式首次偵測到一筆記錄時,它只會將其記下。此時不會觸發任何動作,因為沒有可比對的對象。當您啟用觸發器後,應用程式會在背景中讀取您現有的記錄一次,因此第一次真正的變更就會觸發相應動作。針對訂單,預設會讀取最近 60 天的資料,您可以在應用程式中擴展這個範圍。
- 這些值屬於變更發生當下的狀態。當工作流程在Shopify Flow的更新觸發器上執行時,會讀取該筆記錄。如果該筆記錄在下一秒再次變更,或是被刪除,該工作流程將看到較新的狀態,或無法載入該筆記錄。此應用程式的事件會保留其建立時的原始值。 您稍後可在應用程式的「事件歷史紀錄」中查看這些值。

唯有運用先前的數值,才能建構出什麼
| 工作流程 | 觸發器 | 需要舊值的條件 | 即用型 |
|---|---|---|---|
| 當產品或系列更名時,將舊網址重新導向 | 產品代號已變更,系列代號已變更 | 無:重定向從 oldHandle 指向 newHandle |
當產品代號變更時,將舊的產品網址進行重定向, 當收藏集識別碼變更時,將舊的收藏集網址重新導向 |
| 為價格下跌 10% 或以上的商品加上標籤 | 產品變體價格已變更 | priceChange.percentChange 小於或等於 -10 |
當某款商品的變體價格下降 10% 或以上時,為該商品加上標籤 |
| 將商品標示為特價,然後再取消該標示 | 產品變體價格已變更 | priceChange.oldCompareAtPrice.amount為空,而 priceChange.newCompareAtPrice.amount 並非為空,或情況恰好相反 |
當新增「參考價格」時,請將商品標記為「特價」, 當「參考價格」被移除時,請一併移除促銷標籤 |
| 當有待處理的付款到帳時,釋出訂單 | 訂單財務狀態已變更 | oldFinancialStatus 為 pending,且 newFinancialStatus 為 paid |
在收到待處理付款時標記訂單 |
| 結帳後若地址有變更,請通知倉庫 | 訂單寄送地址已變更 | 無:訊息中顯示 oldShippingAddress 和 shippingAddress |
當結帳後寄送地址變更時,請為訂單加上標籤 |
| 為取消訂閱的客戶加上標籤,當他們回歸時則移除標籤 | 客戶電子郵件行銷同意條款已變更 | consentState 等於 unsubscribed;oldConsentState 則顯示其先前狀態為何 |
當客戶取消訂閱電子郵件行銷時,請為其加上標籤 |
| 請為您的 ERP 或資料饋送保留原有的 SKU | 產品變體的 SKU 已變更 | 無:skuChange.oldSku 已寫入元資料欄位 |
當變體 SKU 變更時,請保留先前的 SKU |
| 當成本上升時,應檢視利潤率 | 產品變體成本已變更 | variantCostChange.percentChange 大於 5 |
當變體成本上升時,請將相關產品標記以便進行利潤檢討 |
| 當庫存量低於臨界值時,將該商品標記為「庫存不足」一次 | 該地點的庫存量已變更 | inventoryLevel.oldAvailable 大於或等於 5,且 inventoryLevel.newAvailable 小於 5 |
當庫存數量低於五件時,將產品標記為「庫存不足」 |
另外還有三種是由商人自行建造的:
- 當客戶的電子郵件地址變更時,請通知舊的電子郵件地址。Customer Email Changed 事件包含
oldEmail和email兩個參數。請透過將變數設為收件者的電子郵件動作(例如 Workflow Transactional Email),將通知發送至oldEmail。若未提供舊的電子郵件地址,便無人可收到通知。 - 針對自訂狀態中的某個階段做出反應。當元資料欄位
loyalty.tier從silver變更為gold時:Customer Metafield Update 會攜帶metafield.previousValue和metafield.value,因此工作流程可在客戶升級時送上祝賀,而在降級時則保持靜默。 - 針對已移除的標籤採取行動。標籤移除後,該記錄的外觀將如同從未擁有過該標籤一般。已移除的標籤包括「訂單」、「客戶」、「產品」及「草稿訂單」標籤。請參閱 當某個特定標籤被新增或移除時,執行工作流程。
根據觸發條件,前後的每個數值
訂單
| 觸發器 | 前後對比 |
|---|---|
| 新增訂單標籤、移除訂單標籤 | addedTags, removedTags, previousTags, currentTags |
| 訂單備註已變更 | oldNote, newNote |
| 訂單財務狀態已變更 | oldFinancialStatus, newFinancialStatus |
| 訂單處理方式已變更 | oldFulfillmentStatus、newFulfillmentStatus,以及 changes.items 中每筆訂單或每批貨件的狀態:已出貨、未出貨、追蹤資訊已更新(包含編號、網址及公司名稱) |
| 訂單顯示狀態已變更 | oldDisplayFulfillmentStatus, newDisplayFulfillmentStatus |
| 訂單屬性已變更 | changes.items,包含 changeType、key、oldValue、newValue |
| 訂單明細項目已變更 | changes.items,其中包含 changeType(新增、移除、數量、價格或變體變更)以及舊數量、舊價格、舊變體與新數量、新價格、新變體 |
| 訂單寄送地址已變更 | shippingAddress 和 oldShippingAddress,兩者也分別作為獨立的欄位 |
| 「元字段更新」指令 | metafield.value, metafield.previousValue |
| 訂單更新 | changes.fields 和 changes.items 包含財務狀態、履約狀態、標籤、備註、明細項目及自訂屬性的 field、oldValue、newValue |
客戶
| 觸發器 | 前後對比 |
|---|---|
| 新增客戶標籤、移除客戶標籤 | addedTags, removedTags, previousTags, currentTags |
| 客戶備註已變更 | oldNote, newNote |
| 客戶狀態已變更 | oldState, newState |
| 客戶名稱已變更 | firstName, lastName, oldFirstName, oldLastName |
| 客戶電子郵件地址已變更 | email, oldEmail |
| 客戶電話號碼已變更 | phone, oldPhone |
| 客戶地址變更 | address 和 oldAddress,兩者也各自作為獨立的欄位 |
| 客戶電子郵件行銷同意事項已變更,客戶簡訊行銷同意事項已變更 | consentState, optInLevel, oldConsentState, oldOptInLevel |
| 客戶元資料欄位更新 | metafield.value, metafield.previousValue |
| 客戶公告 | changes.fields 和 changes.items 適用於標籤、備註和狀態 |
產品與變體
| 觸發器 | 前後對比 |
|---|---|
| 已新增產品標籤、已移除產品標籤 | addedTags, removedTags, previousTags, currentTags |
| 產品名稱、代號、描述、狀態、供應商及類型已變更 | 舊值與新值,例如 oldTitle 和 newTitle |
| 產品已發佈至頻道、產品已從頻道撤下 | channels.added, channels.removed, channels.current |
| 產品變體價格已變更 | priceChange.oldPrice, newPrice, oldCompareAtPrice, newCompareAtPrice, delta, percentChange, direction |
| 產品變體的單價已變更 | unitPriceChange.oldUnitPrice, newUnitPrice, delta, percentChange, direction |
| 產品變體成本已變更 | variantCostChange.oldCost, newCost, delta, percentChange, direction |
| 產品變體的 SKU 已變更 | skuChange.oldSku, newSku |
| 產品變體的條碼已變更 | barcodeChange.oldBarcode、newBarcode、舊條碼清單與新條碼清單、added、removed |
| 產品元資料欄位更新、產品變體元資料欄位更新 | metafield.value, metafield.previousValue |
| 產品更新 | changes.fields 和 changes.items 適用於標題、代號、描述、狀態、供應商、產品類型和標籤;而針對各變體,則適用於價格、參考價、SKU、條碼、庫存政策、是否課稅、標題、選項和圖片 |
庫存、系列、地點等
| 觸發器 | 前後對比 |
|---|---|
| 庫存數量變動、缺貨及該據點重新有貨 | inventoryLevel.oldAvailable、newAvailable、delta、percentChange、direction,以及位置 |
| 已變更集合名稱、識別碼及描述 | 舊值與新值 |
| 地點更新、公司動態、公司地點更新、折扣更新、部落格更新、部落格文章更新、頁面更新 | 記錄中的 changes.fields 和 changes.items,始終 |
| 收款動態、訂單草稿更新、市場動態 | 當「傳送舊值與新值」功能開啟時,changes清單保持不變 |
| 十項草案順序觸發條件 | 與訂單相同的結構:標籤、備註、屬性、明細項目、狀態、電子郵件及地址 |
| 15 種記錄的元資料欄位更新 | metafield.value, metafield.previousValue |
扳機完整參考指南 列出了每個觸發器及其所有欄位。
數字已包含計算結果
Shopify Flow 的條件僅進行比對,不會進行計算,且金額在 Shopify Flow 中以文字形式傳入。因此,無法在工作流程中根據兩個價格來計算「下跌超過 10%」。因此,價格、單價、成本和庫存觸發器會將結果以數字形式傳送:
| 領域 | 意思 | 範例 |
|---|---|---|
delta |
新值減去舊值 | -5 |
percentChange |
變動值佔原值的百分比 | -12.5 表示下降了 12.5 百分比 |
direction |
increase、decrease 或 unchanged |
decrease |


Shopify Flow 會提供某個欄位的先前值嗎?
但若使用該應用程式自訂的更新觸發器則不然。Shopify 針對「產品更新」、「訂單更新」、「客戶更新」及其他更新觸發器的說明頁面指出,工作流程中僅提供當前值。而此應用程式的觸發器則會傳送更新前與更新後的值。
我可以在 Shopify Flow 中計算出舊的數值嗎?
只有當您在變更發生前自行儲存了該資料時才適用,例如透過另一個工作流程將值複製到元資料欄位中,並在後續讀取該值。該副本必須在首次變更發生前就已存在,並且對於每筆記錄都必須在步驟中保留。該應用程式會針對其監控的欄位自動執行這項記錄管理。
元字段是否可取得前一個值?
是的。此應用程式的每個元欄位觸發器,除了 metafield.value 之外,還會攜帶 metafield.previousValue,適用於 15 種記錄類型。請參閱 Shopify Flow 中的元欄位變更:更新的觸發器與元欄位觸發器。
為什麼在唱片第一次換面時,沒有任何聲音傳出?
此應用程式需要一個起點。當觸發器被啟用時,它會在背景中讀取您現有的記錄一次。在該讀取操作觸及該記錄之前所做的變更,僅會被記錄下來。下一次變更便會觸發。事件歷史紀錄與疑難排解 會顯示該同步的狀態。
後續步驟
- Shopify Flow - Shopify Flow 的更新觸發器與此應用程式並列比較。
- 在單一工作流程中監控超過五個欄位 - 在單一工作流程中監控任意數量的欄位。
- 工作流程範本 - 基於舊版與新版值所建置的現成工作流程。
