Ajout de plus d’options à vos écrans
Objectifs de formation
Une fois cette unité terminée, vous pourrez :
- Donner aux utilisateurs plus d’informations sur les choix avec un tableau de données
- Placer les champs d’enregistrement directement sur un écran de flux
- Placer un champ de référence sur un écran de flux
- Créer un écran qui permet aux utilisateurs de charger des fichiers
Avant de commencer
Pour les exercices de cette unité, vous avez besoin d’un champ personnalisé supplémentaire. Sur l’objet Case (Requête), créez un champ personnalisé avec ces détails.
- Type de données : Relation de recherche
- Associé à : Utilisateur
- Étiquette du champ :
QA Reviewer
(Réviseur QA) - Nom du champ :
QA_Reviewer
- Conservez les valeurs par défaut pour tous les autres paramètres
Un choix plus éclairé pour les utilisateurs
Flo a reçu davantage de commentaires de la part des équipes de support de Pyroclastic concernant le flux Create Case for Contact (Créer une requête pour un contact). Tout d’abord, elles souhaitent mettre à jour une question pour permettre aux agents de support de sélectionner plus facilement un enregistrement de contact. Ensuite, elles souhaitent ajouter des questions qui capturent le motif de la requête et le compte associé.
Lorsqu’ils choisissent parmi un groupe d’enregistrements, les utilisateurs ont souvent besoin de plus d’informations, et pas seulement du nom de l’enregistrement. Les agents de support ont besoin de plus d’informations de contact pour sélectionner le meilleur point de contact pour une requête. Ils veulent voir :
- le titre, pour confirmer que leur rôle est approprié au problème ;
- l’e-mail, afin qu’ils puissent effectuer un suivi ;
- le numéro de téléphone, afin qu’ils puissent effectuer un suivi.
Pour donner aux utilisateurs suffisamment d’informations pour choisir un enregistrement, utilisez un composant Data Table (Tableau de données). Le format de tableau présente une liste d’enregistrements organisés en lignes et les champs de l’enregistrement organisés en colonnes.
Ajout d’un composant Data Table (Tableau de données)
- Ouvrez le flux Create Case for Contact (Créer une requête pour un contact).
- Dans l’élément Create Case (Créer une requête), cliquez sur pour supprimer la ligne Contact ID (ID de contact) ← Questions Page 2 > Point of Contact (Point de contact).
- Avant l’élément Questions, ajoutez un élément Get Records (Obtenir des enregistrements) pour récupérer les contacts du compte.
- Étiquette :
Get Contacts
(Obtenir des contacts) - Objet : Contact
- Exigences de condition : Toutes les conditions sont remplies (ET)
- Champ : AccountId
- Opérateur : Égal à
- Value (Valeur) : inputAccountId
- How Many Records to Store (Nombre d’enregistrements à stocker) : Tous les enregistrements
- Ouvrez l’élément Questions Page 2 et survolez le composant Point_of_Contact. Cliquez sur pour supprimer ce composant.
- Ajoutez un composant Data Table (Tableau de données) permettant aux utilisateurs de sélectionner le bon contact.
- Faites glisser Data Table (Tableau de données) du menu latéral Components (Composants) vers la zone de dessin de l’écran.
- Pour API Name (Nom d’API), saisissez
PointOfContact
.
- Dans Label (Étiquette), saisissez
Point of Contact
(Point de contact). - Sélectionnez Use Label as the table title (Utiliser Étiquette comme titre du tableau).
- Pour Source Collection (Collection source), sélectionnez Contacts from Get_Contacts (Contacts de Get_Contacts).
- Cliquez sur Configure Rows (Configurer les lignes) pour ouvrir la section.
- Pour Row Selection Mode (Mode de sélection de ligne), sélectionnez Single (Unique).
- Sélectionnez Require user to make a selection (Nécessite une sélection par l’utilisateur).
- Cliquez sur Configure Columns (Configurer les colonnes) pour ouvrir la section.
- Pour Source Field (Champ source), sélectionnez Name (Nom) (nom et prénom).
- Avant de cliquer sur Done (Terminé), veillez à cliquer sur Done (Terminé) dans les options de colonne, et non pas en bas de la fenêtre Edit Screen (Modifier l’écran).
- Cliquez sur +Add Column (+Ajouter une colonne) et répétez les étapes j-k pour ajouter des colonnes pour les champs Title (Titre), Email (E-mail) et Phone (Business Phone) (Téléphone [Téléphone professionnel]).
- Cliquez sur Done (Terminé) pour fermer l’élément Questions Page 2.
Ajout rapide de champs existants avec une configuration minimale
Le moyen le plus efficace d’ajouter le champ d’un objet à un flux d’écran consiste à utiliser un composant Record Field (Champ d’enregistrement). (Vous avez peut-être entendu parler de cette fonctionnalité sous le nom de Formulaires dynamiques pour les flux.) Les composants Record Field (Champ d’enregistrement) ressemblent aux champs d’un objet Salesforce. Pour utiliser un composant Record Field (Champ d’enregistrement), vous choisissez une variable d’enregistrement pour indiquer l’objet, puis vous faites glisser ses champs (autant que vous le souhaitez) vers la zone de dessin de l’écran. Imaginez à quelle vitesse vous pourriez ajouter 5 ou 10 champs, ou même plus, à l’écran !
Mais si c’est si formidable que cela, pourquoi ne l’avons-nous pas mentionné plus tôt ? Eh bien, il existe certaines limites. Chaque composant Record Field (Champ d’enregistrement) hérite d’une grande partie de la configuration du champ correspondant, y compris son étiquette, ses valeurs de liste de sélection et son statut obligatoire. Vous ne pouvez pas les modifier dans le flux.
Chez Pyroclastic, les champs Description et Subject (Objet) ne sont pas définis comme champs obligatoires dans Salesforce, mais les équipes de support souhaitent les rendre obligatoires dans le flux. Étant donné que le statut obligatoire du flux ne correspond pas à celui du champ correspondant, vous ne pouvez pas utiliser les composants Record Field (Champ d’enregistrement) pour ces champs. Au lieu de cela, vous avez utilisé les composants Long Text Area (Zone de texte longue) et Text (Texte), qui disposent d’options de configuration plus flexibles.
Bien que certaines propriétés de champ soient héritées par le composant Record Field (Champ d’enregistrement) et ne puissent pas être modifiées, d’autres, telles que les valeurs par défaut et les filtres de types d’enregistrements, ne sont pas du tout reflétées dans le composant Record Field (Champ d’enregistrement). Pour plus de détails, consultez la page Ajout de champs d’enregistrement aux écrans de flux.
Ajout d’un composant de champ d’enregistrement de liste de sélection et d’un composant de champ d’enregistrement de référence
Flo a d’autres retours de la part des équipes de support de Pyroclastic. Celles-ci souhaitent désormais collecter le motif de la requête et le compte associé dans le flux Create Case for Contact (Créer une requête pour un contact). Les noms des champs, les valeurs de liste de sélection et le statut obligatoire doivent correspondre à ceux présents dans l’objet Case (Requête), ils sont donc parfaits pour les composants Record Field (Champ d’enregistrement).
Les composants Record Field (Champ d’enregistrement) sont configurés différemment des autres composants d’écran et éléments de flux. Au lieu de sélectionner directement un objet, vous utilisez une variable d’enregistrement qui correspond à un objet spécifique. Vous pouvez choisir une variable d’enregistrement existante ou en créer une autre. Pour accéder aux nouveaux champs demandés par les équipes de support, vous créez une variable d’enregistrement fondée sur l’objet Case (Requête).
- Dans l’écran Questions Page 2, cliquez sur l’onglet Fields (Champs) dans le volet gauche.
- Pour Record Variable (Variable d’enregistrement), sélectionnez +New Resource (+Nouvelle ressource).
- Pour API Name (Nom d’API), saisissez
caseVar
.
- Pour Object (Objet), sélectionnez Case (Requête).
- Cliquez sur Done (Terminé).
Le champ Record Variable (Variable d’enregistrement) contient la ressource caseVar et les champs pris en charge de la variable sont répertoriés.
- Faites glisser Case Reason (Raison de la requête) de la liste des champs vers la zone de dessin de l’écran.
- Faites glisser QA Reviewer (Réviseur QA) de la liste des champs vers la zone de dessin de l’écran.
Et voilà, vous venez d’ajouter un champ de liste de sélection et un champ de référence à votre flux d’écran, avec des noms, une configuration d’objet et des valeurs de liste de sélection déjà définis pour vous. Imaginez à quel point ce serait rapide si vous deviez ajouter 5 ou 10 champs, ou même plus !
Création d’un champ de référence avec différents paramètres
Pendant que vous conceviez ce flux d’écran, Flo a reçu une autre demande : la référence QA Reviewer (Réviseur QA) doit être obligatoire, mais uniquement dans ce flux. Le champ lui-même n’est toutefois pas défini comme obligatoire, nous ne pouvons donc pas utiliser de composant Record Field (Champ d’enregistrement). Ne vous inquiétez pas, vous pouvez utiliser un composant d’écran Lookup (Référence) à la place.
Comme les composants Record Field (Champ d’enregistrement), le composant Lookup (Référence) imite un champ de référence existant à partir d’un objet Salesforce. Cependant, le composant Lookup (Référence) offre une configuration plus précise que le composant Record Field (Champ d’enregistrement). Il permet notamment de définir une valeur par défaut et de la rendre obligatoire. Son style de configuration est également différent des autres composants, nécessitant davantage de saisie manuelle et de connaissances liées aux noms d’API de champ et d’objet. Lors de l’ajout d’un composant Lookup (Référence), vous devrez peut-être faire référence à l’objet et à ses champs dans le gestionnaire d’objet.
Remplacement d’un composant de champ d’enregistrement par un composant de référence
- Dans l’élément Questions Page 2, cliquez sur pour supprimer le champ d’enregistrement QA Reviewer (Réviseur QA) de la zone de dessin de l’écran.
- Cliquez sur l’onglet Components (Composants) dans le menu latéral gauche pour afficher la liste des composants d’écran.
- Faites glisser Lookup (Référence) du menu latéral Components (Composants) vers la zone de dessin de l’écran.
- Dans API Name (Nom d’API), saisissez
ScreenReviewer
.
- Dans Field API Name (Nom d’API du champ), saisissez
QA_Reviewer__c
.
Ce paramètre contient le nom d’API du champ de référence existant répliqué dans le flux.
- Dans Label (Étiquette), saisissez
QA Reviewer
(Réviseur QA).
- Dans Object API Name (Nom d’API de l’objet), saisissez
Case
(Requête).
Case (Requête) est le nom d’API de l’objet qui contient le champ de référence existant.
- Pour Record ID (ID d’enregistrement), sélectionnez $User> Id.
Ce paramètre détermine où le flux stocke la valeur sélectionnée par l’utilisateur. La valeur que vous définissez ici devient la valeur par défaut lors de l’exécution du flux. Dans ce cas, lorsque le flux s’exécute, le composant QA Reviewer Lookup (Référence de réviseur QA) a l’ID de l’utilisateur actif comme valeur par défaut.
- Pour Required (Obligatoire), sélectionnez $GlobalConstant.True.
- Cliquez sur Terminé.
Vous avez terminé ! La recherche et la configuration du composant Lookup (Référence) prennent un peu plus de temps que pour un composant Record Field (Champ d’enregistrement). Néanmoins, elles vous permettent de mener la tâche à bien et vous offrent quelques options de configuration supplémentaires.
Mise à jour de l’élément de création d’enregistrements
Pour utiliser les valeurs collectées par les nouveaux composants d’écran, vous devez ajouter leurs valeurs de champ à l’élément qui crée la requête. Chaque composant d’écran a une manière spécifique de référencer les réponses d’un utilisateur actif. Vous avez référencé directement les composants Text (Texte) et Long Text Area (Zone de texte longue). Les trois composants que vous avez ajoutés dans cette unité introduisent trois autres façons de référencer les valeurs des composants. Décomposons chacun d’entre eux au fur et à mesure que vous ajoutez le point de contact, le motif et le réviseur QA à l’élément Create Case (Créer une requête).
Obtention de la valeur d’un composant de tableau de données
- Ouvrez l’élément Create Case (Créer une requête).
- Sous Set Field Values (Définir les valeurs de champ), cliquez sur +Add Field (+Ajouter un champ).
- Pour Field (Champ), sélectionnez Contact ID (ID de contact).
- Pour Value (Valeur), sélectionnez Questions Page 2> Point of Contact (Point de contact)> First Selected Row (Première ligne sélectionnée)> Contact ID (ID de contact).
La valeur Contact ID (ID de contact) souhaitée a été sélectionnée dans un tableau de données où chaque ligne (enregistrement de contact) comporte plusieurs colonnes (valeurs de champ). L’élément Create Records (Créer des enregistrements) doit savoir quel champ utiliser dans la ligne du tableau sélectionnée.
Lorsqu’un tableau de données est configuré de façon à permettre aux utilisateurs de sélectionner plusieurs enregistrements, Flow Builder utilise l’enregistrement que l’utilisateur a sélectionné en premier (qui n’est pas nécessairement le premier enregistrement de manière séquentielle).
Obtention de la valeur d’un composant de référence
- Cliquez sur +Add Field (+Ajouter un champ).
- Pour Field (Champ), sélectionnez QA Reviewer (Réviseur QA).
- Pour Value (Valeur), sélectionnez Questions Page 2 > QA Reviewer (Réviseur QA)> Record ID (ID d’enregistrement).
Vous définissez QA Reviewer (Réviseur QA) à partir d’un composant Lookup (Référence). Contrairement à d’autres composants, tels que la zone de texte longue et les cases d’option, le composant Lookup (Référence) a plusieurs valeurs potentielles à référencer. Comme vous définissez la valeur d’un champ Lookup (Référence) qui nécessite un ID d’enregistrement, vous sélectionnez le paramètre Record ID (ID d’enregistrement) du composant.
Obtention de la valeur d’un composant de champ d’enregistrement
Avec la plupart des composants d’écran, la valeur saisie par l’utilisateur est stockée dans le composant. Pour référencer cette valeur dans un élément de données, vous sélectionnez le composant ou un champ dans ce composant. Le composant Point of Contact (Point de contact) permet par exemple aux utilisateurs de sélectionner un enregistrement pour que sa valeur soit stockée dans le champ ID du composant. Lorsque vous souhaitez référencer la valeur d’un composant dans un autre élément, vous devez sélectionner l’écran qui contient le composant d’écran, puis sélectionner le composant.
Le composant Record Field (Champ d’enregistrement) est un peu différent. Pour un composant Record Field (Champ d’enregistrement), la valeur n’est pas stockée dans le composant lui-même, mais dans la variable d’enregistrement associée au composant. Par exemple, le motif de la requête sélectionné est stocké dans la variable d’enregistrement caseVar que vous avez choisie lorsque vous avez ajouté le champ d’enregistrement Case Reason (Motif de la requête) à l’écran.
Lorsque vous définissez des valeurs de champ dans un élément de données, pour un composant Record Field (Champ d’enregistrement), vous effectuez une sélection dans la section Record Variables (Variables d’enregistrement) de la liste de sélection Value (Valeur).
- Cliquez sur +Add Field (+Ajouter un champ).
- Pour Field (Champ), sélectionnez Case Reason (Motif de la requête).
- Pour Value (Valeur), sélectionnez caseVar> Case Reason (Motif de la requête).
Vos nouvelles valeurs de champ pour la requête doivent ressembler à ceci.
Autorisation des utilisateurs à charger des fichiers
Avant de terminer cette unité, il reste une dernière fonctionnalité à ajouter au flux. Durant leurs discussions avec les clients, les agents de support leur envoient parfois des captures d’écran ou d’autres images pour les aider à résoudre leurs problèmes. Ils souhaitent joindre ces images à la requête.
Le composant d’écran File Upload (Chargement de fichier) fait exactement ce que son nom indique : il charge des fichiers dans Salesforce. Pour associer les fichiers chargés à la requête créée, vous ajoutez le composant File Upload (Chargement de fichier) à un élément Screen (Écran) qui vient après l’élément qui crée la requête. Sinon, il n’existe pas de requête dans laquelle charger des fichiers, et le chargement échoue.
Ajout d’un écran avec un bouton de chargement
- Ajoutez un élément Screen (Écran) après l’élément Create Case (Créer une requête).
- Dans Label (Étiquette), saisissez
File Upload Screen
(Écran de chargement de fichier).
- Faites glisser le composant File Upload (Chargement de fichier) vers la zone de dessin de l’écran.
- Pour API Name (Nom d’API), saisissez
UploadImages
.
- Dans File Upload Label (Étiquette de chargement de fichier), saisissez
The case has been created. Do you have any related files to upload to it?
(La requête a été créée. Avez-vous des fichiers associés à charger dedans ?) - Pour Autoriser des fichiers multiples, sélectionnez $GlobalConstant.True.
- Pour Related Record ID (ID d’enregistrement associé), sélectionnez CaseId from Create_Case.
- Cliquez sur Terminé.
- Enregistrez le flux.
Généralement, après avoir collecté une entrée dans un élément d’écran, vous avez besoin d’un élément de données (tel que Create Records [Créer des enregistrements] ou Update Records [Mettre à jour les enregistrements]) pour enregistrer cette entrée dans un enregistrement Salesforce. Eh bien, il s’agit d’une exception. Le nouvel élément d’écran contient uniquement le composant File Upload (Chargement de fichier), et celui-ci enregistre automatiquement les fichiers. Ainsi, lorsque les utilisateurs exécutent le flux et chargent des fichiers, ceux-ci sont immédiatement joints à la requête.
Ressources
- Aide Salesforce : Composant d’entrée de l’écran de flux : Une table de données
- Aide Salesforce : Ajout de champs d’enregistrement aux écrans de flux
- Aide Salesforce : Composant d’entrée de l’écran de flux : Référence
- Aide Salesforce : Composant d’entrée de l’écran de flux : Chargement de fichier