メタオブジェクトのトリガー

ページをコピーする

メタオブジェクトのエントリが変更された際に、Shopify Flow を発火させます。これは、メタオブジェクトの定義ごとに設定されます。

メタオブジェクトとは、サイズガイド、店舗検索、原材料リスト、お手入れ方法など、ご自身でモデル化したあらゆるカスタム構造のレコードのことです。これらのエントリのいずれかが変更されると、「メタオブジェクトのエントリ更新」トリガーが発動します。

セットアップする方法

このページの例では、「Size guide」というメタオブジェクトを監視しており、そのエントリは「linen-shirts」の1つです。

1. メタオブジェクトのトリガーを開く

アプリのナビゲーションから「**メタオブジェクトのトリガー」**を開いてください。タイプを追加するまでは、ページは空の状態です。

「メタオブジェクトのトリガー」ページには、定義が監視される前に、「トリガーの追加」ボタンが表示されます。 — 「メタオブジェクト・トリガー」ページは、何かが再生される前に表示されます。

2. メタオブジェクトのタイプを選択してください

「トリガーの追加」をクリックし、監視したいメタオブジェクトのタイプを選択してから、ダイアログ内の**「トリガーの追加」**をクリックしてください。監視対象となるのは個々のエントリではなく、タイプ全体です。そのため、そのタイプのすべてのエントリ（後で作成するエントリも含む）に対してトリガーが発動します。

先ほど作成したタイプがダイアログに表示されない場合がありますが、これはリストの内容がしばらく間保持されるためです。「**メタオブジェクトを更新」**をクリックし、ダイアログを再度開いてください。

「メタオブジェクトタイプの選択」ダイアログで、「サイズ」ガイドが選択されている状態 — 表示したいタイプを選択してください。そのタイプのすべてのエントリが実行されます。また、その後作成されたエントリも実行されます。

3. これで、その型が監視対象となりました

そのタイプはリストに「アクティブ」として表示されます。**削除すると、**そのタイプの監視が停止します。

「メタオブジェクトトリガー」リストで、タイプ「Size」のガイドが「Active」として表示されています — 監視対象のタイプは「アクティブ」です。削除すると、その監視が解除されます。

あるイベントが持つもの

そのタイプのエントリを編集すると、Shopify Flow で「**メタオブジェクト entry updated」**がトリガーされます。Shopify Flow には、条件として metaobjectHandle が渡され、エントリ自体は metaobject として渡されます。これには、現在のエントリのタイプ、表示名、およびフィールドが含まれます。メタオブジェクトのフィールドには、以前の値は存在しません。アプリのイベント履歴には、エントリの ID、タイプ、およびハンドルとともに、同じイベントが一覧表示されます。

このハンドルは、重要なエントリが1つだけの場合（metaobjectHandle が linen-shirts と等しい場合）に使用してください。手順は以下の通りです：メタオブジェクトのトリガー、手順を追って。

イベント履歴におけるイベント：タイプ「size_guide」のエントリ「linen-shirts」のメタオブジェクトエントリが更新されました — 「linen-shirts」というエントリを1回編集した後の、「イベント履歴」に記録されたイベントです。

許可

メタオブジェクトのトリガーには、メタオブジェクトデータアクセス（read_metaobjects）が必要です。これには、定義とエントリの両方へのアクセスが含まれます。「**権限」**ページでこの権限を付与してください。

代表的な用途

サイズガイドやお手入れ方法に変更があった場合は、コンテンツチームにご連絡ください。
変更された店舗検索レコードを外部システムと同期します。
構造化コンテンツレコードが編集された際に、検証ワークフローを再実行します。