Exchange との連携をトラブルシューティングする

Communications Mining での Exchange との連携の同期に関する問題の解決策です。無効化されたメールボックスと連携、サイレント同期のギャップ、フォルダー フィルターの問題について説明します。

このページは、Communications Mining での Exchange との連携の同期の問題を診断するのに役立ちます™。観察できることから始めます。

• 連携またはそのメールボックスのいずれかがエラーにより無効化されました。
• エラーはどこにも表示されませんが、メールが欠落しています。

連携またはメールボックスがエラーにより無効化されました

同期で永続的なエラーが発生すると、Communications Mining は失敗した部分 (可能な場合は 1 つのメールボックス、資格情報自体に障害がある場合は連携全体) を無効化し、プロジェクトに対する連携権限を持つユーザーに通知します。エラーを読み取るには、[ 管理 ] ページに移動して [ 連携 ] タブを選択し、無効化されている連携またはメールボックスを展開します。

ほとんどのメールボックス エラーには、Microsoft によって返された未修正のエラーを含む Error details: 行が含まれます。この行に基になる Microsoft エラーの名前を付けるため、サポート チケットに含めてください。原因を解決したら、メールボックスまたは連携を再度有効化します。

メールボックスのエラー

Error	原因と解決策
Cannot access '<mailbox>' please review the access policies that are in place. エラーの詳細: ErrorAccessDenied: Access to OData is disabled: [RAOP] : Blocked by tenant configured AppOnly AccessPolicy settings.	メールボックスがアプリケーションのアクセス ポリシーの外部にあります。Exchange 管理者に、スコープを持つセキュリティ グループに追加するように依頼し、 Test-ApplicationAccessPolicyで確認してから、メールボックスを再度有効化します。
Mailbox '<mailbox>' was not found. The SMTP address has no mailbox associated with it. エラーの詳細: MailboxNotEnabledForRESTAPI: The mailbox is either inactive, soft-deleted, or is hosted on-premise.	アドレスは存在しますが、Graph API が読み取ることができるメールボックスではありません。代わりに、ライセンス済みの Exchange Online メールボックスを同期します。
Mailbox '<mailbox>' was not found. The SMTP address has no mailbox associated with it. エラーの詳細: ErrorInvalidUser	アドレスのスペルが間違っているか、メールボックスが削除されています。アドレスを修正するか、メールボックスを連携から削除します。
Inbox folder was not found for mailbox '<mailbox>'	サービス ユーザーまたはアプリケーションがメールボックスにアクセスできません。読み取りアクセス権を付与するか、アプリケーションのアクセス許可とアクセス ポリシーを管理者に確認します。
Mailbox '<mailbox>' has encountered an unknown error with code: 403.	Exchange Online は、メールボックスのクォータの超過など、理由を分類せずにアクセスを拒否しました。「 Error details: 」行を読み、報告されるエラーに対処します。
以下を含むエラー The security principal specified is already on the permission set, please remove duplicate.	メールボックスに、同じアカウントまたはアプリケーションのアクセス許可エントリが重複している。Exchange 管理者に重複を削除するよう依頼してください。

MailboxNotEnabledForRESTAPI 、配布リスト、メールボックスのないメールが有効なユーザー、ライセンスのないアカウント、およびハイブリッド設定でオンプレミスの Exchange サーバーでまだホストされているメールボックスが対象です。

連携エラー

以下の各エラーが の下に表示されますError acquiring Microsoft Exchange access token

Error	原因と解決策
AADSTS7000215 OR AADSTS7000222	クライアント シークレットが無効であるか、有効期限が切れています。新しいシークレットを作成し、連携の資格情報を更新して有効期限をメモします。有効期限が切れているシークレットは、ローテーションされるまで取り込みを停止します。
AADSTS700016 OR AADSTS7000112	アプリケーションがディレクトリ内で見つからなかったか、テナント管理者によって無効化されました。クライアント ID とテナント ID を確認し、Azure Portal でアプリケーションを確認します。
AADSTS50076、AADSTS50079、または AADSTS53003	多要素認証または条件付きアクセス ポリシーにより、アカウントのサインインがブロックされる。ID 管理者に、このアクティビティを除外するか、アプリケーション認証に切り替えるよう依頼してください。
消費量またはクォータの上限に関するメッセージ	組織が消費量またはアップロードのクォータに達しました。ライセンスの使用状況を確認し、連携を再度有効化します。

エラーは表示されませんが、メールが欠落しています

以下に、連携は正常に見えるにもかかわらずメールが届かない状況を示します。これには、エラーのように見える期待される動作が含まれます。

症状	原因と解決策
連携を Exchange Web サービス (EWS) から Graph に切り替えた直後に、メールが届かなくなっていました。	期待どおり: 連携により、EWS 経由で到達したフォルダーの最も早い時点からメールが再チェックされるため、ギャップの後にキャッチアップ期間が続き、重複は発生しません。
資格情報は正常に検証されましたが、メールが届きません。	[資格情報を検証して保存] では、認証のみが確認され、メールボックスへのアクセスは確認されません。各メールボックスをアプリケーション アクセス ポリシーに照らして確認し、メールボックスのリストに無効なエントリがないか確認します。
予期するフォルダーは同期されておらず、エラーは表示されません。	フォルダー フィルターは、リテラル テキストをフル フォルダー パスと照合し、何も一致しないパスはサイレントに無視されます。プレフィックス、スペル、大文字と小文字、末尾のスペースを確認します。
あるメールボックスで機能するフォルダー フィルターが、別のメールボックスでは機能しません。	フォルダー パスでは、ユーザーではなくメールボックスの言語を使用するため、プレフィックスとフォルダー名の両方がローカライズされています。メールボックス専用のフォルダー名を使用します。
予想よりも多くのフォルダーが同期されています。	フォルダーを許可すると、そのサブフォルダーも同期されます。許可されたフォルダー フィルターがないメールボックスは、アーカイブ アイテムと回復可能なアイテムを含むすべてを同期します。拒否されたフォルダーは、許可された親を上書きします。
特定のメールが、そのフォルダーが同期されていても見つからない。	拒否された参加者、ドメイン、または組織は、送信者とすべての受信者 (CC や BCC を含む) と一致します。独自のドメインではなく [送信済みアイテム] フォルダーを拒否します。
メールボックスにメールは表示されませんが、エラーも表示されません。	最も一般的な原因は、フォルダー パスが不完全であることです。許可フォルダー リストでは、一致しないものはすべて拒否されるため、エントリを 1 つ間違えるとメールボックス全体が停止します。
最初の同期は遅いようです。	メールボックスは数分以内に同期を開始します。履歴の確認には、開始タイムスタンプの後のメールに比例して時間がかかります。最近の開始タイムスタンプを使用します。

フォルダー パスは root/Top of Information Store/で始まる必要があり、そのプレフィックスは英語以外のメールボックスでローカライズされています (たとえば、ドイツ語のメールボックスでは root/Oberste Ebene des Informationsspeichers/ )。

フィルターが原因かどうかを確認するには、[許可されたフォルダー] フィルターを一時的に削除し、そのフィルターがなくてもメールボックスが同期されるかどうかを確認します。メールボックスが本当に空の場合、またはフィルターがメールと一致しない場合、ポーリングは正常に実行され、何も報告されません。これは、失敗ではなく正常な状態です。

既存の連携を Graph に切り替えた場合の処理については、「 EWS から Microsoft Graph API への移行ガイド」をご覧ください。問題がリストにない場合は、 UiPath® サポート チケットを送信してください。