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

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

ページをコピーする

10種類のオーナータイプにわたるメタフィールドの変更をトリガーとして、Shopify Flowのワークフローを実行します。これには、注文、商品、およびお客様のバリエーション(タイプ指定済み)が含まれます。

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

サポートしている所有者タイプ

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

セットアップする方法

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

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

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

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

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

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

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

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

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

3. イベントが持つもの

それ以降、そのメタフィールドに対するすべての編集操作により、Shopify Flow で**「Metafield Update」**イベントが発生します。このイベントには、名前空間とキー、該当するレコード、新しい値、および previousValue(メタフィールドの以前の値)が含まれます。メタフィールドが初めて設定された直後は、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参照としての順序も含まれます
製品のメタフィールドの更新 商品のみ 上記に加え、ネイティブ参照としての製品も含まれます
お客様メタフィールドの更新 お客様限定 上記に加え、お客様をネイティブレファレンスとして指定します
商品バリエーションのメタフィールドの更新 商品バリエーションのみ 上記に加え、親製品をネイティブレファレンスとして指定します

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

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

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