> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/panneau-des-proprietes/interactions/execute-flow.md). # Exécuter le Flow Exécutez un flux Salesforce lancé automatiquement en arrière-plan depuis un composant Avonni, sans ouvrir de boîte de dialogue ni quitter la page. ## Aperçu L’interaction Exécuter le flux lance un flux automatisé lorsqu’un utilisateur interagit avec un composant de votre site Experience — en cliquant sur un bouton, une action de ligne, une action d’en-tête, un élément d’une liste. Rien ne s’ouvre à l’écran : le flux s’exécute côté serveur, effectue son travail (mise à jour d’enregistrements, calcul d’une valeur, appel à un autre système), et la page sur laquelle se trouve l’utilisateur reste exactement là où elle est. Configurez-la comme toute autre interaction. Experience Builder ne possède pas d’onglet Interactions, donc le paramètre se trouve dans l’éditeur de l’événement que vous configurez — le **Au clic**d’un bouton, **Au clic**d’une action de ligne, d’une action d’en-tête de colonne **Au clic** — où vous sélectionnez **Exécuter le flux** comme interaction **Type**. {% hint style="warning" %} **Exécuter le flux** exécute *lancé automatiquement* flux uniquement. Pour lancer un flux d’écran — un flux avec une interface utilisateur — utilisez [Ouvrir la boîte de dialogue du flux](/experience-cloud/experience-cloud-fr/panneau-des-proprietes/interactions/open-flow-dialog.md) ou [Ouvrir le panneau du flux](/experience-cloud/experience-cloud-fr/panneau-des-proprietes/interactions/open-flow-panel.md) à la place. {% endhint %} Contrairement à ces deux interactions, le flux n’a pas besoin de se trouver sur une page de votre site : Exécuter le flux le lance côté serveur, donc aucune page du site ne l’héberge et rien n’a besoin d’être publié pour qu’il soit trouvé. {% hint style="info" %} **Exécuter le flux ne s’exécute pas dans Experience Builder ni dans l’aperçu du site.** Le déclencher là affiche un toast indiquant que l’interaction n’est pas exécutée dans l’aperçu, et le flux est ignoré. Testez-le sur le site publié. {% endhint %} ## Configuration | Nom | Description | | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nom API du flux** | Le flux à exécuter. La liste propose les flux lancés automatiquement de votre org par leur **Libellé**, et non par leur nom API, et peut être recherchée. Définissez-le d’abord : les trois paramètres ci-dessous restent masqués tant qu’il ne l’est pas. | | **Variables d’entrée du flux** | Les valeurs transmises au flux avant son démarrage, une entrée par variable. Voir ci-dessous. | | **À la fin** | Les interactions à exécuter une fois le flux terminé avec succès. Les interactions acceptées sont **Afficher un toast** et **Actualiser toutes les requêtes**. | | **En cas d’erreur** | Les interactions à exécuter si le flux échoue. Les interactions acceptées sont **Afficher un toast** et **Actualiser toutes les requêtes**. | ### Variables d’entrée du flux Chaque entrée associe l’une des variables d’entrée du flux. La variable doit être marquée **Disponible en entrée** dans Flow Builder, et son nom API est sensible à la casse. * **Nom :** la variable de flux à définir. La liste propose les variables d’entrée du flux sélectionné. * **Valeur :** la valeur à attribuer. Ce que cette entrée propose dépend de l’éditeur dans lequel vous vous trouvez. Dans un éditeur de ligne ou d’élément — une action de ligne de Data Table, un élément de liste, une action d’en-tête de colonne de tree grid — vous pouvez choisir **Personnalisé** pour saisir une valeur statique, ou choisir l’un des champs d’enregistrement fournis par le composant à ce moment-là, ce qui insère un `{{Record.}}` jeton afin que chaque ligne ou élément transmette sa propre valeur ; ces options de champ proviennent de la **Requête** source de données. Dans les éditeurs de bouton, de bannière, de métrique et d’action d’en-tête, il n’y a pas d’enregistrement derrière le clic, donc **Valeur** est un simple champ de saisie de texte. * **Type :** le type de données de la valeur — **Texte** (par défaut), **Nombre**, **Booléen**, **Date**, **Date/heure** ou **Objet Salesforce**. Choisissez **Personnalisé** pour saisir un type qui ne figure pas dans la liste. * **Nom API de l’objet :** l’objet que la valeur représente, par exemple `Compte` ou `Contact`. Nécessite **Type** d’être **Objet Salesforce**. * **Autoriser plusieurs valeurs (collection) :** activez cette option lorsque la valeur est une collection et non une valeur unique. Seules **Nom** et **Valeur** sont envoyées au flux. **Type**, **Nom API de l’objet** et **Autoriser plusieurs valeurs (collection)** décrivent la valeur au composant afin qu’il puisse résoudre le jeton avant l’appel — elles n’indiquent rien au flux, et elles ne peuvent pas corriger une incohérence avec la manière dont la variable est déclarée dans Flow Builder. ### À la fin et en cas d’erreur **À la fin** est l’endroit où vous indiquez à l’utilisateur ce qui s’est passé et où vous mettez la page à jour — un **Afficher un toast** confirmant l’action, un **Actualiser toutes les requêtes** afin que les composants de la page relisent les enregistrements modifiés par le flux. **En cas d’erreur** couvre le cas inverse. Si vous ne configurez aucune **Afficher un toast** à cet endroit, le composant affiche son propre toast d’erreur, intitulé « Erreur lors de l’exécution du flux », en pointant les deux causes habituelles : le flux n’est pas actif, ou l’utilisateur qui l’exécute n’y a pas accès. ## Exemple Un Data Table affiche les cas ouverts d’un utilisateur du portail, et vous voulez une action de ligne qui transfère le cas à l’équipe de support. 1. Dans Flow Builder, créez un flux lancé automatiquement — libellé `Escalader le cas`, nom API `Escalate_Case` — avec une variable d’entrée de texte `recordId` marquée **Disponible en entrée**, un élément Mettre à jour des enregistrements qui définit le statut et la file du cas, puis enregistrez-le et activez-le. 2. Dans Experience Builder, sélectionnez le Data Table et mappez une colonne avec **Type** défini sur **Action**. Sous **Actions de ligne**, ajoutez une entrée avec un **Libellé** de `Escalade` et un **Nom** de `escalader`. 3. Dans les **Au clic**de cette action, définissez **Type** sur **Exécuter le flux** et choisissez **Escalader le cas** dans **Nom API du flux** — la liste affiche le libellé de chaque flux. 4. Sous **Variables d’entrée du flux**, ajoutez une entrée : **Nom** `recordId`, **Valeur** **Enregistrement : ID du cas**, **Type** **Texte**. Les **Valeur** options portent le nom des libellés de champ de la requête du tableau. 5. Sous **À la fin**, ajoutez un **Afficher un toast** (« Cas escaladé ») et un **Actualiser toutes les requêtes** afin que le tableau se recharge avec le nouveau statut. En cliquant **Escalade** sur une ligne, le flux s’exécute désormais pour ce cas, sans boîte de dialogue pour vous gêner. ## Dépannage **La liste Nom sous Variables d’entrée du flux est vide.** Le flux n’est pas actif. **Nom API du flux** répertorie les flux inactifs avec les flux actifs, mais les variables d’entrée sont lues à partir de la version active du flux — un flux inactif n’en a aucune, donc il n’y a rien à proposer. Activez le flux dans Flow Builder, puis rouvrez l’éditeur. **Il ne se passe rien lorsque j’essaie l’interaction dans le générateur ou dans l’aperçu du site.** C’est attendu : Exécuter le flux est ignoré dans ces cas et un toast l’indique. Publiez le site et essayez en tant qu’utilisateur du site. **Le flux s’exécute pour moi, mais pas pour les utilisateurs du site.** Vérifiez que le profil de l’invité du site ou de l’utilisateur du portail a accès au flux lui-même ainsi qu’aux enregistrements qu’il lit et modifie. ## Considérations importantes * **Le flux doit être actif.** Un flux inactif échoue lorsqu’un utilisateur du site le déclenche, sans avertissement dans le générateur. * **Les utilisateurs du site ont besoin d’accéder au flux** et aux enregistrements qu’il traite. Un flux qui fonctionne pour vous en tant qu’administrateur peut toujours échouer pour un invité ou un utilisateur du portail. * **Les noms de variables doivent correspondre exactement** entre le flux et l’interaction, y compris la casse. * **Aucune variable de sortie.** Dans les Experience Sites, l’interaction ne relit pas les valeurs du flux. Récupérez ce que le flux a modifié avec un **Actualiser toutes les requêtes** dans **À la fin** à la place. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/panneau-des-proprietes/interactions/execute-flow.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.