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

Lorsque vous développez votre complément basé sur les événements ou la création de rapports de courrier indésirable , 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érifiez que le complément est installé sur un client Outlook pris en charge. Certains clients Outlook prennent uniquement en charge certains événements ou certains aspects de l’activation basée sur les événements ou de la création de rapports de courrier indésirable intégrés. Pour plus d’informations, consultez Événements pris en charge et Implémenter un complément de création de rapports de courrier indésirable intégré.

• Vérifiez que votre client Outlook prend en charge l’ensemble de conditions minimales requises.

  L’activation basée sur les événements a été introduite dans l’ensemble de conditions requises 1.10, avec des événements supplémentaires désormais pris en charge dans les ensembles de conditions requises suivants. Pour plus d’informations, consultez Événements pris en charge et Ensembles de conditions requises pris en charge par les serveurs Exchange et les clients Outlook. Si vous développez un complément qui gère les événements et OnAppointmentSend , consultez la section « Clients et plateforme pris en charge » de Gérer les événements OnMessageSend et OnAppointmentSend dans votre complément Outlook avec des alertes intelligentes.OnMessageSend

  La fonctionnalité de rapport de courrier indésirable intégrée a été introduite dans l’ensemble de conditions requises 1.14.

• Passez en revue le comportement attendu et les limitations de la fonctionnalité.

  • Comportement et limitations de l’activation basée sur les événements
  • Comportement et scénarios des alertes intelligentes
  • Comportement et limitations des rapports de courrier indésirable intégré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 du manifeste du complément uniquement ou dans la propriété « extensions.runtimes.code.page » du manifeste unifié pour Microsoft 365.

  • Vérifiez que l’élément< Runtimes> (manifeste de complément uniquement) ou la propriété « extensions.runtimes.code » (manifeste unifié) 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 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 appelle Office.actions.associate. Cela garantit que le nom du gestionnaire d’événements spécifié dans le manifeste est mappé à son équivalent JavaScript. Voici un exemple de code.

  Office.actions.associate("onNewMessageComposeHandler", onNewMessageComposeHandler);
  

• 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 classique 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 (nouveau et classique) et sur Mac, vous devez limiter votre code à ECMAScript 2016 pour vous assurer que votre complément s’exécute dans Outlook classique sur Windows. Toutefois, si vous avez un fichier JavaScript distinct référencé par Outlook sur le web, sur Mac et outlook sur Windows, 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 classique 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.

    

  • 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 :

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

• Lorsque vous testez votre complément dans Outlook sur Windows (classique) 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

• 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é