Mises à jour en temps réel

Aperçu

Les événements Platform permettent à vos Composants Dynamiques Avonni (Chat, Kanban, Liste, Table de données, etc.) de écouter les changements qui se produisent dans votre organisation Salesforce et de rafraîchir automatiquement leurs données en temps réel.

Par défaut, si un autre utilisateur ou un processus automatisé met à jour un enregistrement pendant que vous le consultez, vous ne verrez pas ce changement tant que vous n'aurez pas actualisé manuellement la page. Cette fonctionnalité résout ce problème, en garantissant que vos utilisateurs voient toujours les informations les plus récentes sans interruption.

Ce guide vous explique la configuration unique requise dans Salesforce pour activer cette fonctionnalité.

Pour permettre les mises à jour en temps réel, vous avez besoin de trois choses :

1. Un Platform Event : Un « signal » que Salesforce diffuse lorsqu'une modification survient.

2. Un Trigger Flow : Une automatisation qui déclenche le signal lorsqu'un enregistrement est créé ou mis à jour.

3. Configuration du composant : Le Composant Dynamique Avonni qui écoute ce signal.

---

Parcours de configuration

Pour expliquer la configuration, nous utiliserons un scénario courant : Faire en sorte qu'un chat de dossier (Case Chat) se mette à jour instantanément lorsqu'un nouveau commentaire est publié.

L'objectif est d'informer la page d'enregistrement du dossier (Case Record Page) qu'un changement est survenu afin que le chat puisse se rafraîchir.

1

Créer un Platform Event

Nous avons besoin d'un objet d'événement personnalisé qui agira comme notre « signal de notification ».

1. Aller à Configuration > Intégrations > Platform Events.

2. Cliquer sur Nouveau Platform Event.

3. Libellé : Saisir Notification de Chat (ou Événement de changement d'enregistrement).

4. Libellé pluriel : Notifications de Chat.

5. Comportement de publication : Sélectionner Publier après validation.

6. Cliquer sur Enregistrer.

Ajouter un champ de charge utile

Nous avons besoin d'un champ pour contenir l'ID de l'enregistrement qui a changé afin que le composant sache quelles données rafraîchir.

1. Dans la section Champs personnalisés et relations de votre nouveau Platform Event, cliquez sur Nouveau.

2. Sélectionner Texte comme type de données.

3. Libellé du champ : RecordId.

4. Longueur : 18.

5. Nom du champ : RecordId (le nom API sera RecordId__c).

6. Cliquer sur Enregistrer.

Remarque : Vous pouvez ajouter d'autres champs si vous souhaitez transmettre des données spécifiques, mais l'ID de l'enregistrement suffit généralement pour rafraîchir les composants.

2

Créer un Trigger Flow

Nous devons maintenant dire à Salesforce de réellement déclencher cet événement lorsqu'un enregistrement change.

1. Aller à Configuration > Automatisation des processus > Flows.

2. Cliquer sur Nouveau Flux et sélectionner Flux déclenché par un enregistrement.

3. Configurer le démarrage :

   • Objet : CaseComment (ou l'objet que votre composant affiche).

   • Déclencheur : Un enregistrement est Créé (ou mis à jour).

   • Optimiser pour : Actions et enregistrements liés.

4. Ajouter un élément : Créer des enregistrements.

   • Libellé : Publier un Platform Event.

   • Objet : Sélectionnez le Platform Event que vous avez créé à l'étape 1 (par ex., Notification de Chat).

   • Définir les valeurs des champs :

     • RecordId__c ← {!$Record.ParentId}

   • Pourquoi ParentId ? Puisque le chat est affiché sur la page du dossier (Case), nous devons notifier le dossier qu'un événement s'est produit. Lorsqu'un Commentaire est créé, nous récupérons son ID du parent et le diffusons. et

5. Enregistrer Activer le flux. Connecter votre composant

3

Maintenant que le back-end diffuse des signaux, vous devez simplement « syntoniser » votre Composant Dynamique Avonni.

Ouvrez votre composant dans le

1. Générateur de composants Avonni Assurez-vous que le.

2. Source de données est défini sur Requête Ouvrir.

3. Options avancées Actualisation de requête EMP > Remplissez les paramètres :.

4. Nom du canal :

   • Le nom API de votre événement (par ex., Chat_Notification__e Nom du champ clé :).

   • Le nom API du champ de la charge utile (par ex., Valeur du champ clé (optionnel) : RecordId__c).

   • Laisser vide. Comportement :

     • En laissant ce champ vide, le composant compare automatiquement le de l'événement avec l'enregistrement actuellement affiché à l'écran ( RecordId {!RecordId}). Si ils correspondent, il se rafraîchit.Résultat :

Votre composant rafraîchira désormais ses données automatiquement chaque fois que le flux de l'étape 2 s'exécutera. Tester votre configuration

---

Pour vérifier que les mises à jour en temps réel fonctionnent :

Ouvrez votre page d'enregistrement Salesforce dans

1. deux onglets de navigateur distincts (ou utilisez une fenêtre de navigation privée pour le second). Dans l'onglet 1, publiez un nouveau message (ou mettez à jour un enregistrement).

2. Surveillez l'onglet 2. Le composant devrait se mettre à jour instantanément pour afficher le changement sans que vous cliquiez sur actualiser.

3. Dépannage

---

Si le composant ne se met pas à jour :

Vérifier les autorisations :

• Assurez-vous que l'utilisateur a la permission de lire/créer l'objet Platform Event. Vérifier les noms API :

• Assurez-vous que le Nom du canal inclut le suffixe __e et que le Nom du champ clé inclut __c.

• Vérifier le débogage du flux : Utilisez le débogueur de flux pour vous assurer que le Platform Event est réellement publié lorsque vous créez un enregistrement.