> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/experience-components/ax-record-detail.md).

# AX - レコード詳細

Experience Cloud サイトのページで、カスタマイズ可能なレイアウトに Salesforce レコードのフィールドを表示し、どのフィールドを表示するかやスタイルを選択できます。

## 概要

**AX - レコード詳細** は、Experience Sites ページ上で Salesforce レコードのフィールドと詳細をカスタマイズ可能なレイアウトで表示する Experience Cloud コンポーネントです。

ポータルユーザーに、アカウント詳細、ケース情報、注文の詳細、標準オブジェクトまたはカスタムオブジェクトのデータなど、特定のレコードに関する詳細情報を表示するために使用します。どのフィールドを表示するか、そのレイアウトとスタイルを、Experience Builder でコードなしで設定できます。

アカウントの詳細ページ、ケースの詳細ビュー、注文情報の表示、またはポータルユーザーがカスタム形式で包括的なレコード情報を確認する必要があるあらゆる場所に最適です。

## はじめに

このシンプルなチュートリアルを使って、レコード詳細コンポーネントの基本を学び、ユースケースの作成を始めましょう。

{% @arcade/embed url="<https://app.arcade.software/share/F3WnyWtZCFNcb07r05cm>" flowId="F3WnyWtZCFNcb07r05cm" %}

## 設定

### **オブジェクト名**

表示する Salesforce オブジェクトを指定します（例：Account、Contact、Opportunity、Case）。これにより、コンポーネントが取得して表示するレコードの種類が決まります。

### **レコード ID**

表示したい特定のレコードの一意の識別子を指定します。これにより、コンポーネントが正しい情報を取得して表示できます。

#### 例

特定のアカウントに関するページにレコード詳細コンポーネントを追加したいとします。そのアカウントの詳細をページに表示するには（任意のアカウントではなく）、特別な Experience Cloud 式を使用する必要があります。これにより、コンポーネントはユーザーが現在表示しているアカウントの詳細を動的に表示します。

<figure><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-5a86dcc730ee07d0e00d7a60fd5f070691cfa7f4%2F2024-07-05_16-26-43.png?alt=media" alt=""><figcaption></figcaption></figure>

```
{!recordId}
```

### **レコードタイプ**

Record ID がない場合、たとえばレコードを作成するときに使用するレコードタイプを設定します。これにより、新しいレコードに適用される選択リスト値、既定値、ページレイアウトが決まります。

Record ID が設定されている場合、そのレコードにはすでに独自のレコードタイプがあります。コンポーネントはそのレコードタイプを使用し、この設定は無視されます。

### **編集モード**

編集可能なフィールドの表示方法を設定します。レコードを編集できるかどうかは制御しません。そのためには **読み取り専用** を使用します。

* **インライン** （既定）**:** フィールドはテキストとして値を表示します。フィールドの横に小さな鉛筆アイコンが表示され、それをクリックするとそのフィールドだけが入力欄に変わります。ユーザーが主にレコードを閲覧し、ときどき値を修正する場合に最適です。
* **入力：** 編集可能な各フィールドが、フォームのようにすぐ入力欄として表示されます。ユーザーが複数のフィールドを一度に入力または更新することが想定される場合に最適です。

### **読み取り専用**

Experience Cloud サイト上で、表示されているレコードデータをユーザーが直接編集できるかどうかを選択します。静的な情報表示にするにはこのオプションを有効にし、レコード詳細の更新を許可するには無効にします。既定ではオフです。

{% hint style="warning" %}
また、パネルには **読み取り専用（非推奨）** のトグルがそのすぐ上にもあります。これは既存のページを動作させ続けるためだけに残されており、新しいコンポーネントは **読み取り専用**.
{% endhint %}

### **レイアウト**

コンポーネントが表示するフィールドを決定する方法を選択します：

* **フル** （既定）**:** レコードに割り当てられた Salesforce のページレイアウトを使用します。Salesforce はページレイアウトをレコードタイプとプロファイルに基づいて割り当てるため、フィールドはその設定に自動的に従います。
* **コンパクト：** オブジェクトのコンパクトレイアウトを使用します。これはレコードの短い要約です。ハイライトパネルやサイドカラムに便利です。
* **カスタム：** ページレイアウトの代わりに、Custom Layout Builder で自分で作成したフィールドリストを使用します。フィールドとその順序を選択します。

カスタムレイアウトはページレイアウトを置き換えるため、既定ではページレイアウトの割り当てに従いません。配置した各フィールドは、レコードタイプに関係なく、そのオブジェクトのすべてのレコードに表示されます。カスタムレイアウトをレコードタイプ対応にするには、次を有効にしてください。 **レコードタイプのレイアウトフィールドのみを表示** を下で。

<figure><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-b1d72aa419418e01c109321639b810fbd9d67711%2FJuly%203%202024.gif?alt=media" alt=""><figcaption><p>カスタムレイアウトエディタ</p></figcaption></figure>

Custom Layout Builder では、各セクションにタイトルとヘルプテキストを付けることができます。セクションにカーソルを合わせてヘッダーアイコンを表示し、鉛筆アイコンでタイトルを編集するか、 **セクションのヘルプテキストを編集** （情報アイコン）を使って **ヘルプテキスト** フィールドを開きます。保存すると、サイト上でセクションタイトルの横にあるツールチップにヘルプテキストが表示されます。削除するには、フィールドを空のまま保存します。

この **元に戻す** および **やり直し** キャンバス上部のボタンで、ビルダーを開いてから行った変更を前後にたどれます。キーボードショートカットも使えます。Ctrl+Z（Mac では Cmd+Z）で元に戻し、Ctrl+Shift+Z（Cmd+Shift+Z）でやり直します。ただし、カーソルがセクションタイトル、ヘルプテキスト、またはフィールド検索ボックスにある場合は除きます。

ビルダーは次のタイトルのダイアログで開きます **カスタムレコード詳細レイアウトを作成**、 **カスタムレイアウトを編集** プロパティパネルのボタンから。 **元に戻す** および **やり直し** は、キャンバス左上にあるアイコンのみのボタンです。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FDLnlVCx6GXoE3phrmZoz%2Fexperience-ax-record-detail-custom-layout-builder.png?alt=media" alt="Custom Layout Builder showing a section help text field and the Undo and Redo buttons"><figcaption><p>Custom Layout Builder のセクションのヘルプテキストと元に戻す／やり直し</p></figcaption></figure>

### **レコードタイプのレイアウトフィールドのみを表示**

必要条件 **レイアウト** に設定 **カスタム**.

レコードのレコードタイプに割り当てられたページレイアウトにも表示されるフィールドに、カスタムレイアウトを制限します。配置したフィールドのうち、そのページレイアウトにないものは非表示になります。

これにより、1 つのカスタムレイアウトで複数のレコードタイプを扱えます。オブジェクトに必要なすべてのフィールドを配置しておけば、各レコードにはそのレコードタイプで使用されるものだけが表示されます。US のレコードタイプではページレイアウトに State があれば State が表示され、Canada のレコードタイプではページレイアウトに Province があれば Province が表示されます。

オフのままにすると、レコードタイプに関係なく、配置したすべてのフィールドが表示されます。

**相互に排他的なフィールドは同じ行に配置します。** フィールドが非表示になると、その行の残りのフィールドは空きを埋めるように上に詰まりますが、フィールドが別の行へ移動することはありません。したがって、レコードタイプごとの代替フィールド（US の State、Canada の Province）は 1 行の中で横並びに配置し、どのレコードタイプでも 1 行が完全に使われるようにします。別々の行に分けると、各レコードタイプで相手側のフィールドがある場所に空白が残ります。

覚えておくべきことが 2 つあります：

* Salesforce はページレイアウトをレコードタイプに基づいて割り当て **、およびプロファイルに基づいて**いるため、訪問者が見るフィールドはそのユーザーのプロファイルへの割り当てに従います。これは、管理者として Setup で見る内容とは異なる場合があります。
* レコードタイプがないレコードでは、コンポーネントはオブジェクトの既定のページレイアウトにフォールバックします。その場合に配置したすべてのフィールドを表示したいなら、この設定をオフにしてください。

### **密度**

最適な読みやすさのため、コンポーネント内の要素間の余白を制御します：

* **ゆったり** （既定）**:** ゆとりのある余白で、落ち着いて読める体験を提供します。
* **コンパクト：** より詰まった表示にするため、余白を狭くします。
* **自動：** 画面サイズと使用可能なスペースに基づいて余白を自動的に調整します。

### 追加設定

**API 名** は、コンポーネントを参照するために使用される一意の識別子です（3〜30 文字。英字、数字、アンダースコア、ダッシュを使用できます）。

**バリアント** コンポーネントの視覚スタイルを選択します — `ベース` はプレーンな背景、 `シャドウ付き` （既定）は色付きの背景です。

編集が有効な場合、 **保存ボタンのラベル** および **キャンセルボタンのラベル** レコードの保存ボタンとキャンセルボタンのテキストを設定します。既定値は **保存** および **キャンセル**.

**フィールドのレイアウト** レコードのフィールドを、コンポーネント内でレスポンシブに配置します。コンテナサイズごとの列数を設定します（超小型〜大）。構造化された表形式のレイアウトには複数列を、すっきりした縦方向の表示には 1 列を選択します。

## スタイル

{% tabs %}
{% tab title="サイズ" %}
コンポーネントの寸法を制御します。
{% endtab %}

{% tab title="マージン" %}
コンポーネントの外側の余白を制御します。
{% endtab %}

{% tab title="パディング" %}
コンポーネントの内側の余白を制御します。
{% endtab %}
{% endtabs %}

## ユースケース

### 例 1：アカウントのハイライトパネル

{% @arcade/embed url="<https://app.arcade.software/share/4kdHqm6vhNkcnPUq42E7>" flowId="4kdHqm6vhNkcnPUq42E7" %}

最も重要なアカウント情報をすっきり見やすいハイライトパネルで表示し、アカウントページにすぐに視覚的なインパクトを与えましょう。この設定では、主要フィールドを Account レコードから直接取得し、チームが必要とする場所に、コンパクトな形式で表示します。

***

#### **達成できること**

* **アカウントの確認を高速化：** レコード全体を開かなくても、主要なアカウント詳細がすぐに確認できます
* **一貫した表示：** 構造化されたハイライトパネルにより、すべてのアカウントページで統一された体験を提供します

***

#### **始める前に**

* **プロフィールカードコンポーネント：** 必要に応じて、ハイライトパネルの枠としてプロフィールカードコンポーネントをコンテナに使用します

***

**設定方法：**

{% stepper %}
{% step %}

#### **Account リストページにコンポーネントを追加する**

* Account リストページの Experience Builder に AX - Record Detail コンポーネントをドラッグします
  {% endstep %}

{% step %}

#### **データソースを設定する**

* オブジェクト名を `Account`
* Record ID を `{!Item.Id}`
* レイアウトを `コンパクト`
  {% endstep %}

{% step %}

#### **設定を確認する**

* ページをプレビューして、ハイライトパネルが正しいアカウントフィールドを表示していることを確認します
  {% endstep %}
  {% endstepper %}

***

**リンク**

***

### 例 2：ケースに親アカウントの詳細を表示する <a href="#id-4b86f04a-b256-490c-a0ee-834ee0a4e968" id="id-4b86f04a-b256-490c-a0ee-834ee0a4e968"></a>

{% @arcade/embed url="<https://app.arcade.software/share/vu4akvJvLUqRGJUTl8Bv>" flowId="vu4akvJvLUqRGJUTl8Bv" %}

ケース対応中のサービス担当者に、アカウントの即時コンテキストを提供し、タブを切り替えたり別の場所で情報を探したりすることなく、すべての顧客対応をパーソナライズできるようにします。

***

#### **達成できること**

* **Customer 360 ビュー：** 担当者は、ケース上で直接、関連するアカウント詳細を確認でき、一目で顧客全体のコンテキストを把握できます
* **ケース解決率の向上：** アカウント情報へのアクセスが速くなることで、担当者は背景情報を探すのではなく、問題解決に集中できます

***

#### **始める前に**

* **ケースオブジェクトページ：** Experience Builder で Case Object ページ、特に Case Detail ページを作成してあることを確認してください

***

#### **設定方法**

{% stepper %}
{% step %}

#### **Case Detail ページにコンポーネントを追加する**

* Case Detail ページの Experience Builder に AX - Record Detail コンポーネントをドラッグします
  {% endstep %}

{% step %}

#### **データソースを設定する**

* オブジェクト名を `Account`
* Record ID を `{!Item.AccountId}`
* レイアウトを `コンパクト`
  {% endstep %}

{% step %}

#### **設定を確認する**

* ページをプレビューして、親アカウントの詳細がケースレコード上で正しく表示されていることを確認します
  {% endstep %}
  {% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/experience-components/ax-record-detail.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
