Résoudre les problèmes à l’aide du centre d’intégrité de la solution
Le Centre d’intégrité de la solution vous permet d’obtenir une meilleure image de l’état de votre environnement et de détecter des problèmes dans l’environnement Microsoft Dynamics 365. Le Centre d’intégrité de la solution exécute des règles dans une instance pour valider la configuration de l’environnement, qui peut changer au fil de l’exploitation naturelle du système. Certaines règles sont spécifiques à Dynamics 365 Field Service et vous pouvez exécuter des règles à la demande lorsque vous rencontrez un problème. Certaines règles se déclenchent automatiquement lorsque Field Service est installé ou mis à jour. Exécutez régulièrement l’ensemble de règles de Field Service pour analyser l’état de votre environnement.
Voici quelques problèmes fréquents que le Centre d’intégrité de la solution détecte :
- Si des processus Field Service critiques sont désactivés.
- Si des processus qui entraîneront un échec de mise à niveau sont affectés à des utilisateurs désactivés.
- Des ressources web personnalisées qui mènent à des problèmes d’exécution.
En plus d’exécuter le Centre d’intégrité de la solution, consultez les bonnes pratiques pour la personnalisation de Dynamics 365 Field Service et Exécuter le Vérificateur de solution pour améliorer les scripts, les plugins, le HTML, les flux de travail, etc.
Conditions préalables
- Field Service v8.4.0.338 + (Unified Interface) ou v7.5.7.87 + (Web)
- Le Centre d’intégrité de la solution étend le Vérificateur Power Apps pour garantir le fonctionnement intègre continu d’un environnement.
Exécuter un contrôle de l’intégrité
Pour effectuer une opération d’analyse pour Field Service :
- Ouvrez l’application Centre d’intégrité de la solution.
- Sélectionnez Tâches d’analyse et créez une tâche d’analyse.
- Lorsque la boîte de dialogue s’ouvre, sélectionnez Field Service.
- Sélectionnez OK et la tâche d’analyse démarre.
Résultats du contrôle d’intégrité de vue
Une fois que vous exécutez la tâche d’analyse, vous êtes redirigé vers la page d’aperçu, qui s’actualise lorsque l’exécution est terminée.
Lors de l’exécution d’une tâche d’analyse, vous voyez un Statut de retour pour chaque règle, qui indique si la règle passée, échoue, ou s’il existe une erreur de configuration. Les règles renvoient également le niveau de gravité en cas de défaillance, qui indique la gravité de chaque problème. Tous les statuts de retour possibles sont répertoriés dans le tableau suivant.
Règle de statut de retour | Recommandation |
---|---|
Échec | Détecte des échecs spécifiques dans le système ; appliquez la règle comme suggéré. |
Avertissement | Tenez compte des implications mentionnées dans le message concernant la règle. |
Réussite | Indique qu’il n’y a aucun problème avec cette règle. Toutes les règles doivent être dans cet état. |
Génération de l’ordre de travail du contrat
Gravité : élevée
Ce qu’elle vérifie
Vérifie que tous les ordres de travail ont été correctement générés en fonction des accords.
Pourquoi elle échoue
Des récurrences de contrat n’ont pas été traitées correctement, et les ordres de travail qui auraient dû être générés ne l’ont pas été.
Comment corriger
Identifiez la raison pour laquelle l’ordre de travail n’a pas été généré, ainsi que la cause de l’échec, et résolvez-la. Régénérez ensuite l’enregistrements en redéfinissant le statut de l’accord sur « estimation », puis sur « actif » à nouveau.
Avertissement
La modification du statut de l’accord supprime tous les enregistrements de données de réservation d’accord existants avec le statut « actif », mais ne régénère que les enregistrements pour les dates futures.
Vérifier le workflow en échec lié au contrat
Gravité : élevée
Ce qu’elle vérifie
Vérifie le workflow lié au contrat défaillant, renvoie la configuration de la réservation du contrat ou l’enregistrement de la configuration de la facture du contrat qui a échoué.
Pourquoi elle échoue
Cette règle échoue s’il existe un workflow lié à un enregistrement de contrat défaillant.
Comment corriger
Cette règle fournit une étape de résolution automatisée qui peut être résolue via le bouton Résoudre dans le formulaire Centre d’intégrité de la solution pour cet échec de la règle. Elle peut également être affichée individuellement et résolue en suivant les mêmes étapes que pour la règle « Vérifier le workflow en échec lié au contrat ».
Rechercher les bibliothèques de formulaires supprimées
Gravité : Moyenne
Ce qu’elle vérifie
Détecte s’il y a des formulaires Field Service dans le système auxquelles manquent des bibliothèques Field Service.
Pourquoi elle échoue
Les formulaires Field Service dépendent des bibliothèques de celui-ci pour fonctionner correctement.
Note
Cela constitue aujourd’hui un problème de faux positif sur le formulaire « Niveau de prix ». Ce problème sera traité dans une prochaine version.
Comment le résoudre
Ajoutez les bibliothèques manquantes au formulaire. Vous pouvez obtenir la liste des bibliothèques requises par comparaison avec un autre formulaire de la même entité ou d’une autre organisation. Contactez le support pour obtenir de l’aide.
Personnalisations du module d’application Connected Field Service
Gravité : faible
Ce qu’elle vérifie
Vérifie si des personnalisations du module d’application Connected Field Service sont obsolètes et ne doivent pas être appliquées.
Pourquoi elle échoue
S’il y a des personnalisations dans le module d’application Connected Field Service dans l’organisation, cette vérification échoue.
Comment le résoudre
Supprimez les personnalisations du module d’application Connected Field Service.
Groupes d’options personnalisés
Gravité : élevée
Ce qu’elle vérifie
Détecte si un groupe d’options dans Field Service qui ne doit pas être personnalisé a été personnalisé. La personnalisation des groupes d’options peut aboutir à un comportement inattendu.
Note
Ceci constitue aujourd’hui un problème connu dans msdyn_billingtype
, même lorsqu’il n’a pas été personnalisé. Il se produit lorsque la solution Project Service Automation est également installée. Cette règle a été mise à jour pour résoudre cet échec connu.
Pourquoi elle échoue
Échoue s’il existe des personnalisations sur l’un des groupes d’options Field Service par défaut. Les ajouts aux jeux d’options ne sont pas considérés comme des échecs, mais uniquement les modifications apportées aux options dans les jeux d’options.
Comment le résoudre
Supprimer manuellement des personnalisations des groupes d’options Field Service
Ressources web personnalisées
Gravité : élevée
Ce qu’elle vérifie
Détecte quelles ressources web personnalisées ne font pas partie du package Field Service. Les ressources web personnalisées ne sont pas mises à jour avec une mise à jour de Field Service et peuvent entraîner des problèmes de fonctionnalité.
Pourquoi elle échoue
Échoue si une ressource web personnalisée qui ne fait pas partie du package Field Service existe.
Comment corriger
Supprimez les personnalisations via l’interface utilisateur des couches de solution sur les ressources Web qui ont été personnalisées. Lors de la mise à niveau de Field Service, les ressources Web peuvent être correctement mises à niveau.
Supprimer le workflow à numéro unique Field Service
Gravité : faible à moyenne
Ce qu’elle vérifie
Valide si le flux de travail de suppression en bloc de la numérotation automatique s’exécute correctement.
Pourquoi elle échoue
Échoue si le flux de travail de suppression de numéro unique a échoué.
Comment le résoudre
Cette règle fournit une étape de résolution automatisée qui peut être résolue via le bouton Résoudre dans le formulaire Centre d’intégrité de la solution pour cet échec de la règle.
Processus supprimés
Gravité : élevée
Ce qu’elle vérifie
Vérifie qu’il n’existe pas de processus supprimé.
Pourquoi elle échoue
Échoue si l’un des processus prêts à l’emploi de Field Service est supprimé.
Comment corriger
Contactez le support technique.
Étapes de traitement du message SDK supprimées
Gravité : élevée
Ce qu’elle vérifie
Vérifie qu’aucune étape de traitement du message SDK n’est supprimée.
Pourquoi elle échoue
Échoue si l’une des étapes de traitement des messages du SDK Field Service livré a été supprimée du système.
Comment le résoudre
Contactez le support technique.
Ressources web supprimées
Gravité : élevée
Ce qu’elle vérifie
Vérifie s’il existe des ressources Web supprimées.
Pourquoi elle échoue
Échoue si l’une des ressources Web du Field Service livré a été supprimée du système.
Comment corriger
Contactez le support technique.
Étapes de traitement du message SDK désactivées
Gravité : élevée
Ce qu’elle vérifie
Vérifie si des étapes de traitement des messages du SDK sont désactivées. Les étapes désactivées de traitement du message SDK mènent à un comportement incorrect lors de l’utilisation de Field Service.
Pourquoi elle échoue
Échoue si l’une des étapes de traitement des messages du SDK Field Service est désactivée.
Comment le résoudre
Activez les étapes désactivées de traitement des messages du SDK.
Configuration des métadonnées de configuration de réservation pour Field Service
Gravité : élevée
Ce qu’elle vérifie
Vérifie que l’enregistrement des métadonnées de configuration de réservation pour Field Service existe correctement dans le système. Si cet enregistrement est absent, il se peut que la planification de la fonctionnalité ne fonctionne pas comme prévu.
Pourquoi elle échoue
Échoue si l’enregistrement des métadonnées de configuration de réservation pour Field Service n’existe pas dans le système.
Comment corriger
Contactez le support technique.
Paramètres Field Service
Gravité : élevée
Ce qu’elle vérifie
Vérifie que l’enregistrement des paramètres Field Service existe correctement dans le système.
Pourquoi elle échoue
Échoue si l’enregistrement des paramètres Field Service n’existe pas ou n’est pas configuré correctement.
Comment corriger
Le système recrée cet enregistrement s’il s’avère qu’il n’existe pas au cours de l’utilisation normale de Field Service. Si l’enregistrement n’est pas régénéré automatiquement, contactez le support.
Contexte d’exécution des formulaires est manquant
Gravité : élevée
Ce qu’elle vérifie
Détecte s’il existe des formulaires dans le système qui ont des gestionnaires d’événements faisant référence à des bibliothèques Field Service sans passer le paramètre de contexte d’exécution.
Pourquoi elle échoue
Le code Field Service s’attend à ce que le paramètre de contexte d’exécution soit transmis au gestionnaire d’événements OnLoad. Si cette valeur est absente, cela peut provoquer des erreurs lors de l’utilisation du formulaire.
Note
Le scénario le plus courant où cette règle présente un échec est lorsqu’une copie de l’un des formulaires prêts à l’emploi est présente (versions Field Service antérieures à 8.X), et qu’alors Field Service est mis à niveau. Dans de tels scénarios, il manque à ces formulaires copiés à partir de versions antérieures de Field Service ExecutionContext parameter
dans ces formulaires ad hoc.
Comment corriger
Ouvrez le formulaire dans le concepteur > double-cliquez sur chaque gestionnaire d’événements OnLoad > activez l’option « Transmettre le contexte d’exécution comme premier paramètre » > enregistrez et publiez le formulaire.
Mise à niveau incomplète de Field Service
Gravité : faible
Ce qu’elle vérifie
Détecte si une mise à niveau de Field Service a démarré mais n’a pas abouti.
Pourquoi elle échoue
Échoue si une mise à niveau de Field Service a démarré mais n’a pas abouti.
Comment le résoudre
Relancez la mise à niveau de Field Service. Une fois la mise à niveau réussie, cette règle renvoie une réussite. Si la mise à niveau échoue à nouveau, contactez le support.
Définitions de processus avec le statut Brouillon
Gravité : élevée
Ce qu’elle vérifie
Vérifie s’il existe des définitions de processus avec le statut Brouillon. Si des processus sont à l’état de brouillon, Field Service ne fonctionne pas correctement.
Pourquoi elle échoue
Échoue s’il existe des définitions de processus avec le statut Brouillon.
Note
Les flux modernes de Field Service peuvent provoquer des échecs. Cette règle a été mise à jour pour procéder à la validation en fonction du paramètre de traitement en arrière-plan amélioré dans UR 24 ; dans les versions antérieures à UR 24, elle peut échouer sur les enregistrements de type flux des processus d’entreprise (BPF).
Comment corriger
Réactivez les définitions de processus afin qu’elles ne soient pas à l’état brouillon.
Définitions de processus détenues par des utilisateurs désactivés
Gravité : moyenne à élevée
Ce qu’elle vérifie
Vérifie si des définitions de processus dans le système attribuées à des utilisateurs qui sont désactivés. Dans ce cas, la mise à niveau échoue.
Pourquoi elle échoue
Échoue si des définitions de processus dans le système sont affectées à des utilisateurs désactivés, ce qui peut entraîner l’échec des mises à niveau.
Note
Opère la validation en fonction du paramètre de traitement en arrière-plan amélioré dans UR 24.
Comment le résoudre
Pour les workflows : remplacez le propriétaire du processus par un utilisateur actif.
Vérification de la compatibilité des versions de Planification universelle des ressources
Gravité : faible
Ce qu’elle vérifie
Vérifie que la version actuellement installée de Field Service est bien compatible avec la version de Planification universelle des ressources.
Pourquoi elle échoue
Échoue si la solution Planification universelle des ressources installée dans l’organisation n’est pas compatible avec la version installée de Field Service. Cela peut se produire si un autre package contenant la solution Planification universelle des ressources a été installé, qui met à jour la version de la solution Planification universelle des ressources.
Note
L’état d’échec de cette règle a été changé en « Avertissement » au lieu de « Échec » pour mieux correspondre à la faible gravité pour cette règle dans la version UR 23.
Comment corriger
Le message d’avertissement affiché par la règle indique quelle solution doit être mise à niveau pour être compatible avec Field Service.
Vérifier si la numérotation automatique est activée
Gravité : faible
Ce qu’elle vérifie
Vérifie si la numérotation automatique est activée pour l’organisation. Nous recommandons aux clients d’utiliser la nouvelle fonctionnalité de numérotation automatique pour garantir l’unicité de la numérotation des tables Field Service.
Pourquoi elle échoue
Échoue si la numérotation automatique n’est pas activée pour l’organisation.
Comment corriger
Activez la numérotation automatique dans Field Service en accédant à Paramètres>Paramètres Field Service># Activation de la numérotation automatique (dans le ruban de commande supérieur).
Vérifier la compatibilité des solutions Field Service et Project Service Automation
Gravité : faible
Ce qu’elle vérifie
Vérifie que la version actuellement installée de Field Service est compatible avec la version de Project Service Automation installée.
Pourquoi elle échoue
Échoue si la version de la solution Project Service Automation installée dans l’organisation n’est pas compatible avec la version installée de Field Service.
Comment corriger
Le message d’avertissement affiché par la règle indique quelle solution doit être mise à niveau pour être compatible avec Field Service.
Instances de workflow en attente détenues par les utilisateurs désactivés
Gravité : élevée
Ce qu’elle vérifie
Détecte des instances de workflow en attente qui sont attribuées aux utilisateurs désactivés. Ces workflows ne parviendront pas à générer correctement les enregistrements qu’ils doivent générer.
Pourquoi elle échoue
Échoue s’il y a des workflows en pause attribués à des comptes d’utilisateurs désactivés dans l’état En pause avec la raison En attente.
Comment corriger
Déclenchez à nouveau le workflow. Reportez-vous à la documentation générale ou contactez le support.
Vérifier si le niveau requis des champs est modifié
Gravité : élevée
Ce qu’elle vérifie
Cette règle vérifie si le niveau requis du champ système dans le formulaire est modifié
Pourquoi elle échoue
Si le niveau requis du champ système (c’est-à-dire le champ Application requise/Champ OOB) sur le formulaire Ordre de travail et accord est modifié.
Comment corriger
Accédez à Personnalisation -> Entités -> Ordre de travail/Accord -> Champs -> double-cliquez sur le champ pour lequel le niveau requis doit être réinitialisé -> sélectionnez l’exigence de champ -> Contrainte obligatoire.
Note
Cette règle est implémentée pour le champ obligatoire prêt à l’emploi sur l’ordre de travail et le contrat uniquement.
Vérifie s’il existe des contrats actifs avec des dates de fin passées
Gravité : élevée
Ce qu’elle vérifie
La règle valide pour les accords où l’état du système est Actif, mais la date de fin est dans le passé [l’état du système doit avoir expiré si la date de fin est dépassée].
Pourquoi elle échoue
La règle échoue si le statut système d’un accord est Actif même si sa date de fin est dépassée [date de fin avec une date passée].
Comment le résoudre
Fournir une option de résolution s’il existe un accord avec l’état du système actif et une fin avec une date passée. Sélectionnez le résultat de l’analyse, passez en revue les accords et sélectionnez le bouton de résolution.
Notes et restrictions
- Règle valide pour les accords ayant une date de fin dans les 90 derniers jours.
- La règle considère les 5 000 principaux accords dont le statut du système est Actif et dont la date de fin est atteinte.
- Seuls les accords ayant des configurations de réservation du contrat et des dates de réservation de contrat sont pris en compte pour la validation.
Rechercher des dates de réservation du contrat présentant une incompatibilité de révision avec une configuration de réservation du contrat
Gravité : élevée
Ce qu’elle vérifie
Règle valide si la révision des dates de réservation du contrat correspond à la révision des configurations de réservation du contrat correspondantes.
Pourquoi elle échoue
La règle échoue s’il y a une non-concordance avec la valeur de révision de la date de réservation du contrat et sa configuration de réservation du contrat correspondante. Cette règle ne prend en compte que les enregistrements de date de réservation active dont la date de réservation n’est pas antérieure à 90 jours (c’est-à-dire les dates de réservation actives des trois derniers mois). S’il y a une discordance, le système peut ne pas générer d’ordre de travail pour cette date de réservation.
Comment corriger
Contactez le support technique.
Notes et restrictions
La règle prend en compte les 5 000 premiers enregistrements ABD actifs au cours des trois derniers mois en fonction de la date de réservation (dernière)
Rechercher des dates de facturation du contrat présentant une incompatibilité de révisions avec des configurations de facturation du contrat
Gravité : élevée
Ce qu’elle vérifie
Règle valide si la révision des dates de facturation du contrat correspond à la révision des configurations de facturation du contrat correspondantes.
Pourquoi elle échoue
La règle échoue s’il y a une non-concordance avec la valeur de révision de la date de facture du contrat et sa configuration de facture du contrat correspondante. Cette règle ne prend en compte que les enregistrements Date de facture de contrat actifs dont la date de facture n’est pas antérieure à 90 jours (c’est-à-dire les dates de facture actives des trois derniers mois). S’il y a une discordance, le système peut ne pas générer de facture pour cette date de facture.
Comment corriger
Contactez le support technique.
Notes et restrictions
La règle prend en compte les 5 000 premiers enregistrements AID actifs au cours des trois derniers mois en fonction de la date de facture (dernière)
Vérification du privilège pour les propriétaires de la configuration de réservation du contrat
Gravité : élevée
Ce qu’elle vérifie
Vérifie que les propriétaires d’enregistrement de configuration de réservation du contrat disposent des privilèges requis pour créer les ordres de travail.
Pourquoi elle échoue
Si les propriétaires de la configuration de réservation du contrat n’ont pas les privilèges requis.
1.prvCreatemsdyn_workorder
Comment le résoudre
Attribuez les privilèges ci-dessus aux propriétaires d’enregistrement de configuration de réservation du contrat respectifs.
Vérification du privilège pour les propriétaires de la configuration de facture du contrat
Gravité : élevée
Ce qu’elle vérifie
Vérifie si les propriétaires des enregistrements de configuration de facture du contrat disposent des privilèges requis pour créer la facture.
Pourquoi elle échoue
Si les propriétaires de la configuration de facture du contrat n’ont pas les privilèges requis.
1.prvCreateInvoice
Comment le résoudre
Attribuez les privilèges ci-dessus aux propriétaires d’enregistrement de configuration de facture du contrat respectifs.
Récurrence de la configuration de la réservation du contrat
Gravité : élevée
Ce qu’elle vérifie
Si le paramètre de récurrence est configuré ou non sur une configuration de réservation du contrat et, si oui, s’il s’agit d’une valeur de paramètre de récurrence valide.
Pourquoi elle échoue
Si l’État du système d’un contrat est Actif et que son enregistrement de configuration de réservation du contrat a la fonction Générer automatiquement l’ordre de travail définie sur Oui, mais le paramètre de récurrence n’est pas configuré. Si l’État du système d’un contrat est Actif et que son enregistrement de configuration de réservation du contrat a la fonction Générer automatiquement l’ordre de travail définie sur Oui, mais la récurrence configurée n’est pas valide.
Comment corriger
Configurez une récurrence valide dans Configuration de réservation de contrat et sélectionnez Accord> Configuration de réservation du contrat> Récurrence de réservation.
Valeurs de latitude et de longitude sur l’enregistrement de compte
Gravité : faible
Ce qu’elle vérifie
Vérifie si les valeurs de latitude et/ou de longitude sont présentes sur un enregistrement de compte ou non.
Pourquoi elle échoue
Si la latitude ou la longitude ou les deux ne sont pas présentes dans un enregistrement de compte.
Comment corriger
Vérifiez si l’adresse sur le formulaire de compte est fournie. Si c’est le cas, géocodez le compte en sélectionnant le bouton de géocodage dans la barre de commande du formulaire de compte.
Vérifier les rôles de sécurité des utilisateurs mobiles
Gravité : élevée
Ce qu’elle vérifie
Vérifie si les collaborateurs de première ligne qui ont accès à l’application mobile Field Service se voient attribuer le rôle ressource Field Service et le profil de sécurité du champ de ressource Field Service.
Pourquoi elle échoue
Lorsqu’un travailleur de première ligne a accès à l’application mobile Field Service sans rôle de ressource Field Service et/ou sans profil de sécurité du champ de ressource Field Service.
Note
La division est affichée dans le message lorsqu’il existe plusieurs divisions dans l’organisation. Un utilisateur qui appartient à plusieurs divisions et qui ne dispose pas du rôle ou du profil de sécurité Ressource Field Service peut être signalé pour chaque division dont il est membre.
Comment corriger
Ajoutez le rôle de sécurité de la ressource Field Service et le profil de sécurité de champ à l’utilisateur. Pour plus d’informations, voir Consulter cet article sur la configuration des collaborateurs de première ligne.
Vérifier si les formulaires ont des personnalisations incorrectes
Gravité : élevée
Ce qu’elle vérifie
Pour tous les formulaires d’ordre de travail, cette règle vérifie si le nombre de contrôles de sous-grille ou de contrôles de recherche dépasse la limite (4 sous-grilles ou 20 recherches), ce qui peut avoir un impact sur les performances. Cette règle déclenche une notification pour les administrateurs système indiquant quels formulaires ont trop de contrôles de sous-grille ou de contrôles de recherche.
Un contrôle de sous-grille est une table du formulaire qui répertorie les enregistrements d’une autre table. Exemple de contrôle de sous-grille : le contrôle de sous-grille du produit d’ordre de travail sur le formulaire d’ordre de travail qui est inclus par défaut avec Field Service.
Un contrôle de recherche est un champ du formulaire qui recherche les enregistrements d’une autre table et vous permet de sélectionner un ou plusieurs enregistrements pour remplir le champ.
Pourquoi elle échoue
Cette règle échoue si l’onglet par défaut (le premier onglet du formulaire) d’un formulaire d’ordre de travail contient plus de 4 contrôles de sous-grille ou 20 contrôles de recherche. Les performances de chargement du formulaire sont affectées par le nombre de contrôles sur l’onglet par défaut du formulaire, il est donc fortement suggéré de minimiser le nombre de contrôles à cet endroit.
Comment corriger
Réduisez le nombre de champs de recherche et de contrôles de sous-grille sur l’onglet par défaut (le premier onglet du formulaire) en les déplaçant vers d’autres onglets du formulaire (ou en les masquant du formulaire s’ils ne sont pas nécessaires).
Découvrez d’autres façons d’améliorer le temps de chargement des formulaires.