Intégration Experience Sites

Aperçu

Vous pouvez déployer les composants puissants et personnalisés que vous construisez avec le Avonni Dynamic Component Builder directement sur les pages de votre site Experience Cloud. Cela vous permet de créer des expériences riches, interactives et pilotées par les données pour vos clients, partenaires et utilisateurs externes, allant bien au-delà des composants standard d’Experience Builder.

Remarque sur l’accès des utilisateurs invités

Actuellement, les utilisateurs invités ne peuvent pas accéder aux Dynamic Components dans les sites Salesforce Experience Cloud car Salesforce n’autorise pas les utilisateurs invités à consulter les métadonnées personnalisées, qui est la façon dont les Dynamic Components sont stockés.

Si vous avez besoin que les utilisateurs invités aient accès aux Dynamic Components, veuillez nous en informer . Vos retours nous aideront à prioriser la recherche d’une solution de contournement.

---

Comment cela fonctionne

Lorsque vous travaillez dans l’Experience Builder, vous ne verrez pas chacune de vos créations listée dans le panneau des composants. À la place, vous utiliserez un seul composant générique nommé "Avonni Dynamic Component" . Ce composant agit comme un conteneur sur votre page. Vous configurez ensuite ce conteneur pour afficher le Dynamic Component spécifique et activé que vous souhaitez montrer.

Guide étape par étape

Étape 1 : Créez et activez votre Dynamic Component

Avant de pouvoir ajouter un composant à un site Experience Cloud, vous devez d’abord le construire et le tester dans le Avonni Dynamic Component Builder.

• Assurez-vous que le composant est enregistré.

• De manière cruciale, vous devez cliquer sur Activer . L’activation rend votre composant disponible pour sélection dans l’Experience Builder.

Étape 2 : Ajoutez le conteneur à votre page Experience Cloud

1. Accédez à votre site Experience Cloud et ouvrez l’ Experience Builder.

2. Allez à la page où vous souhaitez ajouter votre composant.

3. Ouvrez la Panneau des composants (généralement à gauche).

4. Trouvez le composant nommé "Avonni Dynamic Component" (il peut se trouver sous une section « Personnalisé ») et faites-le glisser à l’emplacement souhaité sur la page.

Étape 3 : Configurez les propriétés du conteneur

Sélectionnez le conteneur « Avonni Dynamic Component » que vous venez de placer sur la page. L’éditeur de propriétés à droite apparaîtra avec les paramètres clés suivants :

• Nom du composant : Cette liste déroulante affiche tous les activés Avonni Dynamic Components. Sélectionnez le composant spécifique que vous souhaitez afficher dans ce conteneur. Si votre composant n’apparaît pas dans la liste, revenez au builder et assurez-vous qu’il a été activé.

• ID d'enregistrement : C’est essentiel pour rendre votre composant conscient du contexte sur une page de détail d’enregistrement au sein de votre site (par exemple, une page de détail de Case ou une page d’objet personnalisé). Saisissez {!recordId} dans ce champ pour transmettre automatiquement l’ID de l’enregistrement courant consulté à votre composant. Votre composant peut alors utiliser cet ID (via $Component.recordId) pour récupérer et afficher les données correctes.

• Nom de l’objet : De même, sur une page d’enregistrement ou d’objet, vous pouvez transmettre le nom de l’objet à votre composant en saisissant {!objectApiName} . Cela fournit un contexte supplémentaire sur la page sur laquelle le composant fonctionne.

---

Comprendre vos options Avonni pour Experience Cloud

Il est utile de savoir qu’il existe deux façons d’utiliser les composants Avonni dans Experience Cloud, chacune conçue pour des besoins différents :

• Avonni Dynamic Components (Ce guide) : Utilisez cette approche lorsque vous devez construire des solutions complexes, personnalisées et composées de plusieurs parties . Elle est idéale pour créer des cas d’utilisation avancés et interactifs — tels qu’une carte avec un tableau de données filtrable, un tableau Kanban, un processus multi-étapes ou un tableau de bord de métriques — puis placer l’ensemble de cette solution personnalisée sur une page du site.

• Composants Avonni préconstruits pour les sites Experience: Notre autre package propose une bibliothèque de plus de 40 composants individuels préconstruits (comme une simple carte, une galerie ou une liste d’images) directement disponibles dans l’Experience Builder. Ceci est idéal pour des besoins plus simples et directs lorsque vous souhaitez ajouter rapidement un élément préfabriqué à une page.

Vous pouvez utiliser les deux solutions ensemble sur le même site ! Utilisez les composants préconstruits pour les tâches simples et utilisez le puissant conteneur Dynamic Component pour vos expériences plus avancées et personnalisées.