YouTube ChannelSchedule a CallSubscribe for Updates

Ouvrir une boîte de dialogue Flow

Aperçu

L'interaction « Open Flow Dialog » vous permet de lancer un Flux Salesforce Flux d'écran dans une fenêtre de dialogue modale directement depuis un composant dynamique Avonni. Cela offre un moyen puissant d'incorporer des processus interactifs en plusieurs étapes dans votre interface utilisateur sans obliger l'utilisateur à quitter la page en cours.

Cas d'utilisation

L'interaction « Open Flow Dialog » intègre un Screen Flow (flux à écran) dans votre composant dynamique. C'est idéal pour les scénarios où vous devez :

  • Guider les utilisateurs à travers un processus complexe.

  • Collecter des informations de manière structurée.

  • Présenter une série d'écrans en fonction des saisies de l'utilisateur.

  • Effectuer des étapes d'interaction utilisateur avant de continuer avec la logique principale du composant.

(Différence clé : Utilisez « Open Flow Dialog » pour les Screen Flows avec interface utilisateur. Utilisez l'interaction distincte «Exécuter un Flux» pour exécuter les Autolaunched Flows en arrière-plan.)

Tutoriels

Voir des exemples pratiques et apprendre à implémenter des scénarios spécifiques en utilisant cette interaction :

Comment transmettre plusieurs enregistrements sélectionnés d’un composant dynamique à un écran Flow

Comment cela fonctionne

  1. Action de l'utilisateur : L'utilisateur interagit avec le composant (par ex., clique sur un bouton).

  2. Ouverture du dialogue : L'interaction « Open Flow Dialog » ouvre une fenêtre de dialogue modale.

  3. Exécution du Screen Flow : Le Screen Flow spécifié s'exécute à l'intérieur de la fenêtre de dialogue.

  4. Interaction de l'utilisateur avec le Flow : L'utilisateur interagit avec les écrans du Screen Flow, fournissant des informations et faisant des choix.

  5. Passage de données (facultatif) : Vous pouvez transmettre des données du composant dynamique vers le Flow en tant que variables d'entrée.

  6. Résultat (facultatif) : Le Flow peut renvoyer des données au composant dynamique en tant que variables de sortie.

  7. Fermeture du dialogue : La fenêtre modale se ferme lorsque le Flow se termine (ou lorsque l'utilisateur ferme le dialogue).

  8. Actions post-exécution (facultatif) : Vous pouvez configurer des actions à exécuter après la fin du Flow (par ex. afficher un message toast, actualiser les données).

Configuration

Pour configurer l'interaction « Open Flow Dialog » :

  1. Sélectionner le composant : Choisissez le composant Avonni qui déclenchera le Flow (par ex. un bouton).

  2. Ajouter l'interaction : Dans le panneau des propriétés du composant, trouvez la section de configuration des « Actions » ou « Interactions ». Ajoutez une nouvelle action et sélectionnez le type « Open Flow Dialog ».

  3. Configurer les paramètres :

    • Nom API du Flux : Sélectionnez le nom API du Flux d'écran que vous souhaitez lancer.

    • Variables d'entrée du Flux (facultatif) :

      • Nom : Le nom API de la variable d'entrée dans votre Screen Flow.

      • Valeur : La valeur que vous souhaitez transmettre à la variable d'entrée. Il peut s'agir d'une valeur statique, d'une valeur dynamique provenant du composant (par ex. l'ID d'une ligne sélectionnée) ou d'une ressource.

Important

Cette liste affiche les variables déjà définies dans votre Screen Flow et marquées comme Disponibles pour l'entrée. Vous devez créer ces variables d'entrée dans votre Flow avant de configurer l'interaction Open Flow Dialog. Pour la Valeur, fournissez la valeur que vous souhaitez transmettre à la variable d'entrée sélectionnée.

  • Variables de sortie (facultatif) :

    • Nom : Le nom API de la variable de sortie dans votre Screen Flow.

    • Nom de la ressource : Le nom de la ressource (variable) dans votre Composant dynamique où vous souhaitez stocker la valeur renvoyée par le Flow.

  • En-tête du modal : Le texte à afficher comme titre de la fenêtre de dialogue. Il peut s'agir d'un texte statique ou d'une valeur dynamique provenant d'une ressource/champ.

  • Description accessible : (Facultatif) Fournissez une description pour les lecteurs d'écran afin d'améliorer l'accessibilité.

  • Taille : Choisissez la taille de la fenêtre de dialogue (Petit, Moyen, Grand).

  • À la fin (facultatif) : Configurer des actions à exécuter lorsque le Flow se termine avec succès. Les cas d'utilisation quotidiens incluent l'affichage d'un message toast ou l'actualisation des données.

  • À la fermeture (facultatif) : Configurer des actions à exécuter lorsque l'utilisateur ferme la fenêtre de dialogue (indépendamment du fait que le Flow soit terminé).

  • En cas d'erreur (facultatif) : Configurer des actions à exécuter si le Flow rencontre une erreur.

Exemple d'utilisation : création d'un Contact à partir d'un Compte

Imaginez que vous avez un tableau de données Avonni affichant des Comptes. Vous souhaitez ajouter un bouton à chaque ligne qui, lorsqu'il est cliqué, ouvre un Screen Flow pour créer un nouveau Contact lié.

  1. Créer le Screen Flow

    • Créez un nouveau Screen Flow dans la configuration Salesforce.

    • Ajoutez une variable d'entrée nommée AccountId (type Texte).

    • Ajoutez des éléments d'écran pour collecter les informations du Contact (Prénom, Nom, Email, etc.).

    • Ajoutez un élément « Create Records » pour créer un nouveau Contact, en définissant le AccountId champ à la valeur de la AccountId variable d'entrée.

    • (Facultatif) Ajoutez une variable de sortie, par exemple pour renvoyer l'ID du Contact nouvellement créé.

    • Activez le Flux. Notez le nom API du Flux.

  2. Ajouter un composant Data Table : Ajoutez un composant Avonni Data Table à votre composant dynamique et configurez-le pour afficher les Comptes.

  3. Ajouter un bouton (action de ligne) : Ajoutez un composant Bouton en tant qu'action de ligne au Data Table.

  4. Configurer l'interaction « Open Flow Dialog »

    • Sélectionnez le composant Bouton (l'action de ligne).

    • Ajoutez une interaction « Open Flow Dialog ».

    • Nom API du Flux : Saisissez le nom API de votre Screen Flow.

    • Variables d'entrée du Flux :

      • Nom : AccountId

      • Valeur : Enregistrement : ID du Compte (Ceci transmet l'ID du Compte sélectionné au Flow).

    • En-tête du modal : Définir sur 'Créer un nouveau Contact'

    • À la fin : Ajoutez une action « Show Toast » pour confirmer la création du Contact, et actualisez votre table de requête pour voir apparaître le nouveau contact.

  5. Test : Enregistrez et testez. Cliquer sur le bouton dans une ligne du Data Table devrait maintenant ouvrir votre Screen Flow dans un dialogue, prérempli avec l'ID du Compte.

Considérations importantes

  • Uniquement pour les Screen Flows : L'interaction « Open Flow Dialog » fonctionne uniquement avec les Screen Flows, pas avec les flux autolaunchés.

  • Noms des variables d'entrée/sortie : Les noms API de vos variables d'entrée et de sortie doivent correspondre strictement entre le Flow et la configuration « Open Flow Dialog ».

  • Comportement du modal : Le Flow s'exécute dans une fenêtre de dialogue modale. Les utilisateurs doivent terminer ou fermer le Flow avant d'interagir avec le reste de la page.

En résumé

L'interaction « Open Flow Dialog » est un outil puissant pour lancer des Screen Flows directement au sein de vos composants dynamiques Avonni. Elle offre un moyen convivial d'intégrer des processus complexes en plusieurs étapes dans vos applications. En configurant soigneusement les variables d'entrée et de sortie, vous pouvez créer des interactions transparentes entre vos composants et vos Flows.

Mis à jour

Ce contenu vous a-t-il été utile ?