会社の所在地メタフィールドのトリガー
会社のロケーションメタフィールドが変更された際に、Shopify Flowのワークフローを開始します。Workflow Trigger Extensionsでその変更を追跡し、変更前の値と変更後の値を取得します。
あるB2Bの顧客には複数の支店があり、各支店ごとに受取時間が異なります。これらの時間は、会社のロケーションメタフィールド「受取時間枠」(custom.delivery_window)に保存されており、物流部門は、次の出荷がプランされる前に変更について通知を受ける必要があります。
このページでは、Workflow Trigger Extensionsを使用して、会社のロケーションのメタフィールドが変更された際にShopify Flowワークフローを開始する方法について説明します。手順はこのリソースタイプのすべてのメタフィールドで同じですが、この例では「配送時間帯」(custom.delivery_window)を使用しています。
必要なもの
- メタフィールドの定義です。Shopifyの管理画面で、「設定」>「メタフィールドとメタオブジェクト」>「会社のロケーション」から作成してください。定義が設定されていないメタフィールドは追跡できません。
- 「会社および会社のロケーションデータへのアクセス(B2B)」という権限です。アプリの「権限」ページでこの権限を許可してください。詳細は権限とデータへのアクセスをご参照ください。
- 「会社のロケーション」は、ShopifyのB2B機能の一部です。このリソースタイプは、会社が存在するストアでのみ有効です。
1. メタフィールドを追跡する
- アプリで「メタフィールドのトリガー」を開き、「トリガーを追加」をクリックしてください。
- リソースの種類として「会社のロケーション」を選択してください。
- メタフィールド(ここでは「配達時間帯」)にチェックを入れてください。複数の項目に一度にチェックを入れるか、「すべて選択」をご利用いただけます。
- 「トリガーを追加」をクリックしてください。
このリソースタイプのすべてのメタフィールド(後で作成するメタフィールドも含む)を追跡するには、個々のメタフィールドにチェックを入れるのではなく、「すべてのメタフィールド」を選択し、次に「すべてのメタフィールドを追跡」をクリックしてください。

新しいトリガーは、アプリが既存の会社ロケーションのメタフィールドの現在の値を読み取っている間、「初期化中」と表示され、その後「アクティブ」となります。この最初の読み取りがあるからこそ、最初の変更の時点で、すでに正しい以前の値が反映されているのです。
リストにメタフィールドが含まれていない場合は、「メタフィールド・トリガー」ページにある「メタフィールドを更新」をクリックしてください。アプリは定義のリストを1時間記憶しています。
2. ワークフローが受け取るもの
変更が行われるたびに、Shopify Flow において「メタフィールド Update」トリガーが、以下の値で起動します:
| 変数 | 値 |
|---|---|
resourceType |
COMPANYLOCATION |
resourceId |
会社のロケーションのIDです。例:gid://shopify/CompanyLocation/1234567890 |
metafieldKey |
名前空間とキー。ここでは custom.delivery_window です。 |
metafield.value |
新たな価値 |
metafield.previousValue |
変更前の値。メタフィールドが初めて設定された場合は空です。 |
metafield.type |
メタフィールドの型です。例えば、single_line_text_field などです。 |
3. ワークフローを構築する
- Shopify Flow でワークフローを作成し、Workflow Trigger Extensionsのトリガー「メタフィールド Update」を選択してください。
- 条件を追加します:
resourceTypeがCOMPANYLOCATIONと等しいこと。追跡対象のリソースタイプごとに「メタフィールドの更新」が開始されるため、この条件を設定することで、このワークフローの対象を会社のロケーションに限定します。このタイプのメタフィールドを複数追跡している場合は、2つ目の条件として、metafieldKeyがcustom.delivery_windowと等しいことを追加してください。 - 必要なアクションを追加してください。この例では、旧値と新値を記載した社内メールを送信します。

例から始めましょう
- このページの下部に添付されている
.flowファイルをダウンロードしてください。 - Shopifyの管理画面で「Shopify Flow」を開き、「インポート」をクリックしてファイルを選択してください。
- 「内部メールを送信」ステップを開き、受信者を入力してください。このファイルには、意図的にアドレスが記載されていません。
- ワークフローを有効にしてください。
自分だけのものにしましょう
- 「HTTPリクエストを送信」を使用して、新しいウィンドウをキャリアまたはプランツールに送信してください。
- 複数の会社のロケーションメタフィールドを追跡する場合は、
metafieldKeyに条件を追加してください。 metafield.previousValueを使って、メール内に以前の値を記載しておけば、誰もわざわざ調べる必要がなくなります。
反応の速さ
Shopifyは、会社のロケーションが保存されるとアプリに通知します。メタフィールドのみに影響する変更の場合、通知が送信されないこともあるため、アプリでは1分間に1回程度の頻度で会社のロケーションを確認しています。ワークフローは数秒以内に完了する見込みですが、遅くとも1~2分以内には完了するはずです。
続きを読む
- メタフィールドのトリガー:すべてのリソースタイプにおけるメタフィールド・トリガーの仕組みについて。
- イベント履歴とトラブルシューティング:アプリが送信したすべてのイベントを、旧値と新値とともに確認できます。
