対象ページオブジェクト

この その は、Avonni Dynamic Component の基本的な設定です。コンポーネントがやり取りする主な Salesforce オブジェクト（例： Account, Contact, 商談（Opportunity）, My_Custom_Object__c）を確立します。これは必須の データコンテキスト をコンポーネントの操作と表示に提供します。

Target Page Name の設定方法

Dynamic Component の Target Page Object は、次の2つの方法で定義または更新できます。

新しい Dynamic Component を作成する場合：

• Avonni Components アプリのホームページから「New」をクリックして Dynamic Component を作成すると、初期設定ダイアログに「Target Page Object".

• 」というラベルのオプション（多くの場合ドロップダウンリスト）が含まれます。コンポーネントの作成を確定する前に、このリストから目的の Salesforce オブジェクトを選択します。これにより、新しいコンポーネントの初期コンテキストが設定されます。

既存のコンポーネント（設定から）：

• Component Builder で Dynamic Component を開きます。

• をクリックして、 設定 アイコン（通常はビルダー左上にある歯車⚙️）。

• 表示される設定パネルで、 Target Page Object プロパティに貼り付けます。

• のドロップダウンリストから Salesforce オブジェクトを選択または変更します。

• 忘れずに 保存 ここで変更を加えた後に Dynamic Component を

Target Page Name が重要な理由

Target Object API Name を正しく設定すると、重要なデータアクセス機能が有効になります：

• を有効化 フィールドタブ: 一度設定すると、 フィールド （左パネル）のタブに、選択したオブジェクトの利用可能なすべてのフィールドが表示されます。これらのフィールドをキャンバスにドラッグ＆ドロップすると、自動的にデータバインドされたコンポーネントが作成されます。

• 現在のレコードデータを提供（レコードページ上）： これは Salesforce の レコードページに配置されたコンポーネントにとって極めて重要です。Target Page Name がレコードページのオブジェクトと一致している場合（例： Account に設定し、コンポーネントを取引先（Account）ページに配置）：

  • この $Component.record のグローバル変数が自動的に利用可能になり、 現在のレコード の全フィールドデータへ直接アクセスできます。例えば、次のようにしてレコード名を表示できます： にバインドされます）。ユーザーはこれらのフィールドを表示または編集できます。.

  

  • 現在のレコードの ID も、通常は これをバインドして や、リソースセレクターで @recordId オプションを選択することで容易に取得できます。

• 関連データ表示を簡素化： 主要オブジェクトを把握し、現在のレコード ID（ これをバインドして または @recordId経由）へ簡単にアクセスできることは、 関連する レコードの一覧（例：現在の取引先に関連するすべての取引先責任者を表示）を表示するためのクエリやフィルターを設定する上で不可欠です。

Target Page Name を使用するタイミング

• レコード詳細ページ： あなたは ほぼ常に レコードページ向けに明示的に設計されたコンポーネントを作成する際に Target Page Object を設定します。これは現在のレコードのデータにアクセスする主な方法だからです。

• 関連リスト／データの表示： ページで表示中の特定レコードに関連するデータを表示または操作する必要がある場合。

• コンテキスト型コンポーネント： 特定のレコードに合わせて動作や表示情報をコンテキスト化する必要があるコンポーネント。

• 主従関係： Dynamic Component 内でコンポーネント間に主従スタイルの関係（例：取引先リストが関連する取引先責任者リストを駆動）を作成する場合、ページ全体のレコードに対する Target Page Object が提供するコンテキストが出発点になり得ます

次のような場合は 不要 なこともあります

• スタンドアロンコンポーネント（レコードコンテキストなし）： コンポーネントが特定のレコードに完全に依存せず、レコードデータへ直接アクセスする必要がない場合（例：汎用計算機、静的な情報パネル、特定レコードに焦点を当てず組織全体のサマリーを表示するアプリページ上のコンポーネントなど）、Target Page Object を設定する必要はないかもしれません。このような場合は、通常 Avonni Query Data Source を使用して、ページのレコードコンテキストに依存せずに必要なデータを取得します。

• 他の手段で初期化された変数のみを使用する場合： コンポーネントに必要なすべてのレコードデータが、 入力変数 を介して明示的に渡される場合（例：コンポーネントがモーダルやパネルで起動され、入力としてレコード ID を受け取り、その後「On Load」アクションでローカルの Record Variable を埋める）、全体の Target Page Object を厳密に設定する必要はないかもしれませんが、 フィールドタブ を自動補完してレイアウト設計を容易にするのに役立つ場合があります。

要するに

Target Page Object は Dynamic Component に不可欠なデータコンテキストを提供し、主にどの Salesforce オブジェクトを扱うのか、そして何よりレコードページ上でどの特定レコードのデータを即座に利用できるようにすべきかを伝えます。