Résolution des problèmes causés par une valeur nulle dans un flux
Objectifs de formation
Une fois cette unité terminée, vous pourrez :
- Répertorier les ressources pour rechercher des solutions
- Utiliser des ressources en dehors de l’organisation pour réparer le flux interrompu
- Expliquer l’importance de prendre en compte une valeur nulle
Bon déroulement du flux
Parfois, le problème est plus compliqué qu’un problème d’autorisation utilisateur. Le problème peut provenir de nombreux éléments, comme une logique défectueuse, de mauvaises données d’entrée ou l’absence de prise en compte des valeurs vides. Comme nous l’avons vu précédemment, même le problème le plus infime peut « rompre » le flux. Tous les éléments, les grands comme les petits, doivent faire leur travail, sinon le flux ne fonctionnera pas comme prévu.
Le problème
En tant qu’administrateur, vous avez configuré un flux pour envoyer un e-mail au propriétaire du compte chaque fois qu’un nouveau contact est ajouté à un compte qu’il possède. Cependant, les utilisateurs doivent désormais saisir des contacts qui ne sont pas associés à un compte. Le flux semble être correctement configuré, mais les utilisateurs continuent de recevoir un message d’erreur lors de l’ajout d’un contact sans compte associé. Comme vous l’avez fait auparavant, examinez le flux et exécutez la fonctionnalité de débogage pour voir ce qu’il se passe.
Enquête sur le flux interrompu
Suivez ces étapes pour vous familiariser avec ce flux interrompu.
- En fonction de votre navigateur, fermez la fenêtre ou l’onglet de débogage et revenez à l’écran Flow Builder.
- Cliquez sur back (retour) dans le générateur d’application.
- Cliquez sur le flux Alert Acct Owner of New Contact Added (Alerter le propriétaire du compte de l’ajout d’un nouveau contact).
- Examinez ce que ce flux tente d’accomplir.
Examinons plus en détail les actions de ce flux.
- Cliquez sur l’onglet Manager (Gestionnaire) dans la section de la boîte à outils.
- Cliquez sur l’action Email_Acct_Owner.
- Examinez ce que cette action tente de faire. Elle enverra un e-mail avec un corps et un sujet pré-remplis. Cependant, nous souhaitons que l’e-mail soit envoyé au propriétaire du compte associé.
- Supprimez le contenu de la zone de texte Recipient Address List (Liste d’adresses de destinataire).
- Saisissez
record
(enregistrement) dans la zone de texte Email Addresses (comma-separated) [Adresses e-mail (séparées par une virgule)] et sélectionnez Triggering Contact (Déclenchement du contact). Sélectionnez ensuite Account ID (ID du compte), puis Owner ID (ID du propriétaire), et enfin Email (E-mail).
- Cliquez sur Save As New Version (Enregistrer sous une nouvelle version), puis sur Save (Enregistrer).
- Cliquez sur Debug (Déboguer).
- Cliquez sur Exécuter.
- Cliquez sur Expand All (Agrandir tout) dans les détails du débogage.
Et… euh, rien ? « Aucun enregistrement déclenchant n’a été spécifié. Par conséquent, le flux n’a pas été exécuté », c’est-à-dire ? Ce flux ne peut pas être déclenché lors du débogage, car le débogage ne peut pas créer de contact. Sans nouveau contact, le flux n’est jamais déclenché. Que pouvez-vous faire pour y remédier ? Il est temps de procéder à un dépannage traditionnel. Première étape, recréer le problème rencontré par vos utilisateurs.
Activez le flux, ajoutez un contact sans compte associé et observez ce qu’il se passe.
- En fonction de votre navigateur, fermez la fenêtre ou l’onglet de débogage et revenez à l’écran Flow Builder.
- Cliquez sur Activer.
- Dans Setup (Configuration), cliquez sur le lanceur d’application.
- Sélectionnez Sales (Ventes) et cliquez sur l’onglet Contacts.
- Cliquez sur Nouveau.
- Saisissez ce qui suit :
- Prénom :
Steve
- Nom de famille :
Rogers
- Compte : [laissez vide]
- Cliquez sur Save (Enregistrer).
- Examinez le message d’erreur.
- Copiez la partie du message d’erreur indiquant « 0 recipients (0 destinataire) » (vous en aurez besoin plus tard). Laissez la fenêtre New contact (Nouveau contact) ouverte.
Maintenant que vous avez vu le message d’erreur, ajoutez un compte à ce nouveau contact pour voir comment le flux fonctionne dans des conditions idéales.
- Saisissez
GenePoint
sous Account Name (Nom du compte).
- Sélectionnez GenePoint dans la liste de sélection.
- Cliquez sur Save (Enregistrer).
Vous devriez maintenant avoir deux nouveaux e-mails dans votre boîte de réception. Le premier est un e-mail d’erreur provenant de la tentative d’enregistrement du contact sans avoir associé un compte. Lorsqu’un flux échoue, Salesforce envoie un e-mail à l’administrateur (sauf indication contraire) qui inclut le message d’erreur de l’échec et des détails sur chaque élément du flux exécuté par l’interview de flux.
Comme vous pouvez le voir dans l’e-mail d’erreur de flux, un problème survient lorsque le flux recherche l’e-mail du propriétaire du compte. C’est parfaitement logique. Le flux ne parvient pas à trouver l’adresse e-mail du propriétaire du compte, car aucun compte n’a été associé au nouveau contact. S’il n’y a pas de compte, il n’y a pas d’adresse e-mail de propriétaire du compte. Prenez également note de l’erreur de flux : cliquez ici pour déboguer dans le lien Flow Builder afin de voir la visualisation du parcours suivi par le flux. Ceci est particulièrement utile lorsque votre flux comporte de nombreuses branches.
Le deuxième e-mail est le résultat du flux déclenché correctement. Vous avez ajouté le nouveau contact avec un compte associé. Vous êtes également le propriétaire du compte GenePoint, vous recevez donc l’alerte par e-mail. Remarque : cette organisation a été configurée pour garantir la réussite de la remise des e-mails aux propriétaires de comptes. Si vous implémentez cette idée dans une organisation de production (testez-la d’abord dans une organisation sandbox !), vous devrez peut-être effectuer les réglages suivants : Setup > Email > Deliverability > unselect Activate bounce management (Configuration > Messagerie > Délivrabilité > désélectionnez Activer la gestion des rebonds) et Setup > Email > Deliverability > unselect Enable compliance with standard email security mechanisms (Configuration > Messagerie > Délivrabilité > désélectionnez Activer la conformité avec des dispositifs standard de sécurité de la messagerie) pour garantir la remise des e-mails.
Le flux s’est déroulé comme prévu et a informé le propriétaire du compte (vous) qu’un nouveau contact avait été associé à un compte que vous possédez. En tant qu’administrateur, vous ne seriez probablement pas également le propriétaire du compte, mais dans le cadre de cette formation, cet exemple vous permet de voir le flux sous tous les angles.
De l’aide à disposition
Même si la situation semble désespérée, tout n’est pas perdu. De l’aide est à disposition. Il existe de nombreuses ressources au-delà de la fonctionnalité de débogage pour vous aider à réparer votre flux interrompu. Retroussez vos manches et explorez certaines ressources.
-
E-mail d’erreur de flux : cette ressource importante vous donne des détails sur votre problème de flux et est extrêmement utile lors du dépannage. L’e-mail comprend le message d’erreur de l’échec, des détails sur chaque élément du flux exécuté par l’interview de flux ainsi qu’un lien vers la visualisation du flux échoué.
-
Aide Salesforce : effectuez des recherches parmi des articles Knowledge, des meilleures pratiques, des problèmes connus et bien plus encore. Cette ressource vous permet de réaliser des recherches au sein d’articles ainsi que de publications de la communauté. Après avoir examiné l’e-mail d’erreur de flux, elle doit être votre prochaine étape lors du dépannage d’un flux interrompu.
-
Groupes de la Trailblazer Community : bien qu’il ne s’agisse pas nécessairement d’une ressource permettant d’obtenir une solution immédiate à vos problèmes de dépannage, ces groupes d’utilisateurs constituent une mine d’informations et de connaissances. Les membres du groupe se constituent un réseau, apprennent ensemble, échangent des idées et résolvent des problèmes.
-
Documentation des développeurs Salesforce : la source de référence pour les développeurs Salesforce. La documentation des développeurs mérite toujours d’être étudiée, car il existe des pépites de connaissances qu’un administrateur tel que vous peut utiliser.
Puisque vous avez déjà examiné l’e-mail d’erreur de flux, votre prochaine étape est l’aide Salesforce. Utilisez la fonctionnalité de recherche pour trouver des articles d’aide, des publications pertinentes ou des rubriques Trailhead.
- Accédez à help.salesforce.com.
- Saisissez le message d’erreur que vous avez copié auparavant dans la barre de recherche :
0 recipients
(0 destinataire).
- Appuyez sur Entrée.
- Cochez la case Knowledge Articles (Articles Knowledge) pour filtrer uniquement les résultats des articles Knowledge.
- Cliquez sur l’article Knowledge intitulé : Error 'Probably Limit Exceeded or 0 recipients' in a Flow with a Send Email or Email Alert Action (Erreur « Limite probablement dépassée ou 0 destinataire » dans un flux comportant une action Envoyer un e-mail ou Alerte par e-mail)
- Lisez l’article Knowledge.
Valeur nulle, aucun problème
L’article répertorie trois façons de faire fonctionner votre automatisation lorsque vous obtenez cette erreur.
- Créez une règle de validation pour exiger que le champ ait une valeur.
- Rendez le champ obligatoire.
- Mettez à jour votre flux de sorte que l’alerte par e-mail ne se déclenche que lorsque le champ d’e-mail a une valeur.
Les deux premières options ne sont pas des solutions viables dans votre situation, car elles ne permettent pas aux utilisateurs d’avoir légitimement besoin de saisir un nouveau contact qui n’a pas de compte associé. La meilleure option est la troisième : envoyez une alerte par e-mail uniquement lorsque le champ d’e-mail a une valeur. Cela signifie que votre flux doit tenter d’envoyer un e-mail au propriétaire du compte uniquement lorsque le compte existe.
- Dans votre organisation, cliquez sur l’icône de configuration en forme d’engrenage et sélectionnez Setup (Configuration).
- Saisissez
flows
(flux) dans la zone Quick Find (Recherche rapide), puis sélectionnez Flows (Flux).
- Cliquez sur Alert Acct Owner of New Contact Added (Alerter le propriétaire du compte de l’ajout d’un nouveau contact).
- Cliquez sur Edit (Modifier) en regard d’Object: Contact (Objet : Contact).
- Dans la liste de sélection Condition Requirements (Exigences de condition), sélectionnez All Conditions Are Met (AND) (Toutes les conditions sont remplies [ET]).
- Cliquez dans la zone de texte Field (Champ) et sélectionnez AccountId.
- Remplacez l’opérateur par Is Null (Est nul).
- Cliquez dans la zone de texte Value (Valeur) et sélectionnez $GlobalConstant.False.
- Cliquez sur Save As New Version (Enregistrer sous une nouvelle version)
- Assurez-vous que A New Version (Une nouvelle version) est sélectionnée.
- Laissez toutes les autres options telles quelles.
- Cliquez sur Save (Enregistrer).
- Cliquez sur Activer.
Vous avez ajouté une condition à l’objet contact indiquant au flux de ne pas passer à l’étape suivante si AccountID est nul (vide) et donc de ne pas tenter d’envoyer un e-mail au propriétaire du compte. Ensuite, vérifiez que votre correctif fonctionne en saisissant un contact sans compte associé.
- Fermez l’onglet ou la fenêtre Flow Builder.
- Dans Setup (Configuration), cliquez sur le lanceur d’application.
- Sélectionnez Sales (Ventes) et cliquez sur l’onglet Contacts.
- Cliquez sur Nouveau.
- Saisissez ce qui suit :
- Prénom :
Lily
- Nom de famille :
Mason
- Compte : [laissez vide]
- Cliquez sur Save (Enregistrer).
Pas de message d’erreur ! Encore des confettis. Vous avez réparé le flux défectueux. Le flux ne produit pas d’erreur si le champ de compte d’un nouveau contact est vide. Mais si un utilisateur ajoute un nouveau contact avec un compte associé, le propriétaire du compte reçoit une notification par e-mail comme prévu. Remarque : si vous souhaitez vous assurer que le flux envoie uniquement des e-mails aux propriétaires de comptes qui sont des utilisateurs actifs, ajoutez un élément de décision (actif ou inactif) avant l’élément d’e-mail. Apprenez-en davantage sur Élément de flux - Décision dans l’aide Salesforce.
Vous avez corrigé tous les flux volontairement interrompus. Vous avez effectué un débogage au nom d’un autre utilisateur, utilisé l’aide Salesforce pour trouver une réponse et ajouté un filtre à un objet dans un flux pour prendre en compte une valeur nulle. Si seulement il était aussi facile de monter des meubles…
Ressources
- Site Web : Salesforce Help
- Site Web : Groupes de la communauté Trailblazer
- Site Web : Documentation des développeurs Salesforce
- Trailhead : Élaboration de flux avec Flow Builder
- Aide Salesforce : Élément de flux - Décision