获取草稿订单数据

在使用草稿订单数据的工作流中,您可以使用获取草稿订单数据操作来从商店中检索草稿订单信息。

配置

字段

获取草稿订单数据操作包含以下用于构建查询的字段:

用于“获取数据”操作的字段。
字段描述
数据排序依据必需。对搜索查询返回的数据进行排序所依据的参数。
最大结果数必需。您选择的搜索查询可返回的最大结果数。一次最多可返回 100 个。
查询必需。从常用查询中进行选择,或选择高级以创建您自己的查询。

查询字符串

以下是用于获取在过去一天内更新的草稿订单的查询示例:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

updated_at 变量是草稿订单查询中可用的筛选器,可以多次使用或与其他变量结合使用。scheduledAt Liquid 变量可用于使用预定时间触发器的工作流。 date_minus Liquid 标记是一个特殊的 Flow 标记,可用于从日期中减去时间。

查询数据时,了解以下信息会很有帮助:

  • 可用订单筛选器列表
  • 查询必须遵循特定语法
  • 查询字段值并非始终都记录在文档中。在某些情况下,可以通过查看 API 文档来找到这些值。或者,当您在后台中进行筛选时,通常可以在 URL 中找到字段值。例如,要查找某些订单查询值,请在后台的“订单”页面中进行筛选,然后检查 URL。
  • 您可以使用 Shopify GraphiQL 应用在您的商店中运行或测试查询。
  • 请注意查询失败时会发生什么。通常,API 将返回所有结果(而不是不返回任何结果)。

返回的数据

所有获取数据操作都会返回一个包含 0 到 100 个资源的列表。根据您的用例,您可能希望以各种方式使用这些数据:

  • 如果您需要单独处理每个列表项(例如为每个列表项添加标记),则可以使用 For each 操作。
  • 如果您需要聚合数据(例如对返回的结果数进行计数),则可以使用 CountSum 操作。
  • 如果您需要输出列表(例如发送一封包含所有商品的电子邮件),则可以直接在后续操作中使用返回的数据。

要在此操作之后的步骤中访问返回的数据,请使用名为获取草稿订单数据的变量,该变量是草稿订单列表。您可以在条件和操作中同时使用此变量。例如,您可以在发送内部电子邮件操作中发送草稿订单列表,如下所示:

{% for single_order in GetDraftOrderData %}
* {{ single_order.name }}
{% endfor %}

触发器

您可以在任何工作流(包括预定时间触发器)中使用此操作。在使用预定时间触发器的工作流中,工作流在您指定的时间开始,而不是因某个事件而开始。由于没有商店中或来自应用的特定事件来启动工作流,因此不会自动包含任何数据。

API 详细信息

模板

发送包含所有未结草稿订单的每日通知

每天获取未结草稿订单,对它们进行计数,然后发送 Slack 消息。使用“预定时间”触发器、“获取草稿订单”和“计数”操作。 查看模板