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

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

セットアップを行う

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

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

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

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

2. メタオブジェクトのタイプを選択する

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

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

「サイズ」ガイドが選択されている「メタオブジェクト・タイプの選択」ダイアログ — 監視するタイプを選択してください。そのタイプのすべてのエントリがトリガーされ、その後作成されるエントリも同様にトリガーされます。

3. この型がウォッチ対象になりました

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

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

そのイベントが持つ意味

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

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

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

許可

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

代表的な用途

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