产品变体元字段触发器
当产品变体元字段发生变化时,触发Shopify Flow工作流程。在Workflow Trigger Extensions中跟踪该变化,并获取新旧值。
仓库会在“变体元字段”中的货位(custom.bin_location)字段里存储每个变体的货架位置。当某个变体被移至另一个货架时,拣货团队需要在打包下一笔订单之前获取新的货位信息。
本页面介绍了如何利用Workflow Trigger Extensions扩展,在产品变体的元字段发生变化时触发 Shopify Flow 工作流程。对于该资源类型的每个元字段,操作步骤均相同;本示例以“货位”(custom.bin_location)为例。
您需要准备的物品
- 元字段定义。请在Shopify管理后台的设置>元字段和元对象>变体中创建该元字段。未定义的元字段无法被追踪。
- 产品、变体和产品系列数据访问权限。请在应用的权限页面中授予该权限,详情请参阅 权限与数据访问。
1. 跟踪元字段
- 在应用中打开元字段触发器,然后点击添加触发器。
- 选择资源类型产品变体。
- 勾选元字段,此处为Bin 地点。您可以同时勾选多个选项,或使用全选功能。
- 点击添加触发器。
若要跟踪此资源类型的所有元字段(包括您稍后创建的元字段),请选择所有元字段而非逐个勾选,然后点击跟踪所有元字段。

当应用程序读取现有产品变体中元字段的当前值时,新触发器会显示初始化中,随后变为已启用。正是由于进行了首次读取,因此第一次更改时就已经包含了正确的先前值。
如果列表中缺少该元字段,请在“元字段触发器”页面上点击刷新元字段:该应用会将定义列表保存一小时。
2. 工作流程接收的内容
每次更改都会在 Shopify Flow 中触发元字段更新触发器,并使用以下值:
| 变量 | 值 |
|---|---|
resourceType |
PRODUCTVARIANT |
resourceId |
产品变体的 ID,例如 gid://shopify/ProductVariant/1234567890 |
metafieldKey |
命名空间和键,此处为 custom.bin_location |
metafield.value |
新价值 |
metafield.previousValue |
更改前的值;当元字段首次设置时,该值为空 |
metafield.type |
元字段的类型,例如single_line_text_field |
产品变体元字段更新是针对同一变更的第二个触发器。它会在“元字段更新”触发器启动后额外触发,并将父产品作为原生 Flow 引用。这两个触发器共享同一事件,因此同时使用它们不会被计为两次。您可以在应用的触发器页面中启用它,或者启用一个使用该触发器的工作流程。
3. 构建工作流程
- 在 Shopify Flow 中,创建一个工作流程,并选择Workflow Trigger Extensions中的元字段更新触发器。
- 添加一个条件:
resourceType等于PRODUCTVARIANT。由于“元字段更新”会针对您跟踪的每种资源类型启动,因此该条件可确保此工作流程仅针对产品变体。如果您跟踪了该类型的多个元字段,请将metafieldKey等于custom.bin_location作为第二个条件添加。 - 添加所需的操作。该示例会发送一封内部邮件,其中包含旧值和新值。

从示例开始
- 请下载本页面底部附带的
.flow文件。 - 在您的 Shopify 管理后台中打开Shopify Flow,点击导入,然后选择文件。
- 打开发送内部电子邮件步骤,并输入收件人。该文件特意未包含任何地址。
- 启用该工作流程。
让它成为你的
- 使用发送 HTTP 请求将新的货位地点发送至您的仓库系统。
- 当工作流程需要为父产品添加标签或更新父产品时,请使用产品变体元字段更新功能。
- 当您需要跟踪多个变体元字段,并且希望为每个元字段设置一个工作流程时,请在
metafieldKey上添加一个条件。
反应速度有多快
当变体元字段发生变化时,Shopify 不会发送通知,因此该应用会每分钟检查一次您的商品目录,并仅读取发生变化的变体。该工作流程通常会在几分钟内完成;但对于大型商品目录,首次检查可能需要更长时间。
值得了解
- 变体元字段不会触发产品元字段更新操作:该触发器仅适用于产品本身的元字段。
更多
- 元字段触发器:元字段触发器的工作原理,适用于所有资源类型。
- 事件历史记录和故障排除:查看应用程序发送的每个事件,包括旧值和新值。
