Résoudre les problèmes liés aux modules complémentaires de signalement d'événements et de spams

  • Article

Lorsque vous développez votre complément basé sur les événements ou la création de rapports de courrier indésirable (préversion), vous pouvez rencontrer des problèmes, tels que le fait que votre complément ne se charge pas ou qu’un événement ne se produit pas. Les sections suivantes fournissent des conseils sur la façon de résoudre les problèmes de votre complément.

Passer en revue les prérequis des fonctionnalités

Vérifier la configuration requise pour le manifeste et JavaScript

  • Vérifiez que les conditions suivantes sont remplies dans le manifeste de votre complément.

    • Vérifiez que l’URL de l’emplacement du fichier source de votre complément est disponible publiquement et n’est pas bloquée par un pare-feu. Cette URL est spécifiée dans l’élément SourceLocation de votre manifeste.

    • Vérifiez que l’élément <Runtimes> (manifeste XML) ou l’objet « code » (manifeste unifié (préversion)) référence correctement le fichier HTML ou JavaScript contenant les gestionnaires d’événements. Outlook classique sur Windows utilise le fichier JavaScript pendant l’exécution, tandis que Outlook sur le web, sur la nouvelle interface utilisateur Mac et outlook sur Windows (préversion) utilisent le fichier HTML. Pour obtenir un exemple de configuration dans le manifeste, consultez la section « Configurer le manifeste » de Définir automatiquement l’objet d’un nouveau message ou d’un nouveau rendez-vous.

      Pour Outlook classique sur Windows, vous devez regrouper tout votre code JavaScript de gestion des événements dans ce fichier JavaScript référencé dans le manifeste. Notez qu’un ensemble JavaScript volumineux peut entraîner des problèmes de performances de votre complément. Nous vous recommandons de prétraiter les opérations lourdes afin qu’elles ne soient pas incluses dans votre code de gestion des événements.

  • Vérifiez que votre fichier JavaScript de gestion des événements référencé par le client Outlook sur Windows appelle Office.actions.associate. Cela garantit que le nom du gestionnaire d’événements spécifié dans le manifeste est mappé à son équivalent JavaScript.

    Conseil

    Si votre complément n’a qu’un seul fichier JavaScript référencé par Outlook sur le web, sur Windows (classique et nouveau (préversion)) et sur Mac, il est recommandé de case activée sur quelle plateforme le complément s’exécute pour déterminer quand appeler Office.actions.associate, comme indiqué dans le code suivant.

    if (Office.context.platform === Office.PlatformType.PC || Office.context.platform == null) {
  Office.actions.associate("onNewMessageComposeHandler", onNewMessageComposeHandler);
  Office.actions.associate("onNewAppointmentComposeHandler", onNewAppointmentComposeHandler);
}

  • Le code JavaScript des compléments de création de rapports de courrier indésirable et basés sur les événements qui s’exécutent dans Outlook sur Windows prend uniquement en charge les spécifications ECMAScript 2016 et antérieures. Voici quelques exemples de syntaxe de programmation à éviter.

    • Évitez d’utiliser des async instructions et await dans votre code. L’inclusion de ces éléments dans votre code JavaScript entraîne l’expiration du délai d’attente du complément.
    • Évitez d’utiliser l’opérateur conditionnel (ternaire), car il empêchera le chargement de votre complément.

    Si votre complément n’a qu’un seul fichier JavaScript référencé par Outlook sur le web, sur Windows (classique et nouveau (préversion)) et sur Mac, vous devez limiter votre code à ECMAScript 2016 pour vous assurer que votre complément s’exécute dans Outlook sur Windows. Toutefois, si vous avez un fichier JavaScript distinct référencé par Outlook sur le web, sur Mac et outlook sur Windows (préversion), vous pouvez implémenter une spécification ECMAScript ultérieure dans ce fichier.

Déboguer votre complément

  • Lorsque vous apportez des modifications à votre complément, n’oubliez pas que :

    • Si vous mettez à jour le manifeste, supprimez le complément, puis rechargez-le. Si vous utilisez Outlook sur Windows, vous devez également fermer et rouvrir Outlook.
    • Si vous apportez des modifications à des fichiers autres que le manifeste, fermez et rouvrez le client Outlook sur Windows ou sur Mac, ou actualisez l’onglet du navigateur en cours d’exécution Outlook sur le web.
    • Si vous ne parvenez toujours pas à voir vos modifications après avoir effectué ces étapes, effacez votre cache Office.

  • Lorsque vous testez votre complément dans Outlook sur Windows :

    • Pour les compléments basés sur des événements, case activée observateur d'événements pour toutes les erreurs de complément signalées.

      1. Dans observateur d'événements, sélectionnezApplicationjournaux> Windows.
      2. Dans le panneau Actions , sélectionnez Filtrer le journal actuel.
      3. Dans la liste déroulante Journalisation , sélectionnez la période de journalisation de votre choix.
      4. Cochez la case Erreur .
      5. Dans le champ ID d’événement , entrez 63.
      6. Sélectionnez OK pour appliquer vos filtres.

      Exemple de paramètres de filtre du journal actuel de observateur d'événements configurés pour afficher uniquement les erreurs Outlook avec l’ID d’événement 63 qui se sont produites au cours de la dernière heure.

    • Vérifiez que le fichier bundle.js est téléchargé dans le dossier suivant dans Explorateur de fichiers. Remplacez le texte joint par [] vos informations 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 :

  • Lorsque vous testez votre complément dans Outlook sur Windows ou Mac, activez la journalisation du runtime pour identifier les éventuels problèmes d’installation du manifeste et du complément. Pour obtenir des conseils sur l’utilisation de la journalisation du runtime, consultez Déboguer votre complément avec la journalisation du runtime.

  • Définissez des points d’arrêt dans votre code pour déboguer votre complément. Pour obtenir des instructions spécifiques à la plateforme, consultez Déboguer les compléments basés sur les événements et les rapports de courrier indésirable.

Demander de l’aide supplémentaire

Si vous avez toujours besoin d’aide après avoir effectué les étapes de résolution des problèmes recommandées, ouvrez un problème GitHub. Incluez des captures d’écran, des enregistrements vidéo ou des journaux d’exécution pour compléter votre rapport.

Voir aussi