Flow

Aperçu

Le composant Avonni Flow intègre et exécute de manière transparente un Screen Flow Salesforce directement dans la mise en page de votre composant dynamique Avonni. Il agit comme un conteneur, vous permettant d’intégrer des processus guidés, des formulaires interactifs et des expériences utilisateur dynamiques — tous alimentés par la logique et l’automatisation de Flow — directement dans vos interfaces utilisateur personnalisées Lightning construites visuellement.

Principales caractéristiques

• Exécution en ligne d’un Screen Flow: Exécutez des Screen Flows comme partie intégrante de la mise en page de votre composant dynamique.

• Intégration des données: Transmettez des données depuis votre composant dynamique dans vers le Flow en utilisant des variables d’entrée.

• Récupérer les résultats du Flow: Capturer des données du Flow et les renvoyer à votre composant dynamique en utilisant des variables de sortie.

• Contrôler le comportement du Flow: Définissez ce qui se passe lorsque le Flow intégré se termine.

Lancement vs intégration

Alors que des interactions comme «Ouvrir la boîte de dialogue Flow» ou «Open Flow Panel» lancent un Screen Flow dans un modal séparé ou un panneau latéral (généralement déclenché par une action utilisateur, comme un clic sur un bouton), le composant Avonni Flow intègre le Screen Flow directement dans la zone de mise en page actuelle du composant. Il est visible et actif en tant que partie de la structure de la page (si ses conditions de visibilité sont remplies).

Cas d'utilisation

• Intégrer des questionnaires ou des enquêtes dynamiques directement sur une page d’enregistrement ou d’application.

• Afficher des mini-assistants guidés ou des listes de contrôle en tant que partie d’une interface utilisateur personnalisée plus grande.

• Créer des formulaires interactifs pour la saisie ou la mise à jour de données qui tirent parti de la logique Flow, directement dans une section de votre page.

• Afficher des éléments d’interface conditionnels ou des messages pilotés par une logique Flow complexe en ligne.

• Fournir une manière compacte et guidée d’initier un processus lié aux données affichées.

Ajouter le composant Flow

Glisser-déposer: Depuis la bibliothèque de composants (panneau de gauche), trouvez le composant « Flow » et faites-le glisser sur votre canevas à l’endroit où vous souhaitez que le Screen Flow apparaisse.

Configuration

Propriétés de base

• par le véritable: (Texte) Un identifiant unique pour cette instance du composant Flow au sein de votre composant dynamique (par ex., QuickContactUpdateFlow, SurveyFlowEmbed).

• Nom API du Flow: Sélectionnez le Name du Screen Flow Salesforce que vous souhaitez intégrer et exécuter.

Variables d’entrée (transmission de données au Flow)

Cette section vous permet de transmettre des données depuis votre composant dynamique (par ex., l’ID de l’enregistrement courant, des sélections utilisateur, des valeurs de variables) dans aux variables d’entrée de votre Screen Flow sélectionné.

• Cliquez sur « Ajouter une variable d’entrée » (ou équivalent).

• Name: Dans le menu déroulant, sélectionnez le par le véritable d’une variable d’entrée définie dans votre Screen Flow et marquée comme « Disponible pour entrée ».

Remarque importante

Si la variable d’entrée n’est pas correctement configurée dans votre Flow, vous ne verrez pas son nom disponible pour la sélection ici

• propriété: Utilisez le sélecteur de ressources (Cartographié) pour choisir la valeur depuis votre composant dynamique que vous souhaitez transmettre à cette variable d’entrée du Flow. Cela peut être :

  • Une valeur statique.

  • Une variable globale (par ex., @recordId ou $Component.recordId si le composant dynamique a un Objet de page cible défini et se trouve sur une page d’enregistrement).

  • Une ressource Variable, Constante ou Formule provenant de votre composant dynamique.

  • Un attribut d’un autre composant sur le canevas (par ex., !MyDataTable.firstSelectedRow.Id).

Variables de sortie (récupération de données depuis le Flow)

Cette section vous permet de capturer des valeurs depuis les variables de sortie de votre Screen Flow (celles marquées « Disponible pour sortie ») et de les stocker dans des ressources de type Variable au sein de votre composant dynamique.

1. Cliquez sur « Ajouter une variable de sortie » (ou équivalent).

2. Nom de sortie: Dans le menu déroulant, sélectionnez le par le véritable d’une variable de sortie définie dans votre Screen Flow et marquée comme « Disponible pour sortie ».

3. Nom de la ressource: Sélectionnez une ressource Variable (d’un type de données correspondant) depuis votre composant dynamique où la valeur renvoyée par la variable de sortie du Flow doit être stockée.

Contrôler le comportement du Flow

Comportement à la fin: (Sélection) Définit ce qui se passe automatiquement lorsque le Screen Flow intégré atteint son écran « Fin » ou son point final.

• Aucun (Par défaut) : Le Flow s’exécute une fois. Après l’avoir terminé, il reste généralement sur son dernier écran ou dans un état terminé.

• Redémarrer: Après la fin du Flow, il redémarre automatiquement depuis le début. Cela peut être utile pour la saisie de données cyclique ou des scénarios de type kiosque.

Définir la visibilité du composant

Contrôle si l’ensemble du composant Flow (et donc le Flow intégré) est visible sur la page. En savoir plus sur Définir la visibilité du composant.

Exemple : Intégrer un Flow « Mise à jour rapide de tâche » sur une page de Case

1

Créer un Screen Flow : Construisez un Flow nommé Quick_Update_Task_Flow qui :

• Prend inputCaseId (Texte, Disponible pour entrée) et inputTaskSubject (Texte, Disponible pour entrée) comme entrées.

• Possède un écran pour modifier le sujet de la tâche ou ajouter des commentaires facultativement.

• Met à jour ou crée une tâche liée à inputCaseId avec le sujet.

• Activez le Flow.

2

Créer un composant dynamique : Définissez le Nom API de l’objet cible sur Cas.

Définissez Objet de page cible sur Cas.

3

Ajouter le composant Flow

• Nom API : CaseTaskFlow

• Nom API du Flow : Quick_Update_Task_Flow

• Variables d'entrée :

  • Mappage 1 : Nom : inputCaseId, Valeur : @recordId (ou $Component.record.Id)

  • Mappage 2 : Nom : inputTaskSubject, Valeur : (par ex., une ressource Constante comme {!DefaultTaskSubject} ou une autre variable)

• Comportement à la fin : Redémarrer (afin que l’utilisateur puisse ajouter une autre tâche rapide si nécessaire).

4

Ajoutez d’autres composants autour selon vos besoins

5

Placer sur la page d’enregistrement Case : Ajoutez ce composant dynamique à une page d’enregistrement Case

Résultat: Le Flow « Mise à jour rapide de tâche » sera intégré directement sur la page Case, préchargé avec l’ID du Case, permettant aux utilisateurs d’ajouter ou de mettre à jour rapidement des tâches pour ce Case.

Considérations clés

• Uniquement Screen Flows: Ce composant est conçu pour exécuter Screen Flows. Les Flows lancés automatiquement doivent être déclenchés via l’interaction « Exécuter le Flow ».

• L’interface Flow est distincte: Le design visuel des écrans du Flow (les éléments, la mise en page et tout composant Avonni pour les Flows utilisés à l'intérieur dans ces écrans) est géré dans Salesforce Flow Builder. Le composant Flow ici l’héberge.

• Limites des Flows: Le Flow intégré reste soumis aux limites standard des Flows Salesforce et aux limites du gouverneur.

• Contexte: N’oubliez pas que le Flow s’exécute dans le contexte fourni par le composant dynamique, en particulier en ce qui concerne les variables d’entrée.

• Temps de chargement du Flow intégré : Notez que le temps nécessaire pour que le Screen Flow intégré apparaître et devenir interactif dépend du moteur de rendu des Flows de Salesforce et de la complexité spécifique du Flow (par ex., le nombre d’éléments et requêtes de données initiales à l'intérieur du Flow). Bien que votre composant dynamique Avonni environnant et la page Lightning globale se chargeront rapidement, un Flow intégré très complexe peut prendre un moment pour s’initialiser dans sa zone désignée. Cela affecte principalement le temps de démarrage du Flow lui‑même et ne devrait pas dégrader les performances des autres composants sur la page.

En résumé

Le composant Avonni Flow offre une manière puissante d’intégrer des Screen Flows Salesforce interactifs directement dans vos interfaces de pages Lightning personnalisées construites avec des composants dynamiques. Il facilite l’échange de données de manière transparente et vous permet de combiner les forces de la conception de pages déclarative avec l’automatisation de processus guidés.