対象ページオブジェクト

その ターゲットオブジェクトAPI名 は Avonni ダイナミックコンポーネントの基本設定です。コンポーネントが操作する主要な Salesforce オブジェクトを確立します(例: 取引先(Account), 取引先責任者(Contact), 商談(Opportunity), My_Custom_Object__c)。それはコンポーネントの操作と表示のための重要な データコンテキスト を提供します。

ターゲットページ名の設定方法

ダイナミックコンポーネントのターゲットページオブジェクトは、次の2つの方法で定義または更新できます:

新しいダイナミックコンポーネントを作成する場合:

  • Avonni Components アプリのホームページから「新規」をクリックしてダイナミックコンポーネントを作成すると、初期セットアップダイアログに「ターゲットページオブジェクト".

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

既存のコンポーネントの場合(設定経由):

  • コンポーネントビルダーでダイナミックコンポーネントを開きます。

  • 設定 」アイコン(通常はビルダーの左上にある歯車⚙️)をクリックします。

  • 表示される設定パネルで、 ターゲットページオブジェクト プロパティを探します。

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

  • 変更後は必ず 保存 を行ってダイナミックコンポーネントを保存してください。


なぜターゲットページ名が重要なのか?

ターゲットオブジェクトAPI名を正しく設定すると、重要なデータアクセス機能が利用可能になります:

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

  • 現在のレコードデータの提供(レコードページ上): これは Salesforce の レコードページに配置されたコンポーネントにとって重要です。ターゲットページ名がレコードページのオブジェクトと一致する場合(例:あなたがそれを 取引先(Account) に設定し、コンポーネントを取引先ページに配置した場合):

    • その $Component.record グローバル変数が自動的に利用可能になり、表示中の 現在のレコード のすべてのフィールドデータに直接アクセスできます。例えば、レコードの名前を表示するには $Component.record.Name.

    • を使用できます。 現在のレコードの ID も通常、 $Component.record.Id またはリソースセレクタで @recordId

  • オプションを選択することで簡単にアクセスできます。 関連データ表示を簡素化: 現在のレコードの ID も通常、 主要オブジェクトと現在のレコードの ID( またはリソースセレクタでまたは )に簡単にアクセスできることは、 関連


レコードのリストを表示するためのクエリやフィルタを設定する際に不可欠です(例:現在の取引先に関連するすべての取引先責任者を表示する場合)。

  • ターゲットページ名を使用するタイミング レコード詳細ページ: 通常、 レコードページ専用に設計されたコンポーネントを作成する際にはターゲットページオブジェクトを設定します。これは現在のレコードのデータにアクセスする主要な方法だからです。

  • 関連リスト/データの表示: ページ上で表示されている特定のレコードに関連するデータをコンポーネントが表示または操作する必要があるとき。

  • コンテキストに依存するコンポーネント: 動作や表示情報が特定のレコードにコンテキスト化される必要があるコンポーネント全般。

  • マスタ詳細の関係: ダイナミックコンポーネント内でマスタ・詳細スタイルの関係(例:取引先リストが関連する取引先責任者リストを駆動するなど)を作成する場合、ページ全体のレコードに対するターゲットページオブジェクトが提供するコンテキストが出発点になり得ます。


次の場合は 必要ない かもしれません

  • スタンドアロンのコンポーネント(レコードコンテキストなし): コンポーネントが特定のレコードにまったく依存せず、レコードデータに直接アクセスする必要がない場合(例:汎用の計算機、静的な情報パネル、または特定のレコードに焦点を当てない組織全体のサマリーを表示するアプリページ上のコンポーネント)、ターゲットページオブジェクトを設定する必要はないかもしれません。そのようなケースでは、ページレコードコンテキストに依存せずに必要なデータを取得するために Avonni クエリデータソースを使用することが一般的です。

  • 他の方法で初期化された変数のみを使用する場合: コンポーネントが必要とするすべてのレコードデータが、 入力変数 を介して明示的に渡される場合(例:コンポーネントがモーダルやパネルで起動され、レコード ID を入力として受け取り、それが「オンロード(On Load)」アクションを介してローカルのレコード変数を設定する場合)、必ずしも全体のターゲットページオブジェクトを設定する必要はありませんが、レイアウト設計を容易にするために フィールドタブ を補助的に埋めるのに役立つことがあります。


要するに、

コンポーネントがレコードページ上の特定のレコードデータに直接アクセスする必要がある場合は、ターゲットページオブジェクトを設定してください。これにより $Component.record 変数が利用可能になり、フィールドタブが自動的に埋まり、データ駆動型コンポーネントの構築が格段に容易になります。取引先、商談、その他のレコード詳細ページ用のコンポーネントを作成する場合は、通常そのページのオブジェクトタイプに合わせてこれを設定することをお勧めします。アプリページやホームページ上のスタンドアロンコンポーネントで特定のレコードコンテキストが不要な場合は、未設定のままにして Avonni クエリデータソースを使用して代わりにデータを取得することができます。

最終更新

役に立ちましたか?