Outlook troubleshooting

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

docs/extensions/outlook-integration/troubleshooting.md

@@ -0,0 +1,57 @@
+# Outlook troubleshooting
+
+In this article:
+
+* [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)
+* [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 in Administration -> Scheduled Jobs -> Outlook Calendar Sync -> Log
+
+## Check logs
+
+Check EspoCRM log at `<ESPOCRM_DIRECTORY>/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.. [][]
+```

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)