取得 metaobject 項目

您可以使用 取得 metaobject 項目 動作，依照選用的查詢，從商店擷取某個 metaobject 的項目清單。詳情請參閱 metaobject 說明文件。

設定

欄位

取得 metaobject 項目 動作包含一個下拉式選單，用於指定 metaobject 定義，另有下列欄位可用來建構查詢：

查詢字串

以下為範例查詢：如果某個 email 欄位的值與訂單上的電子郵件地址相符，即可擷取 metaobject 項目：

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

以下為範例查詢：擷取過去一天內更新的 metaobject 項目：

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

updated_at 變數是可用於 Metaobjects 查詢 的篩選條件，可重複使用，或與其他變數搭配。scheduledAt Liquid 變數可用於採用 排程時間觸發條件 的工作流程。date_minus Liquid 標籤是 Flow 的特殊標籤，可用來從日期扣除時間。

查詢資料時，以下資訊很有幫助：

• 可用的 metaobject 篩選條件清單
• 依欄位值查詢 metaobject 需要該 metaobject 已 啟用篩選功能，您可以在 Shopify 管理介面的 自訂資料選項 中啟用。
• 查詢必須遵循 特定語法
• 查詢欄位的值不一定都有文件記載。有時可以在 API 文件 中找到這些值。另一種方式是在管理介面進行篩選時，常可在網址中找到欄位值。例如，要找某些訂單查詢值，請在管理介面的「訂單」頁面套用篩選條件，再檢視網址。
• 您可以使用 Shopify GraphiQL app 在您的商店執行或測試查詢。
• 請留意查詢失敗時的情況。API 通常會回傳所有結果 (而非沒有結果)。

回傳資料

所有 擷取資料 動作都會回傳一個清單，包含 0 到 100 個資源。依您的使用情境，您可以用不同方式運用這些資料：

• 若需要逐一處理清單中的每個品項，例如為每個品項新增標籤，您可以使用 逐一處理 動作。
• 若需要彙整資料，例如計算回傳了多少筆結果，您可以使用 計數 或 加總 動作。
• 若需要輸出清單，例如寄送包含所有品項的電子郵件，後續動作可以直接使用回傳資料。

在這個動作之後的步驟中，如果要存取回傳資料，請使用名為 擷取 metaobject 項目 的變數，該變數是一個 metaobject 項目清單。您可以在條件與動作中使用此變數。例如，您可以在 寄送內部電子郵件 動作中，寄送 metaobject 項目的鍵值配對清單，如下：

{% 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 %}

觸發條件

此動作可用於任何工作流程，包括 排程時間 觸發條件。在使用 排程時間 觸發條件的工作流程中，流程會在您指定的時間開始，而不是由某個事件觸發。由於工作流程不是因為您的商店或某個 app 的特定事件而啟動，因此不會自動包含任何資料。

API 詳細資料

• metaobject 資源
• metaobject 查詢篩選條件
• 依欄位值查詢 metaobject