メタフィールドのトリガー
10種類の所有者タイプにおいて、メタフィールドの変更をトリガーとして、Shopify Flowワークフローを実行します。これには、タイプ別注文、商品、およびお客様のバリエーションが含まれます。
メタフィールドのトリガーは、10種類のオーナータイプのいずれかにおいて、特定のメタフィールドの定義が変更された際に発動します。監視対象のメタフィールドは、1つの定義ずつ選択するため、何百ものメタフィールドを持つストアであっても、ワークフローが関与するメタフィールドについてのみトリガーが発動することになります。
対応している所有者タイプ
商品、商品バリエーション、コレクション、お客様、注文、会社、会社のロケーション、ブログ、ブログ記事、およびページ。
セットアップする方法
このページの例では、「Rating」(custom.rating)という製品メタフィールドを監視しています。これは、レビューアプリが書き込むような値です。
1. メタフィールドを選択してください
- アプリのナビゲーションで「**メタフィールドトリガー」**を開いてください。
- [トリガーの追加] をクリックしてください。
- メタフィールドが属するリソースタイプ(例:Product)を選択してください。
- リストからメタフィールドの定義を選択してください(数が多ければ名前で検索してください)。その後、「**トリガーの追加」**をクリックしてください。
定義が設定されているメタフィールドのみが表示されます(Shopify admin、[設定]、[カスタムデータ])。このリストは1時間のみ保持されるため、先ほど作成した定義が表示されない場合があります。「トリガーの追加」の横にある「メタフィールドを更新」をクリックし、ダイアログを再度開いてください。

2. メタフィールドが監視対象になりました
このメタフィールドは、リストに「有効」として表示されます。他に有効にする設定はありません。ここに追加するだけで有効_になります_。**削除すると、**そのメタフィールドの監視が停止します。
このアプリはまず、既存レコード上のそのメタフィールドの現在の値を記録しますので、最初の編集時ですでに正しい以前の値が反映されます。

3. イベントが持つもの
それ以降、そのメタフィールドに対する編集が行われるたびに、Shopify Flow で Metafield Update イベントが発生します。このイベントには、名前空間とキー、該当するレコード、新しい値、および previousValue(そのメタフィールドの以前の値)が含まれます。メタフィールドが初めて設定された直後は、previousValue は空になります。
この例では、評価が4.5から2.5に下がりました。「値が3未満で、かつ以前の値が3以上である」というワークフロー条件は、その後の編集のたびにトリガーされるのではなく、評価が3を下回った瞬間に1回だけトリガーされます。手順の詳細はこちらをご覧ください:メタフィールドのトリガー、手順を追って。

ジェネリックなトリガーと型付きトリガー
メタフィールドの変更を反映するには、2つの方法があります:
| トリガー | 表紙 | 提供します |
|---|---|---|
| メタフィールドの更新 | 10種類の所有者タイプすべて | 名前空間、キー、所有者ID、旧値および新値 |
| メタフィールドの更新順序 | 注文のみ | 上記に加え、ネイティブのShopify Flow参照としての順序も含まれます |
| 製品のメタフィールドの更新 | 商品のみ | 上記に加え、ネイティブ参照としての製品も含まれます |
| お客様メタフィールドの更新 | お客様限定 | 上記に加え、お客様をネイティブレファレンスとして指定します |
| 商品バリエーションのメタフィールドの更新 | 商品バリエーションのみ | 上記に加え、親製品をネイティブレファレンスとして指定します |
ワークフローでリソース自体に対して処理を行う必要がある場合(たとえば、注文にタグを付けたり、そのラインアイテムを読み取ったりする場合など)は、型指定トリガーを使用してください。ネイティブ参照により、Flowはルックアップステップを経ることなく、そのリソースに対して独自のShopifyアクションを直接使用できるようになります。
値が変更されたことを単に把握したい場合や、型指定されたバリエーションを持たないオーナー型を監視している場合は、汎用トリガーをご利用ください。
各タイプ別のトリガーには、「トリガー」ページにそれぞれ独自のスイッチがあり(そのトリガーを使用するShopify Flowワークフローを有効にすると、そのトリガーも有効になります)、汎用トリガー_に加えて_発動します。これらは1つのイベントを共有しているため、両方を有効にしても、上限の消費が二重にカウントされることはありません。
ガイド
- 注文のメタフィールドが更新された際に、Shopify Flow を実行する
- 製品のメタフィールドが変更された際にShopify Flowをトリガーする
- 顧客のメタフィールドが更新された際に、Shopify Flow を実行する
- メタフィールドのトリガー、手順を追って - 5つのメタフィールド・トリガーそれぞれについて、具体例が示されています。
