Résolution des problèmes d'intégration avec Exchange

Solutions pour les problèmes de synchronisation d'intégration d'Exchange dans Communications Mining, couvrant les boîtes aux lettres et les intégrations désactivées, les écarts de synchronisation silencieuse et les problèmes de filtre de dossier.

Cette page vous aide à diagnostiquer les problèmes de synchronisation de l’intégration Exchange dans Communications Mining™. Commencez par ce que vous pouvez observer:

• L'intégration ou l'une de ses boîtes aux lettres a été désactivée avec une erreur.
• Aucune erreur n'apparaît nulle part, mais des e-mails sont manquants.

Une intégration ou une boîte aux lettres a été désactivée avec une erreur

Lorsque la synchronisation rencontre une erreur persistante, Communications Mining désactive la partie défaillante (une seule boîte aux lettres si possible ou l'ensemble de l'intégration lorsque les informations d'identification échouent) et informe les utilisateurs qui disposent d'autorisations d'intégration sur le projet. Pour lire l'erreur, accédez à la page Administration , sélectionnez l'onglet Intégrations et développez l'intégration ou la boîte aux lettres désactivée.

La plupart des erreurs de boîte aux lettres incluent une ligne Error details (Détails de l'erreur): contenant l'erreur non modifiée renvoyée par Microsoft. Cette ligne nomme l’erreur Microsoft sous-jacente, elle est donc incluse dans n’importe quel ticket d’assistance. Une fois que vous avez résolu la cause, réactivez la boîte aux lettres ou l'intégration.

Erreurs de boîte aux lettres

Erreur	Cause et résolution
Cannot access '<mailbox>' please review the access policies that are in place. avec les détails de l'erreur: ErrorAccessDenied: Access to OData is disabled: [RAOP] : Blocked by tenant configured AppOnly AccessPolicy settings.	La boîte aux lettres ne correspond pas à votre politique d’accès à l’application. Demandez à votre administrateur Exchange de l’ajouter au groupe de sécurité étendu, confirmez par Test-ApplicationAccessPolicy, puis réactivez la boîte aux lettres.
Mailbox '<mailbox>' was not found. The SMTP address has no mailbox associated with it. avec les détails de l'erreur: MailboxNotEnabledForRESTAPI: The mailbox is either inactive, soft-deleted, or is hosted on-premise.	L’adresse existe, mais il ne s’agit pas d’une boîte aux lettres que l’API Graph peut lire. Synchronisez plutôt une boîte aux lettres Exchange Online sous licence.
Mailbox '<mailbox>' was not found. The SMTP address has no mailbox associated with it. avec les détails de l'erreur: ErrorInvalidUser	L’adresse est mal orthographiée ou la boîte aux lettres a été supprimée. Corrigez l’adresse ou supprimez la boîte aux lettres de l’intégration.
Inbox folder was not found for mailbox '<mailbox>'	L’utilisateur ou l’application du service ne peut pas accéder à la boîte de réception. Accordez-lui un accès en lecture ou vérifiez les autorisations et la politique d’accès de l’application auprès de vos administrateurs.
Mailbox '<mailbox>' has encountered an unknown error with code: 403.	Exchange Online a refusé l'accès sans classer pourquoi, par exemple un quota de boîte aux lettres dépassé. Lisez la ligne Détails de l'erreur: et corrigez l'erreur qu'elle signale.
Une erreur contenant The security principal specified is already on the permission set, please remove duplicate.	La boîte aux lettres contient des entrées d’autorisation en double pour le même compte ou la même application. Demandez à votre administrateur Exchange de supprimer le doublon.

MailboxNotEnabledForRESTAPI couvre une liste de distribution, un utilisateur activé pour la messagerie sans boîte aux lettres, un compte sans licence et une boîte aux lettres toujours hébergée sur un serveur Exchange local dans une configuration hybride.

Erreurs d'intégration

Chacune des erreurs suivantes s'affiche sous Error acquiring Microsoft Exchange access token:

Erreur	Cause et résolution
AADSTS7000215 ou AADSTS7000222	La clé secrète du client n’est pas valide ou a expiré. Créez-en une nouvelle, mettez à jour les informations d'identification de l'intégration et notez la date d'expiration — une clé secrète expirée arrête l'ingestion jusqu'à la rotation.
AADSTS700016 ou AADSTS7000112	L’application est introuvable dans votre répertoire, ou un administrateur de locataires l’a désactivée. Confirmez l’ID de client et l’ID de locataire, puis vérifiez l’application dans le portail Azure.
AADSTS50076, AADSTS50079, ou AADSTS53003	Une authentification multifacteur ou une stratégie d’accès conditionnel bloque la connexion du compte. Demandez à vos administrateurs d’identité de l’exclure ou passez à l’authentification d’application.
Un message concernant les limites de consommation ou de quota	Votre organisation a atteint son quota de consommation ou de téléchargement. Vérifiez l’utilisation de votre licence, puis réactivez l’intégration.

Aucune erreur ne s’affiche, mais des e-mails sont manquants

Voici les situations où l'intégration semble correcte, mais où les e-mails n'arrivent pas, y compris le comportement attendu qui peut ressembler à une défaillance.

Symptôme	Cause et résolution
Les e-mails ont cessé d’arriver juste après avoir basculé une intégration des services Web Exchange (EWS) vers Graph.	Attendu: l'intégration vérifie les e-mails depuis le plus ancien point atteint par un dossier sur EWS, de sorte qu'un écart est suivi d'une période de rattrapage, sans doublons.
Les informations d’identification ont été validées, mais aucun e-mail n’arrive jamais.	La validation et l’enregistrement des informations d’identification confirment uniquement l’authentification, et non l’accès à la boîte aux lettres. Vérifiez chaque boîte aux lettres par rapport à la politique d’accès de votre application et recherchez les entrées désactivées dans la liste des boîtes aux lettres.
Un dossier attendu n'est pas synchronisé et aucune erreur ne s'affiche.	Les filtres de dossier correspondent au texte littéral par rapport au chemin complet du dossier, et un chemin qui ne correspond à rien est ignoré en mode silencieux. Vérifiez le préfixe, l’orthographe, la casse et les espaces de fin.
Les filtres de dossier qui fonctionnent dans une boîte aux lettres ne fonctionnent pas dans une autre.	Les chemins d'accès aux dossiers utilisent la langue de la boîte aux lettres, et non de l'utilisateur, de sorte que le préfixe et les noms de dossier sont localisés. Utilisez les propres noms de dossier de la boîte aux lettres.
Davantage de synchronisation de dossiers que prévu.	L'autorisation d'un dossier synchronise également ses sous-dossiers, et une boîte aux lettres sans filtre de dossier autorisé synchronise tout, y compris les éléments d'archives et récupérables. Un dossier refusé remplace un parent autorisé.
Des e-mails spécifiques sont manquants, même si leur dossier est synchronisé.	Un participant, un domaine ou une organisation refusé correspond à l’expéditeur et à tous les destinataires, y compris Cc et Cci. Refuser le dossier Éléments envoyés plutôt que votre propre domaine.
Une boîte aux lettres n'affiche aucun e-mail, mais aucune erreur non plus.	La cause la plus courante est un chemin de dossier incomplet. Une liste de dossiers autorisés refuse tout ce qu'elle ne correspond pas, de sorte qu'une seule entrée mal saisie arrête l'ensemble de la boîte aux lettres.
La première synchronisation semble lente.	La boîte aux lettres commence à se synchroniser en quelques minutes; la capture de l'historique prend plus de temps, en proportion avec l'e-mail après votre horodatage de début. Utilisez un horodatage de début récent.

Les chemins de dossier doivent commencer par root/Top of Information Store/, et ce préfixe est localisé sur une boîte aux lettres non anglaise, par exemple root/Oberste Ebene des Informationsspeichers/ sur une boîte aux lettres allemand.

Pour confirmer si un filtre est la cause, supprimez temporairement le filtre de dossier autorisé et vérifiez si la boîte aux lettres se synchronise sans lui. Une boîte aux lettres qui est réellement vide, ou dont les filtres ne correspondent à aucun e-mail, interroge avec succès et ne signale rien: il s'agit d'un état sain plutôt que d'un échec.

Pour savoir à quoi vous attendre lorsque vous basculez une intégration existante vers Graph, consultez le guide de migration de l’API EWS vers Microsoft Graph. Si votre problème n’est pas répertorié, soumettez un ticket d’assistance UiPath®.