按资源类型触发的元字段库存转移元字段触发器

库存转移元字段触发器

复制页面

当库存转移元字段发生变化时,触发Shopify Flow工作流程。在Workflow Trigger Extensions中跟踪该变化,并获取新旧值。

商家在仓库之间调拨库存时,会将承运商的追踪编号填写到“承运商编号”(custom.carrier_reference)元字段中。该元字段一经填写,收货仓库就应收到该信息。

本页面介绍了如何利用Workflow Trigger Extensions扩展,在库存转移的元字段发生变化时触发Shopify Flow工作流程。对于该资源类型的每个元字段,操作步骤均相同;本示例以承运商参考码(custom.carrier_reference)为例。

您需要准备的物品

  • 元字段定义。请在Shopify后台的设置>元字段和元对象>转移中创建该元字段。未定义的元字段无法被追踪。
  • 库存转移数据访问权限。请在应用的权限页面中授予该权限,详情请参阅 权限与数据访问。

1. 跟踪元字段

  1. 在应用中打开元字段触发器,然后点击添加触发器。
  2. 选择资源类型转移。
  3. 勾选元字段,此处为承运人参考号。您可以同时勾选多个选项,或使用全选功能。
  4. 点击添加触发器。

若要跟踪此资源类型的所有元字段(包括您稍后创建的元字段),请选择所有元字段而非逐个勾选,然后点击跟踪所有元字段。

“添加元字段触发器”对话框中,资源类型为“Transfer”,且元字段“Carrier reference”(custom.carrier_reference)已被勾选
资源类型为“传输”,且该元字段已被勾选。此时,“所有元字段”将跟踪该类型下的所有元字段。

该触发器为“立即激活”。应用程序首次读取库存转移数据时,会存储当前值而不启动工作流程;此后每次发生变更都会启动一个工作流程。

如果列表中缺少该元字段,请在“元字段触发器”页面上点击刷新元字段:该应用会将定义列表保存一小时。

2. 工作流程接收的内容

每次更改都会在 Shopify Flow 中触发Metafield Update触发器,并使用以下值:

变量 值
resourceType TRANSFER
resourceId 库存转移的 ID,例如 gid://shopify/InventoryTransfer/1234567890
metafieldKey 命名空间和键,此处为 custom.carrier_reference
metafield.value 新价值
metafield.previousValue 更改前的值;当元字段首次设置时,该值为空
metafield.type 元字段的类型,例如single_line_text_field

3. 构建工作流程

  1. 在 Shopify Flow 中,创建一个工作流程,并选择Workflow Trigger Extensions中的元字段更新触发器。
  2. 添加一个条件:resourceType 等于 TRANSFER。由于“元字段更新”会针对您跟踪的每种资源类型触发,因此该条件可确保此工作流程仅处理库存转移。如果您跟踪该类型的多个元字段,请将 metafieldKey 等于 custom.carrier_reference 作为第二个条件添加。
  3. 添加所需的操作。该示例会发送一封内部邮件,其中包含旧值和新值。
Shopify Flow 中的示例工作流程:元字段更新、针对资源类型 TRANSFER 的条件以及发送内部电子邮件
示例工作流程:触发器、针对资源类型的条件以及一个操作。

从示例开始

  1. 请下载本页面底部附带的.flow文件。
  2. 在您的 Shopify 管理后台中打开Shopify Flow,点击导入,然后选择文件。
  3. 打开发送内部电子邮件步骤,并输入收件人。该文件特意未包含任何地址。
  4. 启用该工作流程。

让它成为你的

  • 添加条件“metafield.previousValue为空”,以便仅在首次填写该引用时触发反应。
  • 使用发送 HTTP 请求将参考号发送至收货仓库的系统。
  • 在跟踪多个转账元字段时,请为metafieldKey添加一个条件。

反应速度有多快

Shopify 不会就此发送通知,因此该应用大约每分钟读取一次被追踪的元字段。工作流程预计将在一两分钟内完成。

值得了解

  • 系统会监控过去90天内创建的转账。如果对更早的转账修改了元字段,则不会触发任何工作流程。
  • 大约一分钟内会首次检测到新的数据变更。此时元字段已有的值即为其初始值,该值不会触发任何工作流程;此后每次变更都会触发工作流程。

更多