新旧值:工作流程能如何利用它们
Shopify Flow
Flow 自身更新的触发器会将记录的当前状态传递给工作流程。Shopify 的帮助页面针对每个触发器都明确指出:仅提供当前值,变更前的值不可用。对于“发生变更”的警报而言,这样就足够了。
许多工作流程需要比这更多的信息。“价格下跌了10%以上”需要旧价格;“处理程序已更改,请重定向旧URL”需要旧处理程序;“客户已取消订阅”则需要知道该客户之前曾订阅过。 该应用的每个变更触发器都同时携带这两个值,因此这些工作流程仅包含条件和操作两部分,无需编写代码,也无需手动存储任何数据。
前面的值是从哪里来的
该应用会为每个记录记住其监视字段的最后已知值。当Shopify报告更新时,它会进行比对;若监视字段发生变化,则会触发触发器并传入这两个值。实际应用中有两个细节需要注意:
- 当应用首次检测到一条记录时,它只会将其记下来。此时不会触发任何操作,因为没有可供比较的对象。当您开启某个触发器后,应用会在后台一次性读取您现有的记录,这样一来,第一次真正的变更就会触发相应操作。对于订单,默认会读取最近60天的数据,您可以在应用中扩展该时间范围。
- 这些值对应于变更发生时的状态。基于“Shopify Flow 更新”触发器的工作流程会在运行时读取该记录。如果一秒后该记录再次发生变化或被删除,该工作流程将看到更新后的状态,或者无法加载该记录。而该应用中的事件则会保留其创建时的值。 您稍后可在该应用的“事件历史记录”中查看这些值。

只有利用之前的值才能构建的内容
| 工作流程 | 触发器 | 需要旧值的条件 | 即用型 |
|---|---|---|---|
| 当产品或产品系列更名时,将旧网址重定向 | 产品标识符已更改,产品系列标识符已更改 | 无:重定向从 oldHandle 指向 newHandle |
当产品标识符发生变化时,将旧的产品 URL 重定向, 当产品系列标识符发生变化时,重定向旧的产品系列 URL |
| 为价格下降10%或以上的产品添加标签 | 产品变体价格已更改 | priceChange.percentChange 小于或等于 -10 |
当某款产品的变体价格下降10%或以上时,为其添加标签 |
| 将商品标记为“促销”,然后取消该标记 | 产品变体价格已更改 | priceChange.oldCompareAtPrice.amount为空,而priceChange.newCompareAtPrice.amount不为空,或者情况相反 |
添加“原价”时,将商品标记为“促销中”, 当“原价”被移除时,请移除促销标签 |
| 当有待处理的付款到账时,释放订单 | 订单财务状态已变更 | oldFinancialStatus 等于 pending,且 newFinancialStatus 等于 paid |
在收到待处理付款时标记订单 |
| 结账后地址发生变更时,请通知仓库 | 订单收货地址已更改 | 无:消息中显示了oldShippingAddress和shippingAddress |
当结账后收货地址发生变更时,对订单进行标记 |
| 给取消订阅的客户打上标签,当他们回来时取消标签 | 客户电子邮件营销同意条款已变更 | consentState 等于 unsubscribed;oldConsentState 显示其之前的状态 |
当客户取消订阅电子邮件营销时,为其添加标签 |
| 请为您的ERP或数据源保留原有的SKU | 产品变体 SKU 已更改 | none: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:客户元字段更新事件携带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 |
触发器完整参考指南列出了每个触发器及其所有字段。
数字本身就包含算术运算结果
Flow 仅进行条件比较,不进行计算,且金额数据以文本形式传入 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 的更新版触发器和 Workflow Trigger Extensions - Shopify Flow 的更新触发器与本应用的对比。
- 在一个工作流程中监控五个以上的字段 - 在一个工作流程中监控任意数量的字段。
- 工作流程模板 - 基于新旧值的现成工作流程。
