From 56de561ed907fa17ccb02cbe50c4bd0d19e45cfb Mon Sep 17 00:00:00 2001 From: Max Date: Mon, 12 Apr 2021 19:09:44 +0300 Subject: [PATCH 1/2] Outlook troubleshooting --- .../outlook-integration/setting-up.md | 10 +--- .../outlook-integration/troubleshooting.md | 59 +++++++++++++++++++ 2 files changed, 61 insertions(+), 8 deletions(-) create mode 100644 docs/extensions/outlook-integration/troubleshooting.md diff --git a/docs/extensions/outlook-integration/setting-up.md b/docs/extensions/outlook-integration/setting-up.md index 7294f9e13..935a340dd 100644 --- a/docs/extensions/outlook-integration/setting-up.md +++ b/docs/extensions/outlook-integration/setting-up.md @@ -3,7 +3,7 @@ * [Integration](#integration) * [Access control](#access-control) * [Sync scheduling](#sync-scheduling) -* [Troubleshooting](#troubleshooting) +* [Troubleshooting](troubleshooting.md) ## Integration @@ -76,10 +76,4 @@ Permissions that need to be enabled: ## Sync scheduling -Sync is run by the scheduled job *Outlook Calendar Sync*. By default, it is executed every 10 minutes. You can change scheduling at Administration > Scheduled Jobs > Outlook Calendar Sync. - -## Troubleshooting - -Check whether the scheduled job is running Administration > Scheduled Jobs > Outlook Calendar Sync > Log. - -Check EspoCRM log at `data/logs` directory. You can also set the [log mode](../../administration/troubleshooting.md#enabling-debug-mode-for-a-logger) to `DEBUG` level to obtain more info from the log. \ No newline at end of file +Sync is run by the scheduled job *Outlook Calendar Sync*. By default, it is executed every 10 minutes. You can change scheduling at Administration > Scheduled Jobs > Outlook Calendar Sync. \ No newline at end of file diff --git a/docs/extensions/outlook-integration/troubleshooting.md b/docs/extensions/outlook-integration/troubleshooting.md new file mode 100644 index 000000000..d2b29421e --- /dev/null +++ b/docs/extensions/outlook-integration/troubleshooting.md @@ -0,0 +1,59 @@ +# Outlook troubleshooting + +In this article: + +* [Check logs](#check-scheduled-jobs) +* [Check logs](#check-logs) +* [Server side error 500: Could not get access token for Outlook](#server-side-error-500-could-not-get-access-token-for-outlook) +* [Application is not configured as a multi-tenant application](#error-application-is-not-configured-as-a-multi-tenant-application) +* [Non-admin user's issues](#regular-users-issues) +* [Max number of operations](#max-number-of-operations) + +## Check Scheduled Jobs + +Check whether the scheduled job is running Administration > Scheduled Jobs > Outlook Calendar Sync > Log. + +Check EspoCRM log at `data/logs` directory. You can also set the [log mode](../../administration/troubleshooting.md#enabling-debug-mode-for-a-logger) to `DEBUG` level to obtain more info from the log. + +## Check logs + +Check EspoCRM log at `/data/logs/*.log`. You can also set the [log mode](../../administration/troubleshooting.md#enabling-debug-mode-for-a-logger) to `DEBUG` level to obtain more info from the log. + +## Server side error 500: Could not get access token for Outlook + +Possible causes: + +* Redirect URI doesn't set or it is invalid. +* Client Secret is not propper or it is corrupted (sometimes your clien secret key may be corrupted or deprecated due to Outlook changes. Even if it is expiry date in the far future, create a new one and change it). + +## Error: Application is not configured as a multi-tenant application + +In the Azure Active Directory admin center from the app's Overview page, select the Authentication section and change the value selected under Supported account types. + +## Regular user's issues + +#### A user doesn't have the 'External Accounts' button + +Set the next permission in a role: +``` +External Accounts -> Access 'enabled' +``` +#### No Outlook services are available + +Set the next permissions in a role: +``` +Outlook Calendar -> Access 'enabled' +Outlook Contacts -> Access 'enabled' +``` + +## Max number of operations + +Outlook max number of operations in a batch request = 20. So if you will set in the config.php file: +``` +'outlookCalendarSyncMaxPortionSize' = 50, +'outlookCalendarPushMaxPortionSize' = 50, +``` +many records won't be synced. In EspoCRM log this error description looks like: +``` +Espo.ERROR: Outlook Calendar sync: Oauth: Error after requesting POST https://outlook.office.com/api/v2.0/me/$batch; Reason: The maximum number of operations in a batch request is 20.. [][] +``` From a13ee020886f8340dec869dfd3deacede51b294f Mon Sep 17 00:00:00 2001 From: Max Date: Mon, 12 Apr 2021 19:17:11 +0300 Subject: [PATCH 2/2] Outlook troubleshooting --- docs/extensions/outlook-integration/troubleshooting.md | 10 ++++------ docs/index.md | 1 + 2 files changed, 5 insertions(+), 6 deletions(-) diff --git a/docs/extensions/outlook-integration/troubleshooting.md b/docs/extensions/outlook-integration/troubleshooting.md index d2b29421e..b7d58d3a8 100644 --- a/docs/extensions/outlook-integration/troubleshooting.md +++ b/docs/extensions/outlook-integration/troubleshooting.md @@ -2,18 +2,16 @@ In this article: -* [Check logs](#check-scheduled-jobs) +* [Check scheduled jobs](#check-scheduled-jobs) * [Check logs](#check-logs) * [Server side error 500: Could not get access token for Outlook](#server-side-error-500-could-not-get-access-token-for-outlook) * [Application is not configured as a multi-tenant application](#error-application-is-not-configured-as-a-multi-tenant-application) -* [Non-admin user's issues](#regular-users-issues) +* [Regular user's issues](#regular-users-issues) * [Max number of operations](#max-number-of-operations) - -## Check Scheduled Jobs -Check whether the scheduled job is running Administration > Scheduled Jobs > Outlook Calendar Sync > Log. +## Check Scheduled Jobs -Check EspoCRM log at `data/logs` directory. You can also set the [log mode](../../administration/troubleshooting.md#enabling-debug-mode-for-a-logger) to `DEBUG` level to obtain more info from the log. +Check whether the scheduled job is running in Administration -> Scheduled Jobs -> Outlook Calendar Sync -> Log ## Check logs diff --git a/docs/index.md b/docs/index.md index f69a2ab26..d6b58385b 100644 --- a/docs/index.md +++ b/docs/index.md @@ -91,6 +91,7 @@ * [Calendar](extensions/outlook-integration/calendar.md) * [Contacts](extensions/outlook-integration/contacts.md) * [Email](extensions/outlook-integration/email.md) + * [Troubleshooting](extensions/outlook-integration/troubleshooting.md) * VoIP integration * [Asterisk server](extensions/voip-integration/asterisk-integration-setup.md) * [Binotel service](extensions/voip-integration/binotel-integration-setup.md)