获取多个元对象条目

您可以使用获取多个元对象条目操作,根据可选查询从您的商店中检索元对象的条目列表。请参阅元对象文档以了解更多信息。

配置

字段

获取多个元对象条目操作包含一个下拉菜单,用于指定元对象定义以及用于构建查询的以下字段:

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

查询字符串

如果 email 字段的值与订单上的电子邮件地址匹配,则下方的示例查询用于获取元对象条目:

{{fields.email}}:"{{order.email}}"

下方的示例查询用于获取过去一天内更新的元对象条目:

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

updated_at 变量是在元对象查询中可用的筛选条件,可多次使用或与其他变量Combine使用。scheduledAt Liquid 变量适用于使用“已安排时间”触发器的工作流。date_minus Liquid 标记是特殊的 Flow 标记,可用于提取日期中的时间。

查询数据时,了解以下内容将有所帮助:

返回的数据

所有获取数据操作都将返回包含 0 到 100 个资源的列表。根据您的用例,您可能需要以多种方式使用此数据:

  • 如果您需要单独处理每个列表项,例如为每个项目添加标签,则您可以使用针对每项操作。
  • 如果您需要聚合数据,例如计算返回的结果数,则您可以使用计数求和操作。
  • 如果您需要输出该列表,例如发送包含所有项目的电子邮件,则可以直接使用在后续操作中返回的数据。

若要访问此操作后的步骤中返回的数据,请使用名为获取多个元对象条目的变量,该变量为一个元对象条目列表。您可在条件和操作中使用此变量。例如,您可在类似下方的发送内部电子邮件操作中发送元对象条目的键值对列表,如下所示:

{% for getMetaobjectEntries_item in getMetaobjectEntries %}
Key-value pairs for entry:
  {% for fields_item in getMetaobjectEntries_item.system.fields %}
    {{fields_item.key}}:{{fields_item.value}}
  {% endfor %}
{% endfor %}

触发器

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

API 详细信息

没有找到您需要的答案?我们将为您提供帮助。