Exécuter un Flow

Aperçu

L’interaction Exécuter un Flow déclenche un processus en arrière-plan (un Flow lancé automatiquement) depuis un composant dynamique. Cela est utile pour automatiser des tâches, mettre à jour des enregistrements, effectuer des calculs ou implémenter toute autre logique dans un Flow.

Remarque importante

Le «Exécuter un Flow» est conçu pour les Flows lancés automatiquement (Flows qui s’exécutent en arrière-plan). Si vous souhaitez lancer un Flow avec écran (un Flow avec des éléments d’interface utilisateur), utilisez plutôt les interactions «Ouvrir la boîte de dialogue Flow» ou «Ouvrir le panneau Flow».

Fonctionnement

L’interaction Exécuter un Flow suit un processus simple pour connecter votre composant à l’automatisation Salesforce :

1. Déclencher le Flow Lorsqu’un utilisateur interagit avec votre composant (par exemple en cliquant sur un bouton), l’interaction Exécuter un Flow lance en arrière-plan le Flow autolancé spécifié.

2. Envoyer des données au Flow (facultatif) Transmettez des informations contextuelles de votre composant au Flow en utilisant des variables d’entrée. Cela permet au Flow de traiter des données spécifiques, telles que des ID d’enregistrements, des valeurs de champ ou des sélections d’utilisateur.

3. Le Flow traite votre logique Le Flow autolancé exécute son automatisation configurée — qu’il s’agisse de créer des enregistrements, d’effectuer des calculs, de mettre à jour des données ou de toute autre logique métier que vous avez définie.

4. Recevoir les résultats du Flow (facultatif) Capturez les données renvoyées par le Flow via des variables de sortie. Ces résultats peuvent inclure des ID d’enregistrement nouvellement créés, des valeurs calculées, des messages d’état ou toute autre information générée par le Flow.

5. Gérer la fin (facultatif) Configurez ce qui se passe après que le Flow se termine avec succès ou rencontre une erreur. Affichez des messages de confirmation, actualisez les données, naviguez vers une autre page ou déclenchez des actions supplémentaires pour tenir les utilisateurs informés et maintenir une expérience fluide

Configuration

Pour configurer l’interaction Exécuter un Flow, vous devrez définir plusieurs paramètres clés qui contrôlent quel Flow s’exécute, quelles données sont transmises à l’aller et au retour, et ce qui se passe après l’exécution. Passons en revue chaque option de configuration.

Nom d’API du Flow

Il s’agit de l’identifiant unique qui indique à l’interaction quel Flow autolancé exécuter.

Format : Le nom d’API tel qu’il est exactement défini dans Flow Builder (par ex., Create_Case_Records, Calculate_Discount)
Où le trouver : Dans Flow Builder, ouvrez votre Flow et vérifiez les propriétés du Flow — vous verrez le champ Nom d’API lorsque vous enregistrez ou affichez les détails du Flow
Exigences importantes :
- Le Flow doit être activé avant de pouvoir être exécuté
- Doit être un Flow autolancé (et non un Flow avec écran ou déclenché par enregistrement)

Variables d’entrée du Flow

Les variables d’entrée vous permettent d’envoyer des données de votre composant dynamique vers le Flow lorsqu’il s’exécute. Considérez-les comme des paramètres que vous passez au Flow — comme des ID d’enregistrements, des sélections d’utilisateur ou des valeurs de champ dont le Flow a besoin pour effectuer son travail.

Fonctionnement des variables d’entrée

Chaque variable d’entrée que vous configurez se mappe à une variable correspondante dans votre Flow
Les variables du Flow doivent être marquées comme « Disponibles pour l’entrée » dans Flow Builder
Vous pouvez transmettre plusieurs variables d’entrée lors d’une seule exécution du Flow

Configuration de chaque variable d’entrée

Nom

Le nom d’API exact de la variable d’entrée tel que défini dans votre Flow.

Doit correspondre exactement (sensible à la casse)
Exemples : recordId, opportunityStage, accountName

Valeur

Les données réelles que vous souhaitez envoyer au Flow. Vous pouvez fournir cette valeur de deux façons :

Valeur statique Entrez directement une valeur fixe qui ne change jamais. Exemples : « Active », 100, true, « High Priority »
Valeur dynamique (cliquez sur l’icône Mapper ) Liez la valeur à une source dynamique de votre composant. Lorsque vous cliquez sur l’icône « Mappé », vous pouvez sélectionner parmi :

Type de valeur

Description

Ressource du composant

Variables, requêtes ou formules définies dans votre composant dynamique

Attributs du composant

Propriétés transmises à votre composant

Variables globales

Valeurs système telles que l’utilisateur actuel ou les informations de l’organisation

Données de ligne sélectionnée

Données d’une ligne sélectionnée dans un tableau de données

Formules

Valeurs ou expressions calculées

💡 Astuce: Utilisez l’icône Mappé (x) chaque fois que vous avez besoin que la valeur soit dynamique ou provienne du contexte de votre composant. Utilisez des valeurs statiques pour des constantes qui ne changent jamais.

Variables de sortie

Optionnel

Les variables de sortie capturent les données que le Flow renvoie après avoir terminé son exécution. Cela permet à votre Flow de renvoyer des résultats à votre composant dynamique — comme des ID d’enregistrements nouvellement créés, des valeurs calculées ou des messages d’état — que vous pouvez ensuite utiliser pour mettre à jour l’interface ou déclencher des actions supplémentaires.

Fonctionnement des variables de sortie :

Chaque variable de sortie que vous configurez se mappe à une variable correspondante dans votre Flow
Les variables du Flow doivent être marquées comme « Disponibles pour la sortie » dans Flow Builder
Les données renvoyées sont stockées dans une ressource du composant dynamique que vous spécifiez

Configuration de chaque variable de sortie :

Nom Le nom d’API exact de la variable de sortie tel que défini dans votre Flow.

Doit correspondre exactement (sensible à la casse)
Exemples : outputContentDocumentId, calculatedDiscount, errorMessage

Nom de la ressource Le nom de la ressource du composant dynamique où la sortie du Flow sera stockée.

Cela doit être une variable que vous avez déjà créée dans votre composant dynamique
Le type de données doit correspondre au type renvoyé par le Flow (Texte, Nombre, Booléen, Enregistrement, etc.).

Exemples de mappages :

Le Flow renvoie un ID de document → Stocker dans : contentDocumentId (variable Texte)
Le Flow renvoie un montant de remise → Stocker dans : finalDiscount (variable Nombre)
Le Flow renvoie un statut de réussite → Stocker dans : wasSuccessful (variable Booléenne)

💡 Astuce : Créez vos variables de composant dynamique avant de configurer l’interaction Exécuter un Flow, afin qu’elles soient disponibles dans le champ Nom de la ressource.

À la fin

La configuration À la fin définit ce qui se passe après que le Flow se termine avec succès. C’est ici que vous créez une expérience utilisateur réactive en fournissant des retours, en mettant à jour l’interface ou en déclenchant des actions de suivi.

Exemple étape par étape

Mise à jour en masse du statut des Contacts

Cet exemple montre comment créer un bouton d’action d’en-tête dans un tableau de données qui met à jour le statut des enregistrements Contact sélectionnés sur « Active » à l’aide d’un Flow autolancé.

Scénario

Vous avez un tableau de données dans votre composant dynamique affichant des enregistrements Contact. Vous souhaitez ajouter un bouton « Définir comme actif » dans les actions d’en-tête du tableau. Lorsque les utilisateurs sélectionnent une ou plusieurs lignes de Contact et cliquent sur ce bouton, le statut des Contacts sélectionnés doit être automatiquement défini sur « Active » via un Flow autolancé.

Ce que vous allez construire :

Un tableau de données affichant des enregistrements Contact avec des lignes sélectionnables
Un bouton d’action d’en-tête libellé « Définir comme actif »
Un Flow autolancé qui met à jour le champ Status
Une interaction Exécuter un Flow qui se déclenche lorsque le bouton est cliqué

Créer le Flow autolancé

Commencez par créer le Flow qui gérera la mise à jour de statut en masse dans Salesforce

Configuration du Flow

Dans Salesforce Setup, allez à Flows → Nouveau Flow
Sélectionnez Flow autolancé (sans déclencheur) et cliquez sur Créer

Logique du Flow

Le Flow a besoin de trois composants clés :

Variable d’entrée (collection) :
- Nom : ContactIds
- Type : Collection de texte (doit autoriser plusieurs valeurs)
- Critique : Cela doit être configuré comme une collection pour recevoir plusieurs ID de Contact depuis le tableau de données lorsque les utilisateurs sélectionnent plusieurs lignes
- C’est ce qui permet au Flow de traiter des mises à jour en masse plutôt qu’un seul enregistrement
Élément Mettre à jour des enregistrements :
- Trouver les Contacts où : Id est dans {!ContactIds}
- Mettre à jour le champ : Status__c = « Active »
- Cela met à jour en masse tous les enregistrements Contact sélectionnés

Enregistrer et activer :

Enregistrez le Flow avec un nom descriptif (par ex., Set_Contact_Status_Active)
Activez le Flow

Principe clé : Le Flow reçoit en entrée une collection d’ID de Contact, trouve tous les enregistrements Contact correspondants et met à jour leur champ Status sur « Active ».

Configurer votre tableau de données dans le composant dynamique

Maintenant que votre Flow est créé et activé, passez à la configuration de votre composant dynamique où le tableau de données affichera les enregistrements Contact.

Où vous êtes : Dans le créateur de composant dynamique (et non plus dans Flow Builder)

Configurez votre tableau de données pour afficher les Contacts avec la sélection de lignes activée :

Sélectionnez votre composant tableau de données dans le composant dynamique
Configurez la source de données et les colonnes :
- Assurez-vous que votre tableau de données est connecté à une ressource de requête qui récupère les enregistrements Contact
- Ajoutez des colonnes au tableau en sélectionnant les champs que vous souhaitez afficher (par ex., Nom, Status__c, Email)
Activer la sélection multiple de lignes :
- Dans les propriétés du tableau de données, repérez l’attribut Sélection maximale de lignes attribut
- Assurez-vous qu’il n’est pas défini sur 1 afin de permettre aux utilisateurs de sélectionner plusieurs enregistrements dans le tableau
- Cela garantit que les utilisateurs peuvent mettre à jour en masse plusieurs Contacts en une seule fois.

Ajouter le bouton d’action d’en-tête

Ajoutez le bouton « Définir comme actif » à l’en-tête de votre tableau de données :

Avec votre tableau de données sélectionné, accédez à la section En-tête dans le panneau des propriétés
Cliquez sur « Ajouter une action d’en-tête »
Configurez le bouton :
- Libellé : Définir comme actif
- Icône (facultatif) : utility:check
- Type : Bouton

Configurer l’interaction Exécuter un Flow

Connectez maintenant le bouton d’action d’en-tête à votre Flow autolancé afin qu’il se déclenche lors du clic.

Où vous êtes : Toujours dans le créateur de composant dynamique, en train de configurer l’interaction

Ajouter l’interaction :
- Dans le panneau Interactions, cliquez sur « Ajouter une interaction »
- Type d’interaction : Sélectionnez Clic sur l’action d’en-tête
- Nom de la cible : Sélectionnez le bouton d’action d’en-tête « Définir comme actif » que vous avez créé à l’étape 3
Définir le type d’action :
- Type : Sélectionnez Exécuter un Flow
Configurer la connexion au Flow : Nom d’API du Flow :
- Saisissez : Set_Contact_Status_Active
- Cela doit correspondre exactement au nom d’API du Flow autolancé que vous avez créé à l’étape 1
Transmettre les ID de Contact sélectionnés au Flow : Variables d’entrée du Flow :
- Cliquez sur « Ajouter une variable d’entrée »
- Nom : ContactIds (doit correspondre exactement au nom de la variable d’entrée de votre Flow)
- Valeur : Cliquez sur l’icône Mappé (🔗)
  - Accédez à votre composant tableau de données
  - Sélectionnez : {!DataTableComponentName.SelectedRowsKeyValue}
- Important : Activez « Autoriser plusieurs valeurs (collection) »
  - Cela permet de transmettre plusieurs ID de Contact sélectionnés depuis le tableau de données au Flow sous forme de collection
  - Sans cela, un seul ID de Contact serait transmis
Configurer ce qui se passe après la fin du Flow : Actions À la fin :
- Cliquez sur « Ajouter un élément » → « Actualiser toutes les requêtes »
- Cela recharge automatiquement le tableau de données pour afficher les valeurs de statut mises à jour après la fin du Flow.

Ce que vous avez configuré : Lorsque les utilisateurs cliquent sur le bouton « Définir comme actif », l’interaction Exécuter un Flow capture tous les ID de Contact sélectionnés depuis le tableau de données, les transmet en tant que collection à votre Flow, et actualise le tableau une fois la mise à jour terminée

Activer et tester

Maintenant que tout est configuré, il est temps de tester votre travail :

Enregistrez votre composant dynamique :
- Cliquez sur Enregistrer dans le créateur de composant dynamique pour enregistrer toutes vos modifications
Déployer sur une page Lightning :
- Accédez à une page Lightning où vous souhaitez utiliser cette fonctionnalité (par ex., une page liste Contact ou la page d’accueil)
- Modifiez la page et ajoutez-y votre composant dynamique
- Enregistrer et Activez la page
Tester la fonctionnalité :
- Allez à la page Lightning où vous avez ajouté votre composant
- Sélectionnez une ou plusieurs lignes de Contact en cochant les cases
- Cliquez sur l’icône « Définir comme actif » bouton d’en-tête
- Vérifiez que :
  - Le statut des Contacts sélectionnés passe à « Active »
  - Le tableau de données s’actualise automatiquement pour afficher les changements
  - Vous pouvez sélectionner et mettre à jour plusieurs Contacts à la fois

Considérations importantes

Flows autolancés uniquement : L’interaction « Exécuter un Flow » ne fonctionne qu’avec des Flows lancés automatiquement Flows, pas des Flows avec écran.
Noms des variables d’entrée/sortie : Les noms d’API de vos variables d’entrée et de sortie doivent correspondre strictement entre le Flow et la configuration « Exécuter un Flow ».
Gestion des erreurs : Utilisez l’action « En cas d’erreur » pour gérer avec élégance toute erreur pouvant survenir durant l’exécution du flow.
Types de données : Assurez-vous que les types de données de vos variables d’entrée et de sortie correspondent entre le Flow et le composant.

En résumé

L’ Exécuter un Flow interaction vous permet de déclencher des Flows autolancés directement depuis vos composants dynamiques, créant une automatisation puissante sans que les utilisateurs aient à quitter la page.

Fonctionnalités clés

Automatiser des tâches en arrière-plan - Mettre à jour des enregistrements, effectuer des calculs ou exécuter une logique métier complexe lorsque les utilisateurs interagissent avec votre composant
Transmettre des données dynamiques aux Flows - Envoyer des informations spécifiques au contexte comme des ID d’enregistrements sélectionnés, des entrées utilisateur ou des valeurs de champ via des variables d’entrée
Gérer intelligemment les résultats - Capturer les sorties du Flow et les utiliser pour mettre à jour votre interface, afficher des messages ou déclencher des actions de suivi
Créer des expériences fluides - Combinez Exécuter un Flow avec des actions comme l’actualisation des données, l’affichage de notifications toast ou la navigation vers différentes pages pour tenir les utilisateurs informés

Bonnes pratiques

Utilisez toujours des Flows autolancés (et non des Flows avec écran) avec cette interaction
Assurez-vous que les noms des variables correspondent exactement entre votre Flow et la configuration Exécuter un Flow
Utilisez des collections pour les variables d’entrée lorsque vous travaillez avec plusieurs enregistrements sélectionnés
Configurez À la fin et En cas d’erreur des actions pour fournir un retour clair aux utilisateurs
Testez soigneusement avec des sélections d’un seul enregistrement et de plusieurs enregistrements

L’interaction Exécuter un Flow comble le fossé entre l’interface utilisateur et l’automatisation, vous permettant de créer des applications sophistiquées et conviviales qui tirent parti de toute la puissance des Flows Salesforce

Mis à jour il y a 23 jours

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