Dépannage de problèmes avec l’attribution automatique dans Maps

Prérequis :

Attribution automatique

Géocodage d’enregistrements

Commencez par vérifier si vos enregistrements ont été géocodés. Plus précisément, les enregistrements doivent avoir une valeur de latitude et de longitude valide. Par exemple, vérifiez ce qui suit sur l’un de vos enregistrements Compte :

Ouvrez l’un de vos enregistrements de compte Salesforce.
Vérifiez si les valeurs des champs Latitude et Longitude sont saisies.

Remarque : les champs Latitude et Longitude peuvent être masqués dans une présentation de page actuelle.

Si les valeurs de latitude et de longitude de l’enregistrement sont disponibles et valides, celui-ci doit fonctionner correctement avec l’attribution automatique.

Si vos enregistrements n’ont pas de valeurs Latitude et Longitude, vérifiez qu’ils sont géocodés. Cette manipulation est aussi simple que le traçage d’un enregistrement dans Salesforce Maps (consultez Traçage d’une couche de marqueurs). Si vous voyez qu’un enregistrement ne se géocode pas, consultez l’article Création d’un objet de base.

Configuration des champs Latitude et Longitude

Vous devez aussi vérifier que les champs de latitude et de longitude de vos enregistrements sont correctement configurés. Par exemple, les enregistrements Compte ont les champs Latitude/Longitude de facturation et Latitude/Longitude de livraison disponibles. En fonction de la configuration de vos Objets de base dans Salesforce Maps, vous devez vous assurer que la configuration de l’attribution automatique renvoie vers les bons champs.

Par exemple, supposons que les valeurs de latitude et de longitude de vos enregistrements Compte se trouvent sur les champs Latitude/Longitude de livraison. Si l’attribution automatique renvoie vers les champs Latitude/Longitude de facturation, l’enregistrement pourrait ne pas être correctement attribué. Pour résoudre ce problème, accédez à votre plan d’attribution.

Ouvrez la configuration Salesforce.
Accédez à Packages installés.
Cliquez sur Configurer en regard du package Salesforce Maps.
Choisissez Attribution automatique dans le menu latéral de gauche.
Créez/modifiez votre Plan d’attribution.
Vérifiez les valeurs du champ Latitude et du champ Longitude et assurez-vous qu’elles sont correctement mappées.

Notez que les champs Latitude et Longitude affichent une liste des champs numériques disponibles sur l’enregistrement. Assurez-vous qu’ils renvoient vers les champs appropriés (il est vite arrivé de les annuler accidentellement ou de les renvoyer vers les mauvais champs).

Réattribution d’enregistrements

Supposons que vous avez attribué un ensemble d’enregistrements. Vous souhaitez peut-être l’attribuer à un autre utilisateur. Notez que si vous créez simplement une règle d’attribution et exécutez le plan d’attribution, vous ne verrez peut-être pas vos enregistrements changer de propriétaire. Pourquoi cela ?

Le lot d’attribution automatique ignorera les enregistrements qui ont déjà été attribués une fois. Ce comportement permet à votre organisation Salesforce de rester efficace en l’empêchant d’exécuter des processus inutiles. Afin de permettre à vos enregistrements d’être réattribués, consultez Mise à jour des champs d’attribution automatique.

Capture des messages d’erreur associés au plan d’attribution automatique

Après avoir exécuté le plan d’attribution automatique, il est possible que le plan échoue pour une quelconque raison. Vous pouvez accéder à l’enregistrement de l’exécution du plan depuis Packages installés -> Salesforce Maps-> Configurer-> Attribution automatique, puis cliquez sur l’onglet Plans planifiés. De là, trouvez le plan d’attribution automatique et cliquez sur le nom du plan pour afficher les messages d’erreur détaillés. Voici quelques exemples de messages d’erreur que vous pouvez voir :

Aucun territoire ne croise le point (x, y) : il s’agit d’un comportement normal. L’enregistrement n’a pas été trouvé dans le territoire donné.
Territoire avec croisement trouvé pour l’enregistrement, mais une erreur est survenue pendant la mise à jour DML : il existe peut-être une règle de validation active sur l’enregistrement que vous tentez d’attribuer. (Il est d’usage que les administrateurs Salesforce empêchent certains utilisateurs de modifier la propriété de certains enregistrements).
Erreur d’appel externe : il existe peut-être des problèmes de connectivité avec Salesforce Maps ou nos serveurs.
Latitude ou Longitude non valide : cette erreur est déclenchée lorsque les champs numériques personnalisés sont utilisés comme Latitude et Longitude dans le plan d’attribution et si les coordonnées de latitude ne se situent pas dans la plage de -90 à +90 ou si les coordonnées de longitude ne se situent pas dans la plage de -180 à +180.
Code du statut Bad Request et message d’erreur "propriété requise manquante dans le corps de la requête", "data":{"property":"/rules/1/shape/id"}: Cette erreur est déclenchée lorsqu’il n’y a pas de géométries (périmètres) dans la couche de forme mappée dans la règle d’attribution. Les couches de forme utilisées pour des règles d’attribution automatique doivent être vérifiées dans Maps.
Remarque : si l’utilisateur associé dans la règle est désactivé, un administrateur doit vérifier les plans d’attribution et désactiver les règles d’attribution ou modifier l’utilisateur.

Remarque : vous pouvez également générer un rapport sur les enregistrements pour lesquels l’attribution automatique n’a pas pu attribuer des enregistrements en raison de valeurs de latitude et de longitude non valides. Pour ce faire, créez un champ Zone de texte sur l’objet souhaité et mappez ce champ au plan d’attribution sous le champ Notification. Une fois que le plan d’attribution s’exécute, si l’attribution d’un enregistrement échoue en raison d’une latitude ou d’une longitude non valide, l’erreur sera transmise aux enregistrements dans le champ de la zone de texte.

Générateur de couches de forme

Afin de commencer à travailler avec l’attribution automatique, vous devez créer une couche de forme. Il peut s’agir d’un territoire dans lequel travaillent vos utilisateurs. Donnez un nom descriptif à la couche de forme.

L’attribution automatique fonctionne également pour les formes dessinées, comme celles créées avec les outils Carré, Cercle ou Polygone en plus des formes créées avec Générateur de couches de forme.

Erreurs courantes

Une erreur « Limite du temps processeur Apex atteinte » est souvent causée par l’exécution d’un plan d’attribution qui contient un grand nombre de codes postaux, puisque le délai d’expiration est atteint pendant le traitement des géométries de forme de toutes les règles incluses dans le plan. La pratique recommandée consiste à ce qu’un plan d’attribution ne contienne pas plus de 10 000 codes postaux. Si cette erreur survient, veuillez tenter en premier lieu de réduire la taille du lot d’attribution automatique. Ce paramètre se trouve dans Configuration => Packages installés => Configurer en regard de Salesforce Maps => onglet Avancé à gauche => onglet Traitement par lots. Si cette manipulation ne résout pas le problème, veuillez réfléchir à diviser votre plan d’attribution en plusieurs plans plus petits ou à remplacer les codes postaux par des États dans la mesure du possible.

Une erreur « Trop de lignes de requête : 50001 » survient une fois que les gouverneurs et limites d’exécution de 50 000 enregistrements récupérés par les requêtes SOQL sont atteintes. Si cette erreur survient, veuillez tenter en premier lieu de réduire la taille du lot d’attribution automatique. Ce paramètre se trouve dans Configuration => Packages installés => Configurer en regard de Salesforce Maps => onglet Avancé à gauche => onglet Traitement par lots.