> 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-fr/experience-components/ax-record-detail.md).

# AX - Détail de l’enregistrement

## Vue d'ensemble

**AX - Détail de l'enregistrement** est un composant Experience Cloud qui affiche les champs et les détails des enregistrements Salesforce dans une mise en page personnalisable sur les pages des sites Experience.

Utilisez-le pour afficher aux utilisateurs du portail des informations détaillées sur des enregistrements spécifiques — comme les détails d’un compte, les informations d’un cas, les spécificités d’une commande ou les données d’un objet standard ou personnalisé. Configurez les champs affichés, leur disposition et leur style dans Experience Builder, sans code.

Idéal pour les pages de détail de compte, les vues détaillées de cas, les affichages d’informations de commande ou partout où les utilisateurs du portail ont besoin de voir des informations complètes sur l’enregistrement dans un format personnalisé.

## Prise en main

Utilisez ce tutoriel simple pour apprendre les bases du composant Détails de l’enregistrement et commencer à construire vos cas d’usage.

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

## Configuration

### **Nom de l'objet**

Spécifiez l'objet Salesforce que vous souhaitez afficher (par ex. Compte, Contact, Opportunité, Cas). Cela détermine le type d’enregistrement que le composant récupérera et présentera.

### **ID de l'enregistrement**

Fournissez l’identifiant unique de l’enregistrement spécifique que vous souhaitez afficher. Cela garantit que le composant récupère et affiche les bonnes informations.

#### Exemple

Imaginez que vous souhaitiez ajouter le composant Détail de l’enregistrement à une page consacrée à un compte spécifique. Pour afficher les détails de ce compte sur la page (au lieu d’un compte quelconque), vous devrez utiliser une expression spéciale d’Experience Cloud. Celle-ci indique au composant d’afficher dynamiquement les détails du compte que l’utilisateur consulte actuellement.

<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}
```

### **Type d'enregistrement**

Définit le type d’enregistrement à utiliser lorsque le composant n’a pas d’ID d’enregistrement, par exemple lorsque vous l’utilisez pour créer un enregistrement. Cela détermine les valeurs de liste de sélection, les valeurs par défaut et la mise en page appliquée au nouvel enregistrement.

Lorsqu’un ID d’enregistrement est défini, l’enregistrement possède déjà son propre type d’enregistrement. Le composant utilise celui-ci, et ce paramètre est ignoré.

### **Mode d'édition**

Définit la manière dont les champs modifiables sont présentés. Il ne contrôle pas si l’enregistrement peut être modifié — utilisez **Lecture seule** pour cela.

* **En ligne** (par défaut)**:** Les champs affichent leurs valeurs sous forme de texte. Une petite icône crayon apparaît à côté d’un champ, et un clic transforme ce champ en zone de saisie. Idéal lorsque les utilisateurs consultent surtout l’enregistrement et corrigent occasionnellement une valeur.
* **Saisie :** Chaque champ modifiable s’affiche immédiatement sous forme de zone de saisie, comme un formulaire. Idéal lorsque les utilisateurs doivent remplir ou mettre à jour plusieurs champs à la fois.

### **Lecture seule**

Choisissez si les utilisateurs peuvent modifier directement les données de l’enregistrement affiché sur votre site Experience Cloud. Activez cette option pour une vue statique et informative, ou désactivez-la pour permettre aux utilisateurs de mettre à jour les détails de l’enregistrement. Désactivé par défaut.

{% hint style="warning" %}
Le panneau comporte également un **Lecture seule (obsolète)** interrupteur juste au-dessus. Il est conservé uniquement pour que les pages existantes continuent de fonctionner — configurez les nouveaux composants avec **Lecture seule**.
{% endhint %}

### **Mise en page**

Choisissez comment le composant détermine les champs à afficher :

* **Pleine** (par défaut)**:** Utilise la mise en page Salesforce attribuée à l’enregistrement. Salesforce attribue les mises en page par type d’enregistrement et par profil, de sorte que les champs suivent automatiquement cette configuration.
* **Compact :** Utilise la mise en page compacte de l’objet, un bref résumé de l’enregistrement. Utile pour les panneaux de mise en évidence et les colonnes latérales.
* **Personnalisé :** Utilise une liste de champs que vous créez vous-même dans le générateur de mise en page personnalisée, au lieu de la mise en page de la page. Vous choisissez les champs et leur ordre.

Une mise en page personnalisée remplace la mise en page de la page, donc par défaut elle ne suit pas les attributions de mise en page. Chaque champ que vous placez apparaît sur chaque enregistrement de l’objet, quel que soit son type d’enregistrement. Pour rendre une mise en page personnalisée sensible au type d’enregistrement, activez **Afficher uniquement les champs de mise en page du type d'enregistrement** ci-dessous.

<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>Éditeur de mise en page personnalisée</p></figcaption></figure>

### **Afficher uniquement les champs de mise en page du type d'enregistrement**

Nécessite **Mise en page** défini sur **Personnalisé**.

Restreint une mise en page personnalisée aux champs qui apparaissent également sur la mise en page attribuée au type d’enregistrement de l’enregistrement. Les champs que vous avez placés et qui ne figurent pas sur cette mise en page sont masqués.

Cela permet à une seule mise en page personnalisée de servir plusieurs types d’enregistrement : placez tous les champs nécessaires à l’objet, et chaque enregistrement n’affiche que ceux utilisés par son type d’enregistrement. Un type d’enregistrement américain dont la mise en page comporte État affichera État ; un type d’enregistrement canadien dont la mise en page comporte Province affichera Province à la place.

Laissez cette option désactivée pour afficher tous les champs que vous avez placés, quel que soit le type d’enregistrement.

**Placez sur la même ligne les champs mutuellement exclusifs.** Lorsqu’un champ est masqué, les champs restants de cette ligne remontent pour combler l’espace, mais les champs ne se déplacent jamais d’une ligne à l’autre. Placez donc côte à côte sur une même ligne les alternatives propres à chaque type d’enregistrement — État pour les États-Unis, Province pour le Canada —, et chaque type d’enregistrement disposera d’une ligne complète. Répartis sur des lignes séparées, chaque type d’enregistrement laisse un espace vide à l’endroit où se trouverait le champ de l’autre.

Deux points à garder à l’esprit :

* Salesforce attribue les mises en page par type d’enregistrement **et par profil**, de sorte que les champs qu’un visiteur voit suivent l’attribution de son profil. Cela peut être différent de ce que vous voyez dans Configuration en tant qu’administrateur.
* Sur un enregistrement sans type d’enregistrement, le composant revient à la mise en page par défaut de l’objet. Désactivez ce paramètre si vous voulez que tous les champs placés s’affichent dans ce cas.

### **Densité**

Contrôlez l’espacement entre les éléments du composant pour une lisibilité optimale :

* **Confortable** (par défaut)**:** Offre un espacement généreux pour une expérience de lecture détendue.
* **Compact :** Utilise un espacement plus serré pour une vue plus condensée.
* **Auto :** Ajuste automatiquement l’espacement en fonction de la taille de l’écran et de l’espace disponible.

### Paramètres supplémentaires

**Nom API** est un identifiant unique utilisé pour référencer le composant (3 à 30 caractères ; lettres, chiffres, traits de soulignement et tirets).

**Variante** sélectionne le style visuel du composant — `Base` pour une surface unie, ou `Ombré` (par défaut) pour une surface teintée.

Lorsque la modification est activée, **Libellé du bouton Enregistrer** et **Libellé du bouton Annuler** définissent le texte des boutons Enregistrer et Annuler de l’enregistrement. Leur valeur par défaut est **Enregistrer** et **Annuler**.

**Mise en page des champs** organise de manière responsive les champs de l’enregistrement dans le composant — définissez le nombre de colonnes par taille de conteneur (de extra-petit à grand). Choisissez plusieurs colonnes pour une mise en page structurée de type tableau ou une seule colonne pour une présentation verticale simplifiée.

## Style

{% tabs %}
{% tab title="Taille" %}
Contrôle les dimensions du composant.
{% endtab %}

{% tab title="Marge" %}
Contrôle l’espacement extérieur autour du composant.
{% endtab %}

{% tab title="Remplissage" %}
Contrôle l’espacement intérieur du composant.
{% endtab %}
{% endtabs %}

## Cas d'utilisation

### Exemple 1 : Panneau de mise en évidence du compte

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

Donnez un impact visuel immédiat à vos pages de compte en mettant en avant les informations de compte les plus importantes dans un panneau de mise en évidence clair et facile à parcourir. Cette configuration extrait les champs clés directement de l’enregistrement Compte et les affiche dans un format compact, exactement là où votre équipe en a besoin.

***

#### **Ce que vous allez accomplir**

* **Analyse plus rapide des comptes :** Les détails clés du compte sont immédiatement visibles sans ouvrir l’enregistrement complet
* **Présentation cohérente :** Un panneau de mise en évidence structuré crée une expérience uniforme sur toutes les pages de compte

***

#### **Avant de commencer**

* **Composant carte de profil :** Utilisez éventuellement un composant carte de profil comme conteneur pour encadrer votre panneau de mise en évidence

***

**Comment le configurer :**

{% stepper %}
{% step %}

#### **Ajoutez le composant à votre page de liste de comptes**

* Faites glisser le composant AX - Détail de l’enregistrement dans Experience Builder sur la page de liste de comptes
  {% endstep %}

{% step %}

#### **Configurer la source de données**

* Définissez Nom de l'objet sur `Compte`
* Définissez ID de l'enregistrement sur `{!Item.Id}`
* Définissez Mise en page sur `Compact`
  {% endstep %}

{% step %}

#### **Vérifiez votre configuration**

* Prévisualisez la page pour vérifier que le panneau de mise en évidence affiche les bons champs du compte
  {% endstep %}
  {% endstepper %}

***

**Liens**

***

### Exemple 2 : Afficher les détails du compte parent sur un cas <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" %}

Offrez à vos agents du service client un contexte de compte immédiat lorsqu’ils traitent un cas, afin qu’ils puissent personnaliser chaque interaction client sans changer d’onglet ni chercher des informations ailleurs.

***

#### **Ce que vous allez accomplir**

* **Vue Client 360 :** Les agents voient directement sur le cas les détails pertinents du compte, pour disposer d’un contexte client complet en un coup d’œil
* **Taux de résolution des cas amélioré :** Un accès plus rapide aux informations du compte permet aux agents de se concentrer sur la résolution du problème plutôt que sur la recherche de détails contextuels

***

#### **Avant de commencer**

* **Pages de l'objet Cas :** Assurez-vous d’avoir créé des pages de l’objet Cas, en particulier la page de détail du cas, dans Experience Builder

***

#### **Comment le configurer**

{% stepper %}
{% step %}

#### **Ajoutez le composant à votre page de détail du cas**

* Faites glisser le composant AX - Détail de l’enregistrement dans Experience Builder sur la page de détail du cas
  {% endstep %}

{% step %}

#### **Configurer la source de données**

* Définissez Nom de l'objet sur `Compte`
* Définissez ID de l'enregistrement sur `{!Item.AccountId}`
* Définissez Mise en page sur `Compact`
  {% endstep %}

{% step %}

#### **Vérifiez votre configuration**

* Prévisualisez la page pour vérifier que les détails du compte parent s’affichent correctement sur l’enregistrement du cas
  {% 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-fr/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.
