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 (préversion) 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.

Fenêtres

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 XML : utilisez la valeur de l’enfant de l’élément <Id> 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. Create 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 de votre souris sur la clé (dossier) WEF, puis sélectionnez Nouveau>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. Create un nouveau dossier appelé Débogage (peut-être dans votre dossier Desktop).

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 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.

Nouveau Windows (préversion)

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 (préversion) .

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. Pour plus d’informations, voir Déboguer des compléments Office sur un Mac.

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.

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é (préversion)
• 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