リソースの種類ごとのメタフィールドのトリガー商品バリエーションのメタフィールド・トリガー

商品バリエーションのメタフィールド・トリガー

ページをコピーする

商品バリエーションのメタフィールドが変更された際に、Shopify Flowのワークフローを開始します。Workflow Trigger Extensionsでその変更を追跡し、変更前の値と変更後の値を取得します。

倉庫では、各バリエーションの「保管場所」(custom.bin_location)というバリエーションメタフィールドに、そのバリエーションが置かれている棚の情報が保存されています。バリエーションが別の棚に移動した場合、ピッキングチームは、次の注文の梱包を行う前に、新しいロケーションを把握しておく必要があります。

このページでは、Workflow Trigger Extensionsを使用して、商品バリエーションのメタフィールドが変更された際にShopify Flowワークフローを開始する方法について説明します。手順はこのリソースタイプのすべてのメタフィールドで同じですが、この例では「ビン位置」(custom.bin_location)を使用しています。

必要なもの

  • メタフィールドの定義です。Shopifyの管理画面で、「設定」>「メタフィールドとメタオブジェクト」>「バリエーション」から作成してください。定義のないメタフィールドは追跡できません。
  • 「製品、バリエーション、コレクションのデータへのアクセス」という権限です。アプリの「権限」ページでこの権限を付与してください。詳細は権限とデータへのアクセスをご参照ください。

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

  1. アプリで「メタフィールドのトリガー」を開き、「トリガーを追加」をクリックしてください。
  2. リソースの種類として「商品バリエーション」を選択してください。
  3. メタフィールド(ここでは「ビン位置」)にチェックを入れてください。一度に複数の項目にチェックを入れることも、「すべて選択」を使用することもできます。
  4. [トリガーの追加] をクリックしてください。

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

リソースタイプが「商品バリエーション」、メタフィールドが「Bin location」で、カスタムメタフィールド「custom.bin_location」にチェックが入った「メタフィールドのトリガーを追加」ダイアログ
リソースタイプ「商品バリエーション」で、メタフィールドにチェックが入っています。すべてのメタフィールドは、そのタイプのすべてのメタフィールドを追跡します。

新しいトリガーは、アプリが既存の商品バリエーションのメタフィールドの現在の値を読み取っている間、「初期化中」と表示され、その後「アクティブ」となります。この最初の読み取りが行われるため、最初の変更時にはすでに正しい以前の値が反映されているのです。

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

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

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

変数 値
resourceType PRODUCTVARIANT
resourceId 商品バリエーションのIDです。例:gid://shopify/ProductVariant/1234567890
metafieldKey 名前空間とキー。ここでは custom.bin_location です
metafield.value 新たな価値
metafield.previousValue 変更前の値。メタフィールドが初めて設定された場合は空です。
metafield.type メタフィールドの型です。例えば、single_line_text_field などです。

「商品バリエーション Metafield Update」は、同じ変更に対する2つ目のトリガーです。これは「Metafield Update」に加えて実行され、親製品をネイティブなShopify Flow参照として引き継ぎます。両者は1つのイベントを共有しているため、両方を使用してもカウントは2回にはなりません。アプリの「トリガー」ページから有効にするか、これを使用するワークフローを有効にしてください。

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

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

例から始めましょう

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

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

  • 「HTTPリクエストの送信」機能を使用して、新しいビンロケーション情報を倉庫管理システムに送信してください。
  • ワークフローで親商品をタグ付けしたり更新したりする必要がある場合は、「商品バリエーションのメタフィールドの更新」を使用してください。
  • 複数のバリエーションメタフィールドを追跡し、メタフィールドごとに1つのワークフローを設定したい場合は、metafieldKey に条件を追加してください。

反応の速さ

Shopifyでは、バリエーションのメタフィールドが変更されても通知は送信されません。そのため、当アプリは1分間に1回程度の頻度でカタログを確認し、変更されたバリエーションのみを読み取ります。処理には数分程度かかりますが、大規模なカタログの場合、最初の確認にはさらに時間がかかることがあります。

知っておくと便利です

  • バリエーションのメタフィールドでは、「Product Metafield Update」はトリガーされません。このトリガーは、商品自体に設定されたメタフィールドを対象としています。

続きを読む