Salesforceで関連する情報を1画面に集める専用部品の作り方

こんなことで困っていませんか

• 関連する商談やケースを見るたびに、関連リストから別の画面を開いている。[2]
• 親の取引先の項目を確かめるために、参照先のレコードへ移動している。[2]
• 見たい情報が複数のオブジェクトにまたがり、標準の部品の組み合わせでは思う形に並ばない。[2][7]
• 部品を足していった結果、ページの表示に時間がかかるようになった。[11]

なぜ起きるのか

Lightning レコードページは、Lightning アプリケーションビルダーで部品（コンポーネント）を並べて作ります。初めて [編集ページ] を選ぶと標準レコードページのコピーが作られ、それを編集します。[1][12]

標準の [関連リスト – 1 つ] は、1 つの関連リストを出す部品です。[基本リスト] では最初の 4 項目、[拡張リスト] では最大 10 項目までを表示します。[2]

[動的関連リスト – 1 つ] を使うと、表示する項目や並び順、絞り込みをアプリケーションビルダーで決められます。ただし結果は 2,000 レコードで切り捨てられ、使えるのはレコードページだけです。[2][3]

LWC は、作っただけではアプリケーションビルダーに出てきません。設定ファイル（js-meta.xml）で、置けるページの種類や対象のオブジェクトを指定する必要があります。[4][5]

直し方の選択肢

開発者ガイドでは、データの扱い方に順序が示されています。標準の部品（ベースコンポーネント）、Lightning Data Service のワイヤーアダプター、それでも足りないときに Apex、という順です。[7]

• 方法 1標準の部品を組み合わせる[関連リスト – 1 つ]、[動的関連リスト – 1 つ]、[関連レコード]、[タブ] を並べます。コードを書かずに組み立てられます。[2][3]
• 方法 2LWC とベースコンポーネントlightning-record-view-form を使うと、指定した項目をラベル付きの参照専用で表示できます。[17][7]
• 方法 3LWC と GraphQL ワイヤーアダプター親子関係のあるレコードや、複数のオブジェクトのデータを Apex なしで取得できます。[7]
• 方法 4LWC と Apex条件で絞った一覧の読み込みや、複数のレコードを 1 つのトランザクションで扱う処理には Apex を使います。[7]

作業の流れ

1. Sandbox で、[設定] の [クイック検索] に「アプリケーションビルダー」と入力し、[Lightning アプリケーションビルダー] を開きます。標準の部品で足りる分は、ここで並べます。[12][16]
2. LWC を作り、JavaScript で @api recordId を宣言します。レコードページに置くと、表示中のレコードの ID が入ります。[6]
3. データの取得は Lightning Data Service を優先します。Apex を使う場合は、クラスごとに共有の扱い（with sharing など）を宣言します。[7][8][9]
4. js-meta.xml で isExposed を true にし、target に lightning__RecordPage を指定します。対象のオブジェクトもここで絞れます。[5]
5. Apex を含む場合はテストクラスを書き、コードの 75% 以上をカバーしてテストが通ることを確かめます。そのうえで、送信変更セットで本番組織へ送ります。[10][16]
6. 本番で部品をページに置いて保存し、[有効化] を押します。組織のデフォルト、アプリケーション、レコードタイプとプロファイルの組み合わせから割り当て方を選びます。[12][13]

気をつけること

• 部品を増やすと、ページの読み込みが遅くなることがあります。アプリケーションビルダーの [分析] で性能を確かめ、使う頻度の低い部品はデフォルト以外のタブやアコーディオンに移す方法が案内されています。[11]
• 電話で表示するページは、表示する部品を 8 個までにすることが勧められています。[11]
• Lightning Data Service が使う UI API は、オブジェクトの権限、項目レベルセキュリティ、共有設定に沿って表示します。2026年10月時点の開発者ガイドでは、API バージョン 67.0 以降の Apex は既定でユーザーモードで動くと説明されています。[8][9]
• Apex で取ったデータは、Lightning Data Service のキャッシュと共有されません。同じ画面で両方を使うと、表示が食い違うことがあります。[7]
• タブやアコーディオンのように、ほかの部品を入れる器として作ったカスタムコンポーネントは、アプリケーションビルダーではサポートされていません。[4]
• 表示ルールを使うと、条件に合うときだけ部品を表示できます。カスタムコンポーネントにも、追加の作業なしで同じように使えます。[15][14]