トリガーメタフィールドのトリガー

メタフィールドのトリガー

ページをコピーする

10種類の所有者タイプにおいて、メタフィールドの変更をトリガーとして、Shopify Flowワークフローを実行します。これには、タイプ別注文、商品、およびお客様のバリエーションが含まれます。

メタフィールドのトリガーは、10種類のオーナータイプのいずれかにおいて、特定のメタフィールドの定義が変更された際に発動します。監視対象のメタフィールドは、1つの定義ずつ選択するため、何百ものメタフィールドを持つストアであっても、ワークフローが関与するメタフィールドについてのみトリガーが発動することになります。

対応している所有者タイプ

商品、商品バリエーション、コレクション、お客様、注文、会社、会社のロケーション、ブログ、ブログ記事、およびページ。

セットアップする方法

このページの例では、「Rating」(custom.rating)という製品メタフィールドを監視しています。これは、レビューアプリが書き込むような値です。

1. メタフィールドを選択してください

  1. アプリのナビゲーションで「**メタフィールドトリガー」**を開いてください。
  2. [トリガーの追加] をクリックしてください。
  3. メタフィールドが属するリソースタイプ(例:Product)を選択してください。
  4. リストからメタフィールドの定義を選択してください(数が多ければ名前で検索してください)。その後、「**トリガーの追加」**をクリックしてください。

定義が設定されているメタフィールドのみが表示されます(Shopify admin、[設定]、[カスタムデータ])。このリストは1時間のみ保持されるため、先ほど作成した定義が表示されない場合があります。「トリガーの追加」の横にある「メタフィールドを更新」をクリックし、ダイアログを再度開いてください。

リソースタイプ「Product」およびメタフィールド「Rating」、「custom.rating」、「selected」が選択された「メタフィールドのトリガーを追加」ダイアログ
リソースの種類を選択し、次にメタフィールドの定義を選択してください。数が多くある場合は、検索機能をご利用いただくと便利です。

2. メタフィールドが監視対象になりました

このメタフィールドは、リストに「有効」として表示されます。他に有効にする設定はありません。ここに追加するだけで有効_になります_。**削除すると、**そのメタフィールドの監視が停止します。

このアプリはまず、既存レコード上のそのメタフィールドの現在の値を記録しますので、最初の編集時ですでに正しい以前の値が反映されます。

「メタフィールド・トリガー」の一覧に、製品のメタフィールド「Rating」および「custom.rating」が「有効」として表示されています。
監視対象のメタフィールド「Active」。「メタフィールドの更新」を実行すると、定義の一覧が再読み込みされます。

3. イベントが持つもの

それ以降、そのメタフィールドに対する編集が行われるたびに、Shopify Flow で Metafield Update イベントが発生します。このイベントには、名前空間とキー、該当するレコード、新しい値、および previousValue(そのメタフィールドの以前の値)が含まれます。メタフィールドが初めて設定された直後は、previousValue は空になります。

この例では、評価が4.5から2.5に下がりました。「値が3未満で、かつ以前の値が3以上である」というワークフロー条件は、その後の編集のたびにトリガーされるのではなく、評価が3を下回った瞬間に1回だけトリガーされます。手順の詳細はこちらをご覧ください:メタフィールドのトリガー、手順を追って。

イベント履歴内のイベント:製品のメタフィールド更新、値 2.5、以前の値 4.5
1つのイベントが開かれました:現在の評価は2.5ですが、previousValueによると、以前は4.5だったとのことです。

ジェネリックなトリガーと型付きトリガー

メタフィールドの変更を反映するには、2つの方法があります:

トリガー 表紙 提供します
メタフィールドの更新 10種類の所有者タイプすべて 名前空間、キー、所有者ID、旧値および新値
メタフィールドの更新順序 注文のみ 上記に加え、ネイティブのShopify Flow参照としての順序も含まれます
製品のメタフィールドの更新 商品のみ 上記に加え、ネイティブ参照としての製品も含まれます
お客様メタフィールドの更新 お客様限定 上記に加え、お客様をネイティブレファレンスとして指定します
商品バリエーションのメタフィールドの更新 商品バリエーションのみ 上記に加え、親製品をネイティブレファレンスとして指定します

ワークフローでリソース自体に対して処理を行う必要がある場合(たとえば、注文にタグを付けたり、そのラインアイテムを読み取ったりする場合など)は、型指定トリガーを使用してください。ネイティブ参照により、Flowはルックアップステップを経ることなく、そのリソースに対して独自のShopifyアクションを直接使用できるようになります。

値が変更されたことを単に把握したい場合や、型指定されたバリエーションを持たないオーナー型を監視している場合は、汎用トリガーをご利用ください。

各タイプ別のトリガーには、「トリガー」ページにそれぞれ独自のスイッチがあり(そのトリガーを使用するShopify Flowワークフローを有効にすると、そのトリガーも有効になります)、汎用トリガー_に加えて_発動します。これらは1つのイベントを共有しているため、両方を有効にしても、上限の消費が二重にカウントされることはありません。