リソースの種類ごとのメタフィールドのトリガー在庫振替メタフィールドのトリガー

在庫振替メタフィールドのトリガー

ページをコピーする

在庫振替のメタフィールドが変更された際に、Shopify Flowのワークフローを開始します。Workflow Trigger Extensionsでその変更を追跡し、変更前の値と変更後の値を取得します。

マーチャントは倉庫間で在庫を移動させる際、運送業者の追跡参照番号を、転送メタフィールド「運送業者参照番号(custom.carrier_reference)」に入力します。この情報が入力され次第、受入倉庫にその情報が通知されるはずです。

このページでは、Workflow Trigger Extensionsを使用して、在庫移動のメタフィールドが変更された際にShopify Flowワークフローを開始する方法について説明します。手順はこのリソースタイプのすべてのメタフィールドで同じですが、この例では「運送業者参照(custom.carrier_reference)」を使用しています。

必要なもの

  • メタフィールドの定義です。Shopifyの管理画面で、「設定」>「メタフィールドとメタオブジェクト」>「転送」から作成してください。定義のないメタフィールドは追跡できません。
  • 「在庫移動」のデータアクセス権限です。アプリの「権限」ページでこの権限を付与してください。詳細は権限とデータへのアクセスをご覧ください。

1. メタフィールドを追跡する

  1. アプリで「メタフィールドのトリガー」を開き、「トリガーを追加」をクリックしてください。
  2. リソースの種類として「転送」を選択してください。
  3. メタフィールド(ここでは「キャリア参照」)にチェックを入れてください。複数の項目に一度にチェックを入れるか、「すべて選択」をご利用いただけます。
  4. 「トリガーを追加」をクリックしてください。

このリソースタイプのすべてのメタフィールド(後で作成するメタフィールドも含む)を追跡するには、個々のメタフィールドにチェックを入れるのではなく、「すべてのメタフィールド」を選択し、次に「すべてのメタフィールドを追跡」をクリックしてください。

リソースタイプが「Transfer」で、メタフィールド「Carrier reference」のチェックボックスがオンになっている「メタフィールドのトリガーを追加」ダイアログ
リソースタイプ「転送」で、メタフィールドにチェックが入っています。「すべて」を選択すると、そのタイプのすべてのメタフィールドが追跡対象となります。

このトリガーは「即時有効」です。アプリが在庫振替データを初めて読み込んだ際は、ワークフローを開始せずに現在の値を保存します。それ以降の変更があるたびに、ワークフローが開始されます。

リストにメタフィールドが含まれていない場合は、「メタフィールド・トリガー」ページにある「メタフィールドを更新」をクリックしてください。アプリは定義のリストを1時間記憶しています。

2. ワークフローが受け取るもの

変更が行われるたびに、Shopify Flow において「Metafield Update」トリガーが、以下の値で起動します:

変数 値
resourceType TRANSFER
resourceId 在庫振替のIDです。例:gid://shopify/InventoryTransfer/1234567890
metafieldKey 名前空間とキー、ここではcustom.carrier_referenceです
metafield.value 新たな価値
metafield.previousValue 変更前の値。メタフィールドが初めて設定された場合は空です。
metafield.type メタフィールドの型です。例えば、single_line_text_field などです。

3. ワークフローを構築する

  1. Shopify Flow でワークフローを作成し、Workflow Trigger Extensionsのトリガー「メタフィールド Update」を選択してください。
  2. 条件を追加します:resourceType が TRANSFER と等しいこと。メタフィールドの更新は、追跡対象のリソースタイプごとに開始されるため、この条件を設定することで、このワークフローを在庫振替に限定します。当該タイプのメタフィールドを複数追跡している場合は、2つ目の条件として、metafieldKey が custom.carrier_reference と等しいことを追加してください。
  3. 必要なアクションを追加してください。この例では、旧値と新値を記載した社内メールを送信します。
Shopify Flow のワークフロー例:「メタフィールドの更新」、リソースタイプ「TRANSFER」の条件、および内部メールの送信
ワークフローの例:トリガー、リソースタイプに基づく条件、および1つのアクションです。

例から始めましょう

  1. このページの下部に添付されている.flowファイルをダウンロードしてください。
  2. Shopifyの管理画面で「Shopify Flow」を開き、「インポート」をクリックしてファイルを選択してください。
  3. 「内部メールを送信」ステップを開き、受信者を入力してください。このファイルには、意図的にアドレスが記載されていません。
  4. ワークフローを有効にしてください。

自分だけのものにしましょう

  • 「metafield.previousValueが空である」という条件を追加し、参照が初めて入力されたときのみ反応するようにします。
  • 「HTTPリクエストの送信」を使用して、参照情報を受入倉庫のシステムに送信してください。
  • 複数の転送メタフィールドを追跡する場合は、metafieldKey に条件を追加してください。

反応の速さ

Shopifyからはこの件に関する通知は送信されませんので、アプリは追跡対象のメタフィールドを約1分ごとに読み取ります。ワークフローは1~2分以内に実行される見込みです。

知っておくと便利です

  • 過去90日以内に作成された転送は監視対象となります。それより古い転送のメタフィールドが変更されても、ワークフローは開始されません。
  • 新しい転送データは、約1分以内に初めて確認されます。その時点でメタフィールドにすでに設定されている値は初期値となり、これによってワークフローは開始されませんが、それ以降の変更についてはワークフローが開始されます。

続きを読む