按资源类型触发的元字段公司元字段触发器

公司元字段触发器

复制页面

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

批发商将每位B2B客户的约定信用额度存储在公司元字段信用额度(custom.credit_limit)中。当财务部门提高或降低该额度时,客户经理应在下一笔订单下达前知晓。

本页面介绍了如何利用Workflow Trigger Extensions扩展,在公司的某个元字段发生变化时触发Shopify Flow工作流程。对于该资源类型的每个元字段,操作步骤均相同;本示例以信用额度(custom.credit_limit)为例。

您需要准备的物品

  • 一个元字段定义。请在Shopify管理后台的设置>元字段和元对象>公司下创建该元字段。没有定义的元字段无法被追踪。
  • 公司及地点数据访问(B2B)权限。请在应用的权限页面中授予该权限,详情请参阅 权限与数据访问。
  • 在 Shopify 上,“公司”属于 B2B 范畴。该资源类型仅适用于拥有“公司”的商店。

1. 跟踪元字段

  1. 在应用中打开元字段触发器,然后点击添加触发器。
  2. 选择资源类型公司。
  3. 勾选该元字段,此处为信用额度。您可以同时勾选多个选项,或使用全选功能。
  4. 点击添加触发器。

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

“添加元字段触发器”对话框,其中资源类型为“公司”,元字段为“信用额度”(custom.credit_limit),且该选项已勾选
资源类型为“公司”,且该元字段已被勾选。此时,“所有元字段”将跟踪该类型下的所有元字段。

当应用程序读取您现有公司中元字段的当前值时,新触发器会显示初始化中,随后变为已启用。正是由于进行了首次读取,因此第一次更改时就已经包含了正确的先前值。

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

2. 工作流程接收的内容

每次更改都会在 Shopify Flow 中触发元字段更新触发器,并使用以下值:

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

3. 构建工作流程

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

从示例开始

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

让它成为你的

  • 将metafield.previousValue与metafield.value进行比较,以区分是增加还是减少。
  • 使用发送 HTTP 请求将新限额发送至您的 ERP 系统。
  • 在跟踪多个公司元字段时,请为metafieldKey添加一个条件。

反应速度有多快

当保存一家公司时,Shopify 会向该应用发送通知。如果更改仅涉及元字段,有时可能不会发送通知,因此该应用还会每分钟检查一次您的公司列表。该工作流程通常会在几秒钟内完成,最迟不会超过一两分钟。

更多