> 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-gallery.md).

# AX - Galerie

## Aperçu

**AX - Gallery** est un composant Experience Cloud qui affiche des images et du contenu dans quatre styles de disposition sur les pages du site Experience : carrousel (diaporama), onglets (sections organisées), grille (multi-colonnes) ou galerie (présentation d’images).

Utilisez-le pour afficher des photos de produits, des portfolios de projets, des images d’études de cas, des collections de ressources ou tout autre contenu visuel que les utilisateurs du portail doivent parcourir. Configurez le style de disposition, la navigation et les sources d’images dans Experience Builder, sans code.

<figure><img src="https://3803934262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-78fd9148b4aaecf3a5c1b61a0bdf7f0664ad4347%2F2024-02-07_21-13-18%20(1).gif?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Voyez-le dans un projet réel**

[Catalogue de cours d’automne](https://docs.avonnicomponents.com/projects/use-cases/portals-and-partner-sites/fall-course-catalog): Un catalogue de cours sur un portail, six photos avec le prix et les places restantes.
{% endhint %}

## Premiers pas

Utilisez ce tutoriel simple pour apprendre les bases du composant Galerie et commencer à créer vos cas d’usage.

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

## Configuration

### Source de données

Le **Source de données** est l’endroit où vous définissez le contenu de votre galerie. AX - Gallery prend en charge deux types de sources de données : **Manuel** et **Requête**.

<figure><img src="https://3803934262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-ed6a00bc166f7e8986aa8696895a09bfd59eb62a%2F2024-02-07_21-14-11.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

| Type de source de données | Description                                                                                                                                                                                                                | Quand l’utiliser                                                                                                                                                      |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Manuel**                | Téléchargez ou saisissez chaque élément de galerie directement dans le composant. Chaque image ajoutée via le sélecteur Source des médias crée un **nouveau** fichier dans votre bibliothèque Salesforce Files.            | Galeries ponctuelles avec du contenu statique qui change rarement (héros de page d’accueil, vitrine de produit fixe, démonstrations).                                 |
| **Requête**               | Récupérez des éléments dynamiquement à partir d’un objet Salesforce (Product, Knowledge, ContentVersion, objet personnalisé…). La galerie se met à jour automatiquement lorsque les enregistrements sous-jacents changent. | Tout contenu qui doit rester synchronisé avec les données Salesforce, tourner régulièrement ou être géré par une équipe non technique en dehors d’Experience Builder. |

{% hint style="info" %}

#### **Choisir entre Manuel et Requête**

Le mode Manuel crée un **tout nouveau fichier** dans la bibliothèque à chaque fois que vous téléchargez une image. Il ne fait pas référence aux fichiers qui existent déjà dans Salesforce Files. Si vous devez réutiliser ou mettre à jour le contenu de votre galerie sans rouvrir le panneau des propriétés, utilisez **Requête** le mode Requête à la place.
{% endhint %}

#### Partage du modèle avec Avonni AX - Gallery

**Respect des règles de partage des données Salesforce :**

* **Respect des paramètres de l’organisation :** Les composants Avonni respectent pleinement les configurations de partage des données et les paramètres d’accès existants de votre organisation Salesforce.
* **Politique de non-interférence :** Ces composants ne modifient ni n’affectent en aucune façon vos règles de partage de données préétablies.
* **Visibilité et accès contrôlés :** La possibilité de consulter et d’interagir avec les enregistrements via les composants Avonni est régie par les paramètres de partage et les autorisations utilisateur définis par votre organisation

### Utiliser des fichiers Salesforce existants comme source des médias

Le **Source des médias** champ dans AX - Gallery est flexible quant à la source que vous lui fournissez. Vous pouvez le mapper à une URL, à un ContentDocumentId ou à un chemin de téléchargement complet de Salesforce Files. Le composant détecte automatiquement les ContentDocumentId et les résout vers l’URL d’aperçu correcte au moment du rendu.

C’est ainsi que vous maintenez une galerie pointant vers des fichiers dans la **bibliothèque Salesforce Files** sans jamais les retélécharger via le composant.

| Ce que vous mettez dans Source des médias                                                                       | Ce que la galerie affiche                                                                                             |
| --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| Un champ contenant un **ContentDocumentId** (commençant par `069…`)                                             | La dernière version du fichier est résolue et affichée. Le composant détecte automatiquement les `069…` identifiants. |
| Le champ standard **VersionDataURL** lors de l’interrogation de `ContentVersion`                                | Le fichier est téléchargé et affiché. Recommandé lorsque votre objet source est ContentVersion.                       |
| Un **URL Shepherd** construite avec une expression comme `/sfc/servlet.shepherd/version/download/{{Record.Id}}` | La version exacte référencée dans l’URL est affichée. Utile pour la construction d’URL personnalisées.                |
| Un **URL publique** (image externe hébergée ailleurs)                                                           | L’image est chargée depuis la source externe.                                                                         |

#### **Comment le configurer en mode Requête**

1. Dans le **Source de données**, sélectionnez **Requête** et choisissez votre objet source (`ContentVersion`, un objet personnalisé contenant des références de fichiers, ou tout objet avec un champ image).
2. Appliquez un filtre qui identifie quels enregistrements doivent apparaître (par convention de titre, étiquette, champ personnalisé, valeur de liste de sélection, etc.).
3. Dans **Mappages des données**, mappez **Source des médias** selon votre objet source :
   * **Lors d’une requête sur ContentVersion :** mappez Source des médias au `champ Version Data URL` .
   * **Lors d’une requête sur un objet personnalisé avec un champ ContentDocumentId :** mappez directement Source des médias à ce champ (le composant détecte automatiquement les `069…` identifiants et les résout).
   * **Lors d’une requête sur n’importe quel objet avec un champ d’URL d’image complet :** mappez directement Source des médias à ce champ.

Une fois configuré, mettre à jour le contenu de votre galerie se résume simplement à remplacer les fichiers dans la bibliothèque Salesforce Files ou à mettre à jour le champ de référence sur vos enregistrements.

{% hint style="info" %}

#### Aperçu d’Experience Builder

Les images pointant vers Salesforce Files peuvent ne pas s’afficher dans l’aperçu d’Experience Builder, car le générateur ne s’authentifie pas en tant qu’utilisateur du portail. Elles s’afficheront correctement une fois connecté au site publié en tant qu’utilisateur de la communauté
{% endhint %}

### Propriétés

**Nom de l’API** attribue au composant un identifiant unique utilisé pour le référencer (3 à 30 caractères ; lettres, chiffres, tirets bas et tirets).

**Légende**, **Titre** et **Contenu** sont les textes au niveau du composant affichés une seule fois au-dessus des éléments — une courte légende, le titre et le texte du corps en dessous. Chacun possède son propre réglage de style de texte à côté — **Style du texte de la légende**, **Style du texte du titre** et **Style du texte du contenu** — offrant `Titre 1` à `Titre 4` et `Paragraphe 1` / `Paragraphe 2`.

**Position du média** place le média de chaque élément par rapport à ce contenu : `En haut à gauche`, `En haut au centre` (par défaut), `En haut à droite`, `Gauche`, `Droite`, `En bas à gauche`, `En bas au centre` ou `En bas à droite`.

**Nombre de colonnes** définit combien d’éléments sont affichés côte à côte — dans la `Carrousel` variante, combien tiennent sur un seul panneau. La valeur par défaut est 1.

**Message en l’absence de résultats** remplace l’état vide par défaut par votre propre texte lorsque la source de données ne renvoie aucun élément, et **Attributs du message en l’absence de résultats** contrôle ce que cet état vide affiche — **Masquer l’image en cas d’absence de résultats** masque l’illustration, **Masquer le message en cas d’absence de résultats** supprime le texte. Les deux sont désactivés par défaut.

### Carrousel

**Carrousel** contient les paramètres de la `Carrousel` variante :

* **Variante de l’indicateur**: l’apparence des indicateurs de progression, `Base` (la valeur par défaut) ou `Ombré`.
* **Masquer l’indicateur**: masque l’indicateur de progression.
* **Masquer la navigation**: masque les flèches gauche et droite.
* **Est infini**: revient au premier élément après le dernier.
* **Désactiver le rafraîchissement automatique**: arrête la boucle du carrousel après la dernière image.
* **Désactiver le défilement automatique**: arrête le défilement automatique, afin que les utilisateurs parcourent les éléments avec les indicateurs.
* **Durée de défilement**: la durée d’affichage de chaque image avant la suivante, 5 secondes par défaut.

### Variante

**Variante** choisit la disposition dans laquelle les éléments sont rendus : `Carrousel` (par défaut), `Onglets`, `Grille` ou `Galerie`. Chaque variante affiche les mêmes champs par élément — **Titre**, **Description** et **Source des médias** — et exécute l’interaction de l’élément **Lien vers** lorsqu’il est cliqué.

#### **Carrousel**

Les éléments sont affichés un panneau à la fois, comme un diaporama. **Nombre de colonnes** définit combien d’éléments partagent un panneau dans un conteneur large ; dans un conteneur étroit, chaque panneau contient un seul élément.

<figure><img src="https://3803934262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-52d1c70cb5a9a01aa278e12e19ec733f9eb218c9%2F2024-02-07_21-17-09.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

Le panneau avance automatiquement toutes les **Durée de défilement** (5 secondes par défaut) sauf si **Désactiver le défilement automatique** est activé, et **Est infini** reboucle du dernier panneau au premier. Sous les panneaux se trouvent les indicateurs de progression, et les flèches précédent/suivant sont de chaque côté ; **Masquer l’indicateur** et **Masquer la navigation** les suppriment. Tous ces paramètres se règlent dans la **Carrousel** section.

#### **Onglets**

Chaque élément devient un onglet, libellé avec le **Titre** titre de l’élément **Description**. En sélectionnant un onglet, on affiche le média de cet élément, placé selon **Position du média**; seul l’élément sélectionné est affiché à la fois.

<figure><img src="https://3803934262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-da7af562b2ec8870f5d77aac546950f983de801f%2F2024-02-07_21-18-03.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

**Position du média** définit aussi la direction de la barre d’onglets : `Gauche` ou `Droite` empile les onglets verticalement à côté du média, avec le **Légende**, **Titre** et **Contenu** niveau composant à côté d’eux ; toutes les autres positions disposent les onglets horizontalement, avec ces trois textes au-dessus d’eux.

#### **Grille**

Les éléments sont disposés en rangées de cellules de largeur égale, **Nombre de colonnes** par ligne, en remplissant chaque rangée de gauche à droite avant de passer à la suivante. Chaque élément est affiché en même temps ; rien n’est masqué derrière la navigation.

#### **Galerie**

Les éléments sont répartis sur **Nombre de colonnes** colonnes, chaque colonne empilant ses éléments verticalement, de sorte que les éléments de hauteurs différentes s’alignent contre celui du dessus au lieu de s’aligner en rangées. Comme avec **Grille**la grille

## Interactions

La section « Lien vers » détermine ce qui se passe lorsqu’un utilisateur clique sur un élément de votre galerie Avonni. Utilisez-la pour diriger les utilisateurs vers des pages détaillées, ouvrir du nouveau contenu ou déclencher d’autres actions.

**Exemple :**

* Par exemple, présentez des maisons en vedette dans une galerie et permettez aux utilisateurs de cliquer sur chaque image pour voir plus de détails sur une page séparée.

## Style

Les attributs de style vous permettent de contrôler l’apparence visuelle de chaque élément de la galerie. Les paramètres sont regroupés selon ce qu’ils affectent.

<figure><img src="https://3803934262-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-183fc0740d29bd4d169d916e324ae5fd28c93136%2F2024-02-07_21-18-53.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

{% tabs %}
{% tab title="Général" %}
S’applique à toutes les variantes.

| Paramètre                  | Ce qu’il contrôle                                                                                                                                     |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Taille**                 | Largeur, hauteur et débordement du composant.                                                                                                         |
| **Bordure**                | Couleur, taille, style et rayon de la bordure autour du composant.                                                                                    |
| **Marge**                  | Espacement extérieur autour du composant.                                                                                                             |
| **Marges internes**        | Espacement intérieur du composant.                                                                                                                    |
| **Légende**                | Couleur, police et limitation du nombre de lignes du niveau composant **Légende**.                                                                    |
| **Titre**                  | Couleur, police, alignement horizontal et limitation du nombre de lignes du niveau composant **Titre**.                                               |
| **Contenu**                | Couleur, police et alignement horizontal du niveau composant **Contenu**.                                                                             |
| **Média**                  | **Ajustement de l’objet** — comment l’image ou la vidéo de chaque élément remplit sa boîte.                                                           |
| **Boîte de dialogue Flow** | **En-tête de la boîte de dialogue Flow** et **Pied de page de la boîte de dialogue Flow** d’une boîte de dialogue Flow ouverte à partir d’un élément. |
| {% endtab %}               |                                                                                                                                                       |

{% tab title="Éléments" %}
S’applique aux **Carrousel**, **Grille** et **Galerie** variantes — dans la **Onglets** variante, les éléments sont des onglets, stylés sous **Onglets**.

| Paramètre                                          | Ce qu’il contrôle                                                                                               |
| -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Élément Galerie/Grille/Carrousel**               | Couleur d’arrière-plan, bordure (couleur, taille, style, rayon) et rayon de la bordure du contenu d’un élément. |
| **Titre d’élément Galerie/Grille/Carrousel**       | Couleur, police et limitation du nombre de lignes du titre de chaque élément.                                   |
| **Description d’élément Galerie/Grille/Carrousel** | Couleur et police de la description de chaque élément.                                                          |
| **Image Galerie/Grille/Carrousel**                 | Couleur d’arrière-plan, hauteur et rayon du média de chaque élément.                                            |
| {% endtab %}                                       |                                                                                                                 |

{% tab title="Carrousel" %}
Ne s’applique que lorsque **Variante** est défini sur `Carrousel`.

| Paramètre                             | Ce qu’il contrôle                                                                                              |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| **Indicateur actif du carrousel**     | Arrière-plan et bordure de l’indicateur du panneau visible, y compris sa **Ombré** variante.                   |
| **Indicateur inactif du carrousel**   | Les mêmes réglages pour les indicateurs des autres panneaux.                                                   |
| **Bouton de navigation du carrousel** | Arrière-plan, icône et bordure des boutons précédent/suivant, dans leurs états normal, au survol et désactivé. |
| {% endtab %}                          |                                                                                                                |

{% tab title="Onglets" %}
Ne s’applique que lorsque **Variante** est défini sur `Onglets`.

| Paramètre                                | Ce qu’il contrôle                                                                                                                       |
| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Onglet**                               | Alignement vertical, largeur, hauteur, hauteur de ligne et espacement gauche/droite de chaque onglet.                                   |
| **Bordure de l’onglet**                  | Taille et couleur de la bordure autour de chaque onglet.                                                                                |
| **Bordure active/en survol de l’onglet** | Les mêmes deux réglages pour l’onglet actif et l’état de survol.                                                                        |
| **Arrière-plan de l’onglet**             | Couleur d’arrière-plan de l’onglet actif et de l’état de survol.                                                                        |
| **Libellé de l’onglet**                  | Couleur, police et ombre du texte des libellés d’onglet (des **Titre**éléments), chacun avec une valeur active et une valeur au survol. |
| **Sous-titre de l’onglet**               | Les mêmes réglages pour les sous-titres d’onglet (des **Description**).                                                                 |
| {% endtab %}                             |                                                                                                                                         |
| {% endtabs %}                            |                                                                                                                                         |

## Dépannage

| Problème                                                                                                     | Cause                                                                                                                                                                                                                    | Correctif                                                                                                                                                                                                                                                                                |
| ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Les images ne s’aperçoivent pas dans Experience Builder mais s’affichent correctement sur le site publié** | Experience Builder ne s’authentifie pas en tant qu’utilisateur du portail, il ne peut donc pas récupérer les images depuis Salesforce Files pendant l’aperçu.                                                            | Comportement attendu. Connectez-vous au site publié en tant qu’utilisateur de la communauté pour vérifier que les images s’affichent correctement.                                                                                                                                       |
| **"Aucun aperçu disponible" apparaît en mode Manuel**                                                        | L’image téléchargée n’a pas été marquée comme lien public, donc les utilisateurs du portail ne peuvent pas la charger.                                                                                                   | Téléchargez à nouveau l’image et cochez **Lien public** au moment de l’envoi, ou passez au mode Requête, où les règles de partage standard s’appliquent.                                                                                                                                 |
| **Le mode Manuel vous oblige à retélécharger à chaque fois que vous voulez modifier une image**              | Le mode Manuel est un téléverseur direct — il ne référence pas les fichiers Salesforce Files existants.                                                                                                                  | Utilisez **Requête** le mode avec ContentVersion ou un objet personnalisé contenant des références de fichiers. Voir *Utiliser des fichiers Salesforce existants comme source des médias* ci-dessus.                                                                                     |
| **La galerie est vide pour les utilisateurs du portail mais fonctionne dans l’aperçu d’Experience Builder**  | Le profil de l’utilisateur du portail n’a pas accès à l’objet interrogé ou aux fichiers référencés.                                                                                                                      | Vérifiez les autorisations d’objet du profil, la sécurité au niveau des champs et l’accès à la bibliothèque/au partage sur `ContentVersion` ou l’objet source.                                                                                                                           |
| **Les images ne s’affichent pas du tout (ni dans l’aperçu ni sur le site publié)**                           | Source des médias est mappée à un champ qui ne contient pas de référence de fichier valide (ContentDocumentId commençant par `069…`, la `champ Version Data URL` champ sur ContentVersion, ou une URL d’image publique). | Vérifiez ce que contient réellement le champ mappé. Lorsque vous interrogez ContentVersion, utilisez le `champ Version Data URL` champ standard. Pour les objets personnalisés, stockez un ContentDocumentId (commençant par `069…`) et mappez directement Source des médias à ce champ. |
| **La galerie affiche les bons titres mais toutes les images sont cassées**                                   | Source des médias est mappée à un champ qui ne contient ni ContentDocumentId ni URL valide.                                                                                                                              | Dans les mappages de données, vérifiez que Source des médias pointe vers un champ ContentDocumentId, une URL shepherd ou une URL d’image publique valide.                                                                                                                                |

## Cas d'utilisation

### Exemple 1 : Carrousel des actualités clients

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

Tenez vos clients informés et engagés en présentant vos derniers articles directement sur la page d’accueil de votre Experience Cloud. Le composant AX Gallery facilite l’affichage d’un carrousel d’actualités dynamique et riche en images qui se met à jour automatiquement à mesure que de nouveaux contenus sont publiés.

***

#### **Ce que vous obtiendrez**

* **Du contenu frais en un coup d’œil :** Mettez en avant vos articles Knowledge les plus récents sur la page d’accueil, avec images, pour que les visiteurs ne manquent aucune mise à jour.
* **Navigation sans effort :** Permettez aux clients de faire défiler l’actualité de l’entreprise dans une disposition en carrousel claire et structurée.
* **Filtrage ciblé :** Affichez uniquement les articles News en exploitant un champ de liste de sélection personnalisé, afin de garder le carrousel ciblé et pertinent.

***

#### **Avant de commencer**

* **`ImageId__c` champ :** Créez un champ Texte sur l’objet Knowledge pour stocker l’ID de document de contenu de l’image de chaque article.
* **`Type__c` champ :** Créez un champ Liste de sélection sur l’objet Knowledge pour catégoriser les articles, en veillant à ce que la **News** valeur existe et soit appliquée à vos articles.

***

#### **Comment le configurer**

{% stepper %}
{% step %}

#### **Ajoutez le composant à votre page**

* Faites glisser le **AX Gallery** composant sur la page souhaitée dans Experience Builder.
  {% endstep %}

{% step %}

#### **Personnalisez l’affichage du composant**

* Définissez le **Titre** à `Carrousel des actualités`.
* Définissez le **Légende** à `Parcourez nos articles hebdomadaires`.
* Définissez le **Nombre de colonnes** à `3`.
  {% endstep %}

{% step %}

#### **Configurez votre source de données**

* Créez une nouvelle requête dans la configuration de la source de données.
* Sélectionnez **Knowledge** comme objet (veillez à sélectionner la deuxième option Knowledge dans la liste).
* Ajoutez un filtre : **Type\_\_c égale à** `News`.
* Définissez l’ordre de tri sur **Date de création, décroissant** afin que vos articles les plus récents apparaissent toujours en premier.
  {% endstep %}

{% step %}

#### **Configurez le mappage des données**

* Mappez **Titre** sur le champ Knowledge `Titre` .
* Mappez **Source des médias** à `ImageId__c` pour récupérer les images des articles.
* Définissez le **Taux de lecture** à `5`.
  {% endstep %}

{% step %}

#### **Prévisualisez votre travail**

* Utilisez l’aperçu d’Experience Builder pour confirmer que votre carrousel affiche les bons articles, les bonnes images et la bonne disposition avant la publication.
  {% endstep %}
  {% endstepper %}

***

### Exemple 2 : Galerie de produits clients

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

Offrez à vos clients un moyen visuellement convaincant de découvrir votre catalogue de produits, directement depuis votre page d’accueil. En combinant le composant AX Gallery avec vos données Produit, vous pouvez créer un carrousel attrayant qui met en avant les produits phares et guide les visiteurs directement vers les pages de détail des produits.

***

#### **Ce que vous obtiendrez**

* **Une vitrine de produits visuelle :** Affichez des casques phares dans un carrousel riche en images qui encourage la navigation.
* **Navigation fluide :** Permettez aux clients d’aller facilement du carrousel directement aux pages de détail de chaque produit.
* **Une expérience d’accueil soignée :** Mettez en avant les produits les plus importants en n’affichant sur la page d’accueil que votre catalogue phare.

***

#### **Avant de commencer**

* **`Type__c` champ :** Créez un champ Liste de sélection sur l’objet Product2 et assurez-vous que la **valeur Headphone** existe, afin de pouvoir filtrer le carrousel sur les bons produits.
* **`ContentDocumentId__c` champ :** Créez un champ Texte sur l’objet Product2 pour stocker l’URL de l’image de chaque produit.

***

#### **Comment le configurer**

{% stepper %}
{% step %}

#### **Ajoutez le composant à votre page**

* Faites glisser le **AX Gallery** composant sur la page souhaitée dans Experience Builder.
  {% endstep %}

{% step %}

#### **Personnalisez l’affichage du composant**

* Définissez le **Titre** à `Carrousel des produits`.
* Définissez le **Légende** à `Parcourez nos produits phares !`
* Définissez le **Nombre de colonnes** à `3`.
  {% endstep %}

{% step %}

#### **Configurez votre source de données**

* Créez une nouvelle requête dans la configuration de la source de données.
* Sélectionnez **Produit** comme objet.
  {% endstep %}

{% step %}

#### **Configurez le mappage des données**

* Mappez **Titre** à `Nom du produit` .
* Mappez **Source des médias** à `ContentDocumentId__c` pour afficher l’image de chaque produit.
* Définissez le **Taux de lecture** à `5`.
  {% endstep %}

{% step %}

#### **Prévisualisez votre travail**

* Utilisez l’aperçu d’Experience Builder pour confirmer que vos produits, images et la disposition du carrousel s’affichent comme prévu avant la publication.
  {% 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-gallery.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.
