Analyser les performances des plug-ins
Date de publication : janvier 2017
S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Plug-in Profiler est un outil qui profile l’exécution des plug-ins et des activités de workflow personnalisées pour améliorer l’expérience de débogage dans Microsoft Visual Studio. Cet outil, qui peut être exécuté à partir de la fenêtre d’invite de commandes ou de l’outil Plug-in Registration, accélère et facilite le développement de code personnalisé dans Microsoft Dynamics 365 (Online et local). En outre, les utilisateurs peuvent profiler l’exécution du code défaillant et envoyer les résultats au développeur du code ou à un éditeur de logiciels indépendant (ISV) pour analyse. Le développeur peut relire l’exécution du plug-in ou de l’activité de workflow personnalisée et déboguer le code à distance même s’il est déconnecté du serveur Microsoft Dynamics 365.
L’outil peut être utilisé en mode de débogage ou de relecture. Chacun de ces modes est décrit dans les sections ci-après.
Contenu de la rubrique
Déboguer un plug-in à l’aide du profileur de plug-in
Relire l’exécution du plug-in
Exécuter le profileur de plug-in en mode autonome
Déboguer un plug-in à l’aide du profileur de plug-in
Exécutez l’outil Plug-in Registration. Vous trouverez le fichier exécutable de l'outil dans le dossier Tools\PluginRegistration du Kit de développement logiciel.Téléchargez le package Kit de développement logiciel (SDK) de Microsoft Dynamics CRM.
Cliquez sur CRÉER UNE NOUVELLE CONNEXION pour vous connecter à un serveur et à une organisation Microsoft Dynamics 365. Pour plus d’informations sur la connexion à un serveur et à une organisation, consultez la rubrique du Kit de développement logiciel (SDK) : Procédure pas-à-pas : inscrire un plug-in à l’aide de l’outil Plug-in Registration (Inscription de plug-in).
Inscrivez un plug-in et accédez au serveur Microsoft Dynamics 365. Conservez une copie de l’assembly de plug-in compilé par débogage sur l’ordinateur sur lequel vous exécutez l’outil.
Dans la barre d’outils de l’organisation cible, sélectionnez Installer le profileur. Le nœud Profileur de plug-in s’affiche maintenant dans la liste.
Sélectionnez une étape de plug-in et cliquez sur Démarrer le profilage dans la barre d’outils pour démarrer le profilage. Vous pouvez choisir le mode d’exécution du profileur dans la boîte de dialogue Paramètres du profileur.
Effectuez l’opération dans Microsoft Dynamics 365 qui provoque l’exécution du plug-in. Par exemple, si l’étape est configurée pour la mise à jour d’un compte, mettez à jour un compte.
Si vous avez sélectionné l’option Exception dans la boîte de dialogue Paramètres du profileur, une fois que le plug-in lève une exception et que la boîte de dialogue Erreur du processus d’entreprise apparaît, cliquez sur Fichier journal de téléchargement et enregistrez ce fichier. Par ailleurs, si le plug-in ne lève pas d’exception, cliquez sur Arrêter le profilage.
Dans l’outil Plug-in Registration, cliquez sur Déboguer.
Dans la boîte de dialogue Déboguer un plug-in existant, fournissez les informations demandées dans l’onglet Configuration. Entrez l’emplacement du fichier journal précédemment enregistré dans le champ Profil. Entrez ou sélectionnez l’emplacement de l’assembly de plug-in et le nom de classe du plug-in qui a été exécuté.
Lancez Microsoft Visual Studio et attachez le débogueur au processus PluginRegistration.exe.
Définissez un point d’arrêt dans le code du plug-in.
Cliquez sur Démarrer l’exécution dans la boîte de dialogue Déboguer un plug-in existant.
Après un court délai, le plug-in s’exécute avec le même contexte d’exécution que celui qui lui a été transmis par le serveur Microsoft Dynamics 365 et le débogueur arrête l’exécution au point d’arrêt que vous avez défini précédemment.
Continuez à déboguer le plug-in comme vous feriez normalement. Les traces de la génération du plug-in s’affichent dans la boîte de dialogue Déboguer un plug-in existant.
À ce stade, vous pouvez modifier le code du plug-in, le générer, rattacher le débogueur au processus PluginRegistration.exe et cliquer sur Démarrer l’exécution pour continuer avec votre session de débogage. Lors de l’exécution de ces opérations, il n’est pas nécessaire de fermer le formulaire Déboguer un plug-in existant.
Il n’est pas nécessaire de redéployer le plug-in dans le serveur Microsoft Dynamics 365 tant que vous n’avez pas résolu le problème de code. Ce scénario de débogage fonctionne même si une version optimisée du plug-in est installée sur le serveur et une version de débogage du plug-in est installée sur l’ordinateur de débogage.
Relire l’exécution du plug-in
La relecture de l’exécution du plug-in ne nécessite pas une connexion à un serveur et à une organisation Microsoft Dynamics 365. L’avantage de cette méthode est que vous pouvez obtenir le profil d’exécution du plug-in à partir d’un client et déboguer le plug-in à distance. Une restriction de la fonctionnalité de relecture est que vous ne pouvez pas modifier l’ordre des appels effectués par votre code de plug-in dans le débogueur pendant le débogage.
La fonctionnalité de relecture fournit au plug-in une capture instantanée des données d’appel et du contexte d’exécution des événements à partir du serveur Microsoft Dynamics 365. Vous obtenez les mêmes événements, GUID, etc., à partir des appels au service d’organisation mais aucune donnée n’est modifiée sur le serveur lorsque vous déboguez le plug-in. Pendant la procédure de débogage dans la section précédente, le plug-in se connecte en réalité au serveur et effectue des appels en temps réel.
Relire l’exécution du plug-in
Lancez Microsoft Visual Studio et attachez le débogueur au processus PluginRegistration.exe.
Cliquez sur RELIRE L’EXÉCUTION DU PLUG-IN.
Entrez les emplacements du journal et de l’assembly de plug-in dans la boîte de dialogue.
Cliquez sur Démarrer l’exécution.
Déboguez le plug-in comme vous feriez normalement.
Exécuter le profileur de plug-in en mode autonome
Le profileur peut être exécuté à partir de la fenêtre d’invite de commandes, indépendamment de l’outil Plug-in Registration. Cela est utile pour obtenir le journal de profil du plug-in à partir du serveur Microsoft Dynamics 365 d’un client pour déboguer un plug-in défaillant. Un développeur peut ensuite utiliser ce journal pour relire l’exécution du plug-in dans l’outil Plug-in Registration et déboguer le plug-in avecMicrosoft Visual Studio.
Exécuter le profileur de plug-in à partir d’une invite de commandes
Ouvrez une fenêtre d’invite de commandes et définissez le répertoire de travail sur le dossier Tools\PluginRegistration du package de téléchargement du Kit de développement logiciel (SDK).
Tapez la commande : PluginProfiler.Debugger.exe /?.
Examinez la liste des paramètres pris en charge et réexécutez le programme PluginProfiler.Debugger.exe avec les paramètres appropriés.
Voir aussi
Outils de développement
Outils de solution pour le développement d’équipe
Développement de plug-ins
Inscrire et déployer des plug-ins
Déboguer un plug-in
Microsoft Dynamics 365
© 2017 Microsoft. Tous droits réservés. Copyright