Obtention d’enregistrements et création d’un modèle d’e-mail

Remarque

Vous souhaitez apprendre en français ? Commencez le défi dans un Trailhead Playground en français et utilisez les traductions fournies entre crochets pour naviguer. Copiez et collez uniquement les valeurs en anglais, car les validations de défi reposent sur les données en anglais. Si vous ne réussissez pas le défi dans votre organisation en français, nous vous recommandons (1) de définir le paramètre régional sur les États-Unis, (2) de définir la langue sur l’anglais en suivant les instructions ici, puis (3) de cliquer à nouveau sur le bouton « Vérifier le défi ».

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

Récupération des données dont vous avez besoin

Pour le moment, votre flux contient un écran demandant aux utilisateurs s’ils souhaitent confirmer la réception d’une opportunité. Mais quelle opportunité, exactement ?

Vous utilisez l’élément Get Records (Obtenir des enregistrements) pour récupérer des détails sur l’enregistrement d’opportunité sur lequel l’utilisateur se trouve lorsqu’il démarre le flux. Un élément Get Records (Obtenir des enregistrements) indique au flux sur quels enregistrements vous souhaitez obtenir plus d’informations.

Pour tout flux d’écran lancé à partir d’une page d’enregistrement, comme celle que vous créez, vous devez récupérer l’ID d’enregistrement pour l’insérer dans une variable, qui stocke le texte ou d’autres informations que vous devez utiliser dans le flux. Vous transmettrez ensuite cette variable au flux et l’utiliserez comme critère déterminant les enregistrements que vous obtenez.

Ajoutez maintenant le nouvel élément à la zone de dessin et créez votre variable.

1. Dans la zone de dessin du flux, sur le chemin après l’écran de lancement, cliquez sur .
   
2. Sélectionnez Get Records (Obtenir des enregistrements) dans la section Data (Données).
   
3. Dans l’interface New Get Records (Nouveau Obtenir des enregistrements), saisissez les informations suivantes.
   

• Label (Étiquette) : Get Opportunity (Obtenir une opportunité)
• API Name (Nom d’API) : Get_Opportunity (il devrait être généré automatiquement).
  
• Description : Look up all field values from the opportunity, whose ID is passed from the opportunity record to the flow in a text variable. (Recherchez toutes les valeurs de champ de l’opportunité, dont l’ID est transmis de l’enregistrement d’opportunité au flux dans une variable de texte.)
• Get Records of This Object (Récupérer les enregistrements de cet objet) : Sélectionnez Opportunity (Opportunité). La section Filter Opportunity Records (Filtrer les enregistrements d’opportunité) apparaît.
  
  
• Condition Requirements (Exigences de condition) : Toutes les conditions sont remplies (ET)
  
• Field (Champ) : Sélectionnez Id (Opportunity ID) (ID [ID d’opportunité])
  
• Opérateur : Equals (Est égal à)
  
• Value (Valeur) : Cliquez sur + New Resource (+ Nouvelle ressource). Saisissez les informations suivantes :
  

• Resource Type (Type de ressource) : Variable
  
• API Name (Nom d’API) : recordId.
  Ce nom d’API est sensible à la casse et est une variable réservée pour l’ID d’enregistrement. Assurez-vous qu’il est formaté exactement sous la forme recordId, avec un I majuscule et un d minuscule.
  
• Data Type (Type de données) : Texte
  
• Availability Outside the Flow (Disponibilité hors du flux) : Sélectionnez Available for input (Disponible pour l’entrée).
  Les données de cette variable proviennent de la page d’opportunité.
  
• Cliquez sur Done (Terminé). {!recordId} apparaîtra automatiquement dans le champ Value (Valeur). (Il peut apparaître au format .)
  

• How Many Records to Store (Nombre d’enregistrements à stocker) : sélectionnez Only the first record (Uniquement le premier enregistrement), la valeur par défaut.
  
• How to Store Record Data (Comment stocker les données d’enregistrement) : sélectionnez Automatically store all fields (Stocker automatiquement tous les champs), la valeur par défaut.
  

4. Cliquez sur .
   

Vous venez d’indiquer à l’élément Get Records (Obtenir des enregistrements) que vous voulez rechercher le seul enregistrement d’opportunité qui correspond à la variable d’ID d’opportunité que vous venez de définir, puis stocker tous les champs de données. Cela vous aidera plus tard, lorsque tous les champs de l’enregistrement seront disponibles pour votre e-mail.

Ce même concept est applicable à différents scénarios : par exemple, vous pourriez mettre en place des critères complètement différents, comme la recherche d’opportunités d’une valeur supérieure à 100 $ dont le contact principal réside dans une zone particulière. 

Cliquez sur Save (Enregistrer) dans Flow Builder de sorte à bien enregistrer votre travail.

Création du modèle d’e-mail

Créez maintenant une autre variable : votre modèle d’e-mail.

Pour commencer, accédez à l’onglet Manager (Gestionnaire) dans la section Toolbox (Boîte à outils) de Flow Builder. S’il est fermé, vous pouvez l’ouvrir en cliquant sur . Ici, vous pouvez voir toutes les ressources et les éléments que vous avez utilisés jusqu’à présent. Remarquez la variable recordId que vous venez de créer.

Créez maintenant votre ressource directement depuis le gestionnaire.

1. Cliquez sur New Resource (Nouvelle ressource).
   
2. Sélectionnez Text Template (Modèle de texte) dans Resource Type (Type de ressource). Le type de ressource Text Template (Modèle de texte) est utilisé pour stocker du texte qui peut être modifié et utilisé tout au long du flux, tout comme votre modèle d’e-mail.
   
3. API Name (Nom d’API) : emailBody
4. Description : This is the email template to send to acknowledge the gift. (Il s’agit du modèle d’e-mail à envoyer pour confirmer la réception du don.)

Vous en êtes maintenant au corps de l’e-mail. Tout d’abord, assurez-vous que la valeur par défaut View as Rich Text (Afficher en texte enrichi) est sélectionnée.

Dans l’éditeur de texte, commencez par saisir Dear suivi d’une espace. 

Vous devez récupérer les détails de l’enregistrement d’opportunité et de l’enregistrement de contact associé pour en faire un véritable modèle. Toutes ces informations sont stockées dans une variable d’enregistrement, un type spécial de variable que l’élément Get Records (Obtenir des enregistrements) a créé pour conserver les détails d’un enregistrement Salesforce. 

Commencez par récupérer le nom du donateur. La variable d’enregistrement contient des détails sur l’enregistrement d’opportunité et tout enregistrement associé. Vous devrez donc rechercher l’enregistrement de contact principal associé à l’opportunité, puis le nom du donateur.

1. Cliquez sur la barre de recherche Insert a resource… (Insérer une ressource…).
   
2. Cliquez sur Opportunity from Get_Opportunity (Opportunité de Get_Opportunity), la variable d’enregistrement créée par l’élément Get Records (Obtenir des enregistrements). Comme vous avez choisi de stocker tous les champs, vous pouvez sélectionner n’importe quel champ de l’enregistrement.
   
3. Après avoir cliqué sur Opportunity from Get_Opportunity (Opportunité de Get_Opportunity), des champs et des enregistrements associés apparaîtront dans l’enregistrement d’opportunité. Vous devez sélectionner l’enregistrement de contact principal. Commencez à saisir les premières lettres de npsp__Primary_Contact__r (Contact principal) et faites défiler pour rechercher et sélectionner l’expression complète. Une flèche () doit se trouver en regard de l’enregistrement pour montrer que vous pouvez sélectionner des champs à l’intérieur de celui-ci.
   
   
4. Vous devez maintenant sélectionner le champ du prénom dans l’enregistrement de contact principal associé à l’opportunité. Commencez à saisir ou faites défiler vers le bas pour rechercher et sélectionner FirstName (Prénom).
   
5. Dans le champ Body (Corps), l’expression suivante devrait apparaître : {!Get_Opportunity.npsp__Primary_Contact__r.FirstName}
   

De la même manière, vous pouvez récupérer les valeurs Amount (Montant) et Close Date (Date de fermeture) à partir de l’enregistrement d’opportunité dans votre modèle, qui ne sont qu’une couche en dessous de Opportunity from Get_Opportunity (Opportunité de Get_Opportunity).

1. Cliquez sur la barre de recherche Insert a resource… (Insérer une ressource…).
   
2. Cliquez sur Opportunity from Get_Opportunity (Opportunité de Get_Opportunity).
   
3. Commencez à saisir les premières lettres de Amount (Montant) et faites défiler pour rechercher et sélectionner l’expression complète. {!Get_Opportunity.Amount} apparaîtra dans le champ Body (Corps).
   
4. Cliquez sur la barre de recherche Insert a resource… (Insérer une ressource…).
   
5. Cliquez sur Opportunity from Get_Opportunity (Opportunité de Get_Opportunity).
   
6. Commencez à saisir les premières lettres de CloseDate (Date de fermeture) et faites défiler pour rechercher et sélectionner l’expression complète. {!Get_Opportunity.CloseDate} apparaîtra dans le champ Body (Corps).
   

Vous pouvez également renvoyer des détails sur l’utilisateur Salesforce qui a démarré le flux. Par exemple, vous voulez que cet e-mail soit signé par la personne qui l’envoie. Vous pouvez utiliser la variable globale $User pour le faire. 

Essayez en procédant comme suit :

1. Cliquez sur la barre de recherche Insert a resource… (Insérer une ressource…).
   
2. Recherchez et sélectionnez $User.
   
3. Recherchez et sélectionnez FirstName (Prénom). {!$User.FirstName} devrait apparaître dans le corps du modèle de texte.
   
4. Cliquez de nouveau sur la barre de recherche Insert a resource… (Insérer une ressource…).
   
5. Recherchez et sélectionnez $User.
   
6. Recherchez et sélectionnez LastName (Nom). {!$User.LastName} devrait apparaître dans le corps du modèle de texte.
   

En utilisant les données issues de tous ces champs, vous pouvez ajouter un autre texte et créer un modèle de texte comme celui-ci :

Dear {!Get_Opportunity.npsp__Primary_Contact__r.FirstName},
Thank you for your generous gift of ${!Get_Opportunity.Amount} on {!Get_Opportunity.CloseDate}. Your support of our capital campaign helps us make sure everyone in our community has enough food and an affordable place to live.
Sincerely,
{!$User.FirstName} {!$User.LastName}
No More Homelessness
No goods or services were received in return for this gift. No More Homelessness is a public charity recognized as tax-exempt by the IRS under Section 501(c)(3), and your gift may be tax-deductible. Please save this acknowledgment and consult a tax advisor if you can deduct this donation.

Pas mal, non ?

Dans votre modèle de texte, vous pouvez simplement copier et coller le texte ci-dessus, mais nous vous suggérons d’utiliser les mêmes ressources pour rédiger votre propre e-mail et ajouter une mise en forme de texte enrichi. N’oubliez pas de mettre un retour entre chaque ligne afin d’éviter que votre e-mail apparaisse avec une espace en trop entre chaque paragraphe.

Pour réussir cette étape du projet, vous devez utiliser les mêmes ressources de variables globales et d’enregistrement que celles de l’exemple. C’est à vous de choisir le texte que vous utilisez dans votre e-mail.

Une fois le modèle terminé, cliquez sur Done (Terminé).

Ensuite, de retour dans Flow Builder, cliquez sur Save (Enregistrer) pour enregistrer votre progression avec ce flux.

À l’étape suivante, vous configurez un aperçu pour vérifier le contenu de votre e-mail, puis l’envoyer à votre destinataire.

Pour terminer cette étape et continuer, lancez votre Trailhead Playground et cliquez sur Verify (Vérifier) pour vérifier que votre élément Get Records (Obtenir des enregistrements) et le modèle de texte ont été enregistrés correctement. 

Ressources

• Aide Salesforce : Élément de flux : Obtention d’enregistrements
• Aide Salesforce : Ressource de flux : Modèle de texte
• Vidéo : Élément de flux : Obtention d’enregistrements