Mise à jour de l’enregistrement et débogage du flux

Remarque

Vous souhaitez apprendre en français ? Dans ce badge, les validations de défi pratique Trailhead se font en anglais. Les traductions sont fournies entre parenthèses à titre de référence. Dans votre Trailhead Playground, veillez (1) à définir les États-Unis comme région, (2) à sélectionner l’anglais comme langue, et (3) à copier et coller uniquement les valeurs en anglais. Suivez les instructions ici.

Consultez le badge Trailhead dans votre langue pour découvrir comment profiter de l’expérience Trailhead traduite.

Mise à jour d’un enregistrement en deux étapes

Vous ne voulez pas seulement envoyer un e-mail de confirmation de réception du don : vous voulez également enregistrer cette confirmation. Dans Nonprofit Success Pack (NPSP), vous pouvez enregistrer ces valeurs dans les champs Acknowledgment Status (Statut de confirmation) et Acknowledgment Date (Date de confirmation) sur un enregistrement d’opportunité.

Commencez par utiliser un élément Assignment (Attribution) pour modifier la variable d’enregistrement de votre opportunité (il s’agit du type spécial de variable dans le flux qui contient des détails à propos d’un enregistrement Salesforce) afin de représenter ce que vous voulez modifier. Vous utilisez ensuite un élément Update Records (Mettre à jour les enregistrements) pour effectuer ces modifications dans la base de données.

Ajout d’un élément Assignment (Attribution) au flux

Commencez par l’élément Assignment (Attribution).

Cliquez sur Add element (Ajouter un élément) () après l’action Send Email (Envoyer un e-mail). Si votre flux devient trop volumineux pour la page et que vous ne trouvez pas le bouton Add element (Ajouter un élément), vous pouvez utiliser les boutons Zoom out (Zoom arrière) () ou Fit to canvas (Ajuster à la zone de dessin) () sur la zone de dessin pour faire de la place.
Sélectionnez Assignment (Attribution) dans la section Logic (Logique).
Label (Étiquette) : Acknowledgment Status (vérifiez votre orthographe et assurez-vous que votre élément Assignment [Attribution] porte ce nom exact pour relever le défi).
API Name (Nom d’API) : Acknowledgment_Status (il devrait être généré automatiquement).
Description : The assignment element sets the values for the opportunity record before we update it in the database. (L’élément d’attribution définit les valeurs de l’enregistrement d’opportunité avant de le mettre à jour dans la base de données.)
Dans Set Variable Values (Définir les valeurs des variables) :
- Sur la première ligne :
  - Variable (Variable) : cliquez sur Search variables… (Recherchez des variables…), puis recherchez et sélectionnez Opportunity from Get_Opportunity (Opportunité de Get_Opportunity) et npsp__Acknowledgement_Status__c (Acknowledgment Status) (npsp__Acknowledgement_Status__c [Statut de confirmation]) pour que {!Get_Opportunity.npsp__Acknowledgment_Status__c} se trouve dans le champ Variable.
  - Opérateur : Equals (Est égal à)
  - Value (Valeur) : recherchez et sélectionnez l’élément Text Picklist Value (Valeur de liste de sélection de texte) Acknowledged (Confirmé).
- Cliquez sur + Add Assignments (+ Ajouter des attributions).
- Sur la deuxième ligne :
  - Variable (Variable) : cliquez sur Search variables… (Recherchez des variables…), puis recherchez et sélectionnez Opportunity from Get_Opportunity (Opportunité de Get_Opportunity) et npsp__Acknowledgement_Date__c (Date de confirmation) pour que {!Get_Opportunity.npsp__Acknowledgment_Date__c} se trouve dans le champ Variable.
  - Opérateur : Equals (Est égal à)
  - Value (Valeur) : cliquez sur le champ et sélectionnez la variable globale $Flow, puis Current Date (Date actuelle) afin que la valeur soit {!$Flow.CurrentDate}.
Cliquez sur .

Le flux avec l’élément Assignment (Attribution)

Cliquez sur Save (Enregistrer) dans Flow Builder pour enregistrer votre travail.

Mise à jour de l’enregistrement

Maintenant que l’élément Assignment (Attribution) stocke les valeurs, il est temps d’utiliser Update Records (Mettre à jour les enregistrements) pour placer ces valeurs sur l’opportunité d’origine à laquelle elles appartiennent.

Cliquez sur Add element (Ajouter un élément) () après l’élément Acknowledgement Status Assignment (Attribution de statut de confirmation).
Sélectionnez Update Records (Mettre à jour les enregistrements) dans la section Data (Données).
Label (Étiquette) : saisissez Update Opportunity (Mettre à jour l’opportunité)
API Name (Nom d’API) : saisissez Update_Opportunity (il devrait être généré automatiquement).
Description : saisissez Update the opportunity record and save the new Acknowledgment Status and Acknowledgment Date to the database. (Mettre à jour l’enregistrement d’opportunité et enregistrer le nouveau statut de confirmation et la date de confirmation dans la base de données.)
How to Find Records to Update and Set Their Values (Comment rechercher des enregistrements pour mettre à jour et définir leur valeur) : Use the IDs and all field values from a record or record collection (Utiliser les ID et toutes les valeurs de champ d’un enregistrement ou d’une collection d’enregistrements), la valeur par défaut.
Record or Record Collection (Enregistrement ou collection d’enregistrements) : Recherchez et sélectionnez Opportunity from Get Opportunity (Opportunité de Récupérer une opportunité).
Cliquez sur .

Votre flux comporte maintenant tous les éléments dont vous avez besoin !

Le flux terminé

Cliquez sur Save (Enregistrer) dans Flow Builder pour veiller à ne rien perdre de ce travail.

Test et débogage du flux

Avant de quitter Flow Builder, vous pouvez tester votre travail de deux manières : en cliquant sur Run (Exécuter) ou sur Debug (Déboguer).

Si vous cliquez sur Run (Exécuter), vous pourrez voir votre flux tel qu’il s’affichera pour vos utilisateurs, avec les deux écrans que vous avez créés. Il peut être utile de voir vos écrans, mais cela ne vous montre pas tout ce qui se passera dans la pratique. Pour ce flux, par exemple, l’option Run (Exécuter) ne transmet pas les détails d’un enregistrement d’opportunité au flux. Votre modèle d’e-mail apparaît donc presque vide, sans adresse e-mail de destinataire.

Si vous cliquez sur Debug (Déboguer), vous obtiendrez beaucoup plus d’options et de détails sur le flux et son fonctionnement. Le débogage est particulièrement utile pour ce flux, car vous pouvez saisir les variables dont le flux a besoin sur le premier écran. Par exemple, si vous collez un ID d’opportunité (le code à 18 caractères juste après /Opportunity/ dans l’URL) et cliquez sur Run (Exécuter) dans Debug (Déboguer), vous pouvez voir le flux avec toutes ses fonctionnalités, ainsi que des détails de débogage qui vous informent sur ce qu’est en train de faire le flux. Si vous exécutez l’intégralité du flux avec succès, la partie de l’interface où apparaît votre flux affichera All done (Terminé) et vous verrez le message Transaction Committed (Transaction engagée) sous la section Debug Details (Détails de débogage). Si vous rencontrez une erreur, les détails de débogage incluront des messages d’erreur.

Détails de débogage sur le deuxième écran du flux

Essayez les options Run (Exécuter) et Debug (Déboguer) pour voir comment elles fonctionnent. Une fois que vous avez terminé, fermez les onglets de votre navigateur pour revenir à Flow Builder.

Activation du flux

C’est le grand moment ! Activez le flux !

Dans Flow Builder, cliquez sur Activate (Activer). Voilà ! Le flux est actif !

Le flux actif dans Flow Builder

Pour autant, les utilisateurs peuvent ne pas le trouver. À l’étape suivante, vous placerez le flux sur la page d’opportunité, vous créerez un enregistrement test et vous vous enverrez l’e-mail pour voir comment tous ces éléments fonctionnent ensemble.

Pour terminer cette étape et continuer, lancez votre Trailhead Playground et cliquez sur Verify (Vérifier) pour vérifier que Update Records (Mettre à jour les enregistrements) est correctement configuré et que le flux est activé.