会社のロケーションデータを取得する

会社のロケーションデータを使用するワークフローでは、「会社のロケーションデータを取得する」アクションを使用して、ストアから会社のロケーション情報を取得できます。

設定

フィールド

「会社のロケーションデータを取得する」アクションには、クエリを作成するために使用される以下のフィールドが含まれています。

クエリ文字列

過去1日以内に更新された会社のロケーションを取得するためのクエリの例は、次のとおりです。

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

updated_at 変数は、会社のロケーションクエリで利用できるフィルターで、複数回使用したり、他の変数と組み合わせたりすることができます。scheduledAt Liquid 変数は、「スケジュールされた時間」トリガーを使用したワークフローで利用できます。date_minus Liquid タグは、日付から時間を減算できる特別な Flow タグです。

データをクエリする際は、以下の点に留意すると役立ちます。

• 利用可能な会社のロケーションのフィルターリスト
• クエリは特定の構文に従う必要があります。
• クエリフィールドの値は、必ずしも文書化されているわけではありません。場合によっては、API ドキュメントで値が見つかることがあります。あるいは、管理画面で絞り込みを行った際に、URL にフィールド値が表示されることもよくあります。たとえば、注文クエリの値をいくつか見つけるには、管理画面の [注文管理] ページで絞り込みを行い、URL を確認します。
• Shopify GraphiQL アプリを使用して、ストアでクエリを実行またはテストすることができます。
• クエリが失敗した場合に何が起こるかに注意してください。多くの場合、API は (結果なしではなく) すべての結果を返します。

返されるデータ

すべての「データを取得する」アクションは、0～100個のリソースのリストを返します。ユースケースによっては、このデータをさまざまな方法で使用できます。

• 各リストアイテムを個別に処理する必要がある場合 (各アイテムにタグを追加するなど)、[For each] アクションを使用できます。
• 返された結果の数をカウントするなど、データを集計する必要がある場合は、[Count (カウント)] または [Sum (合計)] アクションを使用できます。
• すべてのアイテムを記載したメールを送信するなど、リストを出力する必要がある場合は、後続のアクションで返されたデータを直接使用できます。

このアクションに続くステップで返されたデータにアクセスするには、「会社のロケーションデータを取得する」という名前の変数を使用します。これは会社のロケーションのリストです。この変数は、条件とアクションの両方で使用できます。たとえば、次のように [内部メールを送信する] アクションでロケーションのリストを送信できます。

{% for single_company in GetCompanyLocationData %}
* {{ single_company.name }}
{% endfor %}

トリガー

このアクションは、「スケジュールされた時間」トリガーを含むすべてのワークフローで使用できます。「スケジュールされた時間」トリガーを使用するワークフローでは、ワークフローはイベントの結果としてではなく、指定した時間に開始されます。ストアやアプリからの特定のイベントによってワークフローが開始されるわけではないため、データは自動的には含まれません。

APIリファレンス

• 会社のロケーションリソース
• 会社のロケーションクエリフィルター