フルフィルメント注文のデータを取得する
[フルフィルメント注文のデータを取得する] アクションを使用して、ストアから フルフィルメント注文の情報を取得できます。
設定
フィールド
[フルフィルメント注文のデータを取得する] アクションには、クエリの作成に使用される以下のフィールドが含まれています。
| フィールド | 説明 |
|---|---|
| データの並べ替え基準 | 必須。検索クエリによって返されるデータを並べ替えるためのパラメーターです。 |
| 最大結果数 | 必須。選択した検索クエリで返すことができる結果の最大数です。一度に最大 100 件を返すことができます。 |
| クエリ | 必須。一般的なクエリから選択するか、[高度な設定] を選択して独自のクエリを作成します。 |
クエリ文字列
現在保留中のフルフィルメント注文を取得するためのクエリの例は、以下のとおりです。
status:ON_HOLDstatus 変数は、フルフィルメント注文のクエリで利用できるフィルターで、複数回使用したり、他の変数と組み合わせたりすることができます。
データをクエリする際は、以下について知っておくと役立ちます。
- 利用可能なフルフィルメント注文フィルターのリスト
- クエリは特定の構文に従う必要があります。
- クエリフィールドの値は、必ずしも文書化されているわけではありません。場合によっては、API ドキュメントで値が見つかることがあります。あるいは、管理画面で絞り込みを行った際に URL 内でフィールド値が見つかることもよくあります。たとえば、注文クエリの値をいくつか見つけるには、管理画面の注文管理ページで絞り込みを行ってから URL を確認します。
- ストアでクエリを実行またはテストするには、Shopify GraphiQL アプリを使用します。
- クエリが失敗した場合に何が起こるかに注意してください。多くの場合、API は (何もないのではなく) すべての結果を返します。
返されるデータ
すべての [データを取得] アクションは、0~100 個のリソースのリストを返します。ユースケースによっては、このデータをさまざまな方法で使用できます。
- それぞれにタグを追加するなど、リストの各アイテムを個別に処理する必要がある場合は、[For each] アクションを使用できます。
- 返された結果の数をカウントするなど、データを集計する必要がある場合は、[カウント] アクションまたは [合計] アクションを使用できます。
- すべてのアイテムを記載したメールを送信するなど、リストを出力する必要がある場合は、後続のアクションで返されたデータを直接使用できます。
このアクションに続くステップで返されたデータにアクセスするには、[フルフィルメント注文データを取得] という名前の変数 (フルフィルメント注文のリスト) を使用します。この変数は、条件とアクションの両方で使用できます。たとえば、以下のように、[内部メールを送信する] アクションでフルフィルメント注文のリストを送信できます。
{% for fulfillment_order in GetFulfillmentOrderData %}
* Order: {{ fulfillment_order.order.name }} Location: {{ fulfillment_order.assignedLocation.name }}
{% endfor %}トリガー
このアクションは、[スケジュールされた時間] トリガーを含む、すべてのワークフローで使用できます。[スケジュールされた時間] トリガーを使用するワークフローでは、イベントの結果としてではなく、指定した時間にワークフローが開始されます。ストアやアプリからの特定のイベントがワークフローを開始するわけではないため、データは自動的に含まれません。
APIの詳細
テンプレート
保留中のフルフィルメント注文のリストを含む日次メールサマリーを送信する
このワークフローは毎日、保留中のすべてのフルフィルメント注文 (一度に最大 100 件) をクエリします。注文名と割り当てられたフルフィルメントロケーションを含むメールサマリーを送信します。テンプレートを表示する