取得 metaobject 項目

您可以使用取得 metaobject 項目動作根據選用查詢從商店中擷取 Metaobject 的項目清單。如需詳細資訊,請參閱 metaobject 說明文件

設定

欄位

取得 metaobject 項目動作包含一個用於指定 metaobject 定義的下拉清單以及用於建置查詢的下列欄位:

「取得資料」動作中使用的欄位。
欄位說明
資料排序依據必填。對搜尋查詢返回資料進行排序的參數。
結果數量上限必填。您選取的搜尋查詢可傳回的結果數量上限。一次最多可以傳回 100 筆。
查詢必填。從一般查詢中選擇,或選取 Advanced (進階) 建立自己的查詢。

查詢字串

這是一個查詢範例,用於取得 Metaobject 項目,當 email 欄位的值與訂單中的電子郵件地址相符時:

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

此為範例查詢,目的是取得前一天更新的 metaobject 項目:

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

updated_at 參數是 metaobjects 查詢中的篩選條件,可重複使用或與其他變數合併使用。scheduledAt Liquid 變數適用於使用「排定時間」(Scheduled time) 觸發條件的工作流程。date_minus Liquid 標籤是特殊 Flow 標籤,可讓您從日期中減去時間。

查詢資料時,瞭解以下資訊會有所助益:

傳回的資料

所有「取得資料」動作都會傳回一份包含 0 到 100 個資源的清單。依使用案例而定,您可以透過多種方式使用這份資料:

  • 如果需要單獨處理每個清單項目,例如為每個清單項目新增標籤,則可以使用 For each (每個) 動作。
  • 如果需要彙總資料,例如計算傳回的結果筆數,則可以使用 Count (計數) 或 Sum (總和) 動作。
  • 如果需要輸出清單,例如傳送包含所有項目的電子郵件,可以在後續動作直接使用傳回的資料。

若要存取此動作之後的步驟中傳回的資料,請使用名稱為「取得 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 %}

觸發條件

您可以在任何工作流程 (包含排程時間觸發條件) 中使用此動作。在使用排程時間觸發條件的工作流程中,工作流程會在您指定的時間啟動,而非因為事件的結果而啟動。由於您的商店或應用程式沒有啟動工作流程的特定事件,因此系統不會自動包含任何資料。

API 詳細資訊

沒有找到您需要的答案嗎?我們很樂意為您提供協助。