Déboguer votre complément Outlook basé sur les événements ou le courrier indésirable

Cet article décrit les principales étapes de débogage pour activer et définir des points d’arrêt dans votre code lorsque vous implémentez l’activation basée sur les événements ou la création de rapports de courrier indésirable intégrés dans votre complément. Avant de continuer, nous vous recommandons de consulter le guide de résolution des problèmes pour obtenir des étapes supplémentaires sur la résolution des erreurs de développement.

Pour commencer le débogage, sélectionnez l’onglet correspondant à votre client applicable.

Web

Utilisez les outils de développement de votre navigateur préféré pour déboguer votre complément basé sur les événements dans Outlook sur le web. Pour plus d’informations, voir Débogage de compléments dans Office sur le web.

Windows (nouveau)

Pour déboguer votre complément dans le nouveau client de bureau Outlook sur Windows (préversion), vous devez exécuter la commande suivante pour ouvrir Microsoft Edge DevTools.

olk.exe --devtools

Pour plus d’informations, consultez la section « Déboguer votre complément » de Développer des compléments Outlook pour le nouvel Outlook sur Windows.

Windows (classique)

Si vous avez utilisé le générateur Yeoman pour les compléments Office pour créer votre projet de complément (par exemple, en suivant une procédure pas à pas d’activation basée sur les événements), suivez l’option Créé avec le générateur Yeoman tout au long de cet article. Sinon, suivez les étapes Autres . Visual Studio Code doit être au moins version 1.56.1.

Marquer votre complément pour le débogage et définir le port du débogueur

1. Obtenez l’ID de votre complément à partir du manifeste.

   • Manifeste de complément uniquement : utilisez la valeur de l’élément <Id> enfant de l’élément OfficeApp> racine<.
   • Manifeste unifié pour Microsoft 365 : utilisez la valeur de la propriété « id » de l’objet anonyme { ... } racine.

2. Créez une valeur de Registre DWORD nommée UseDirectDebugger dans HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\Wef\Developer\[Add-in ID]. Remplacez par [Add-in ID] l’ID de votre complément à partir du manifeste.

   Remarque

   Si la Developer clé (dossier) n’existe pas déjà sous HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\WEF\, effectuez les étapes suivantes pour la créer.

   1. Cliquez avec le bouton droit (ou sélectionnez et maintenez la touche WEF (dossier) enfoncée, puis sélectionnez Nouvelle>clé.
   2. Nommez la nouvelle clé Développeur.

   Créé avec le générateur Yeoman : dans une fenêtre de ligne de commande, accédez à la racine de votre dossier de complément, puis exécutez la commande suivante.

   npm start
   

   En plus de générer le code et de démarrer le serveur local, cette commande définit les données de valeur DWORD de UseDirectDebugger registre pour ce complément sur 1.

   Autre : Dans la valeur DWORD du HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\WEF\Developer\[Add-in ID]\UseDirectDebugger Registre, où [Add-in ID] est l’ID de votre complément à partir du manifeste, définissez les données de valeur sur 1.

3. Dans la clé HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\Wef\Developer\[Add-in ID]de Registre , où [Add-in ID] est l’ID de votre complément à partir du manifeste, créez une DWORD valeur avec la configuration suivante.

   • Nom de la valeur : DebuggerPort
   • Données de valeur (hexadécimales) : 00002407

   Cela définit le port du débogueur sur 9223.

4. Démarrez Outlook ou redémarrez-le s’il est déjà ouvert.

5. Effectuez l’action pour lancer l’événement pour lequel vous développez, comme créer un message pour lancer l’événement OnNewMessageCompose ou signaler des messages indésirables. La boîte de dialogue Déboguer un gestionnaire basé sur un événement doit s’afficher. N’interagissez pas encore avec la boîte de dialogue.

   

Configurer Visual Studio Code

Créé avec le générateur Yeoman

1. De retour dans la fenêtre de ligne de commande, exécutez la commande suivante pour ouvrir votre projet de complément dans Visual Studio Code.

   code .
   

2. Dans Visual Studio Code, ouvrez le fichier ./.vscode/launch.json et ajoutez l’extrait suivant à votre liste de configurations. Enregistrez vos modifications.

   {
     "name": "Direct Debugging",
     "type": "node",
     "request": "attach",
     "port": 9223,
     "timeout": 600000,
     "trace": true
   }
   

Autre

1. Créez un dossier appelé Débogage (peut-être dans votre dossier Bureau ).

2. Ouvrez Visual Studio Code.

3. Accédez à Fichier>Ouvrir le dossier, accédez au dossier que vous venez de créer, puis choisissez Sélectionner un dossier.

4. Dans la barre d’activité, sélectionnez Exécuter et déboguer (Ctrl+Maj+D).

   

5. Sélectionnez le lien Créer un fichier launch.json .

   

6. Dans la liste déroulante Sélectionner un environnement , sélectionnez Edge : Lancer pour créer un fichier launch.json.

7. Ajoutez l’extrait suivant à votre liste de configurations. Enregistrez vos modifications.

   {
     "name": "Direct Debugging",
     "type": "node",
     "request": "attach",
     "port": 9223,
     "timeout": 600000,
     "trace": true
   }
   

Attacher le débogueur

Le fichier bundle.js d’un complément contient le code JavaScript de votre complément. Il est créé lors de l’ouverture d’Outlook classique sur Windows. Au démarrage d’Outlook, le fichier bundle.js de chaque complément installé est mis en cache dans le dossier Wef de votre ordinateur.

1. Pour trouver le fichier bundle.js du complément, accédez au dossier suivant dans Explorateur de fichiers. Remplacez le texte joint par [] les informations outlook et de complément applicables.

   %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\{[Outlook profile GUID]}\[Outlook mail account encoding]\Javascript\[Add-in ID]_[Add-in Version]_[locale]
   

   Conseil

   Si le fichier bundle.js n’apparaît pas dans le dossier Wef , procédez comme suit :

   • Si votre complément est installé ou chargé de manière indépendante, redémarrez Outlook.
   • Supprimez votre complément d’Outlook, puis chargez-le à nouveau.

2. Ouvrez bundle.js dans Visual Studio Code.

3. Placez les points d’arrêt dans bundle.js où vous souhaitez que le débogueur s’arrête.

4. Dans la liste déroulante DEBUG , sélectionnez Débogage direct, puis sélectionnez l’icône Démarrer le débogage .

   

Exécuter le débogueur

1. Après avoir vérifié que le débogueur est attaché, revenez à Outlook et, dans la boîte de dialogue Déboguer le gestionnaire basé sur les événements, choisissez OK .

2. Vous pouvez maintenant atteindre vos points d’arrêt dans Visual Studio Code, ce qui vous permet de déboguer votre code d’activation basée sur les événements ou de création de rapports de courrier indésirable.

Arrêter le débogueur

Pour arrêter le débogage du reste de la session Outlook sur Windows actuelle, dans la boîte de dialogue Déboguer le gestionnaire basé sur les événements , choisissez Annuler. Pour réactiver le débogage, redémarrez Outlook.

Pour empêcher la boîte de dialogue Debug Event-based handler de s’afficher et d’arrêter le débogage pour les sessions Outlook suivantes, supprimez la clé de Registre associée, HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\Wef\Developer\[Add-in ID]\UseDirectDebuggerou définissez sa valeur sur 0.

Arrêter le serveur local

Lorsque vous souhaitez arrêter le serveur web local et désinstaller le complément, suivez les instructions applicables :

• Pour arrêter le serveur, exécutez la commande suivante. Si vous avez utilisé npm start, la commande suivante doit également désinstaller le complément.

  npm stop
  

• Si vous avez chargé manuellement le complément, consultez Supprimer un complément chargé de manière indépendante.

Mac

Les compléments basés sur les événements qui s’exécutent dans Outlook sur Mac utilisent le runtime du navigateur. Pour cette raison, vous pouvez déboguer votre complément à l’aide de Safari Web Inspector.

1. Pour utiliser Safari Web Inspector dans Outlook, suivez les étapes décrites dans Débogage avec Safari Web Inspector sur un Mac.
2. Ouvrez Outlook, puis chargez une version test de votre complément.
3. Effectuez une action qui lancera l’événement géré par votre complément. Par exemple, créez un message pour lancer l’événement OnNewMessageCompose . Une fenêtre développeur vide s’ouvre. Le nom de votre complément apparaît dans la barre de titre de la fenêtre.
4. Cliquez avec le bouton droit (ou sélectionnez et maintenez la touche) n’importe où dans la fenêtre Développeur, puis sélectionnez Inspecter l’élément. Cela ouvre l’inspecteur, où vous pouvez définir des points d’arrêt et déboguer votre complément.

Voir aussi

• Configurer votre complément Outlook pour l’activation basée sur les événements
• Implémenter un complément de création de rapports de courrier indésirable intégré
• Résoudre les problèmes liés aux modules complémentaires de signalement d'événements et de spams
• Déboguer votre complément avec la journalisation runtime