获取元对象条目

您可以使用获取元对象条目操作，根据可选查询从您的商店中检索元对象的条目列表。有关详细信息，请参阅元对象文档。

配置

字段

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

查询字符串

如果 email 字段的值与某个订单上的电子邮件地址匹配，可使用以下查询示例来获取元对象条目：

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

可使用以下查询示例来获取在过去一天内更新的元对象条目：

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

updated_at 变量是 元对象查询 上提供的一个筛选器，可以多次使用或与其他变量结合使用。scheduledAt 动态占位符适用于使用计划时间触发器的工作流。date_minus Liquid 标记是一种特殊的 Flow 标记，可让您从日期中减去时间。

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

• 可用元对象筛选器列表
• 按字段值查询元对象要求为元对象启用筛选，此功能可在 Shopify 后台的自定义数据选项中启用。
• 查询必须遵循特定语法
• 查询字段值并非总是有文档记录。在某些情况下，可以通过查看 API 文档来找到这些值。此外，当您在后台中进行筛选时，通常可以在 URL 中找到字段值。例如，若要查找某些订单查询值，请在后台中筛选“订单”页面，然后检查 URL。
• 您可以使用 Shopify GraphiQL 应用在您的商店中运行或测试查询。
• 请注意查询失败时会发生什么。API 通常会返回所有结果（而不是不返回任何结果）。

返回的数据

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

• 如果您需要单独处理每个列表项（例如为每个列表项添加标记），则可以使用 For each 操作。
• 如果您需要聚合数据（例如统计返回的结果数），则可以使用计数或求和操作。
• 如果您需要输出该列表（例如通过电子邮件发送所有商品），那么您可以在后续操作中直接使用返回的数据。

要在此操作之后的步骤中访问返回的数据，请使用名为获取元对象条目的变量，该变量是元对象条目的列表。您可以在条件和操作中都使用此变量。例如，您可以采用以下方式在发送内部电子邮件操作中发送元对象条目的键值对列表：

{% 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 详细信息

• 元对象资源
• 元对象查询筛选器
• 按字段值查询元对象