Troubleshooting and things to know about Microsoft Dynamics 365 for Outlook

This section describes how to troubleshoot Dynamics 365 for Outlook installation and upgrade issues.

Tip

If you encounter an issue installing, connecting, or enabling Dynamics 365 for Outlook with your Customer Engagement organization, use the Microsoft Support and Recovery Assistant to diagnose and fix the issue. You’ll need to sign in to the diagnostics tool with your Customer Engagement credentials.

Potential issues and resolutions

Common Data Service

Microsoft Dynamics 365 for Outlook is not enabled on Common Data Service 2.0.

Assigned tasks not updated in Outlook after updated in Dynamics 365 apps

Consider the following scenario:

  • In Outlook, User 1 assigns Outlook task to User 2.

  • In Outlook, User 2 accepts and tracks the task.

  • In Customer Engagement, User 2 opens the task and makes a change such as changing the subject or marking the task complete.

    Result: for User 1, in Outlook, the task status remains unchanged.

    To force a status change: User 2, in Outlook, can open the Outlook task and click Send Status Report to update User 1’s Outlook with the latest information.

    Enabling the following settings in Outlook Task options (Home tab > New Items > Task > Assign Task) do not impact this issue:

  • Keep an updated copy of this task on my task list.

  • Send me a status report when this task is complete.

    This is a known issue and is not supported.

Simultaneous use of Dynamics 365 App for Outlook and Dynamics 365 for Outlook

Tracking activities is not supported when Dynamics 365 App for Outlook and Dynamics 365 for Outlook are used together by the same user.

Some Outlook add-ins can cause issues

Some Outlook add-ins can cause issues like connection failure and slow program startup and might be incompatible with Dynamics 365 for Outlook. Try disabling suspect add-ins to see if that resolves your issue.

Problem when using a proxy auto-config (PAC) file

Dynamics 365 for Outlook might have authentication and connection issues when using a proxy PAC file configured in workstation browsers.

If you’re offline, you can’t add a related record type by using the Add button (+). Add the related record type while you’re online, and then go offline.

Inserted picture replaced by text after sync

Inserting a picture from a file into an appointment is not supported.

Some fields synchronize data when an activity is created despite synchronization settings

When an activity is created, such as a task, some fields may synchronize even if field synchronization is set to not sync. This is a known issue as some fields cannot have an empty value.

Users in a different domain cannot install Dynamics 365 for Outlook

If the user domain account is in a domain different from the Customer Engagement organization, the user will receive an error message (see below) when installing Dynamics 365 for Outlook. This is not a supported scenario.

Error message

There is a problem communicating with the Dynamics 365 for Customer Engagement server. The server might be unavailable. Try again later. If the problem persists, contact your system administrator.

The caller was not authenticated by the service.

Synchronization support for Cached Exchange Mode

Outlook synchronization is not supported if Cached Exchange Mode is turned off in Outlook. See: Turn on Cached Exchange Mode

Server-side synchronization is supported if Cached Exchange Mode is turned off in Outlook. See: Turn on Cached Exchange Mode

Automatic email tagging off by default

This setting is in the Microsoft Dynamics 365 apps Diagnostics tool included with Dynamics 365 for Outlook. Click Start > All Programs > Microsoft Dynamics 365 apps > Diagnostics > Synchronization Troubleshooting tab.

Automatic email tagging is set to be off by default. If you enable this setting but reinstall Dynamics 365 for Outlook, automatic email tagging will be off.

Service Appointments and Activities don’t synchronize from Outlook to Dynamics 365 apps

Changes made to Service Appointments and Activities in Customer Engagement will update in Dynamics 365 for Outlook when you synchronize, but the reverse is not true. When you make changes to Service Appointments or Activities in Dynamics 365 for Outlook, the changes are not synchronized to Customer Engagement.

Different time value in date and time fields with User Local or Time-Zone Independent behavior

If you have system out-of-the box or custom date and time fields with User Local or Time-Zone Independent behavior, the date/time information for years before 1900 won’t display as entered when viewing in the list of records and reading pane in Dynamics 365 for Outlook. The date and time values are correct in the database and will appear as expected in the Customer Engagement web application.

Microsoft Dynamics 365 apps with Microsoft 365

When you try to connect to an organization that is part of your Microsoft 365 subscription by using the Configuration Wizard or Dynamics 365 for Outlook, you cannot connect. To resolve this issue, verify, and if necessary, correct the following:

  • Make sure that you can connect to the organization by using Internet Explorer. There may be incomplete information with your Microsoft Online Services account that is preventing you from authenticating with the service. The URL for the organization is provided in the invitation email message you should have received from Microsoft Online Services, and is typically in the form of https://OrganizationName.onmicrosoft.com or https://OrganizationName.crm.dynamics.com. If you are not certain of the URL, contact your system administrator

Log files

When you install and configure Dynamics 365 for Outlook, the system creates log files that you can use for troubleshooting.

By default, the location of the Setup log files (including crmsetup.log and crm60clientmsi.log files), where User is the account of the user who ran Setup, is as follows:

  • Windows 10, Windows 8, and Windows 7: SystemDrive:\Users\<User>\AppData\Local\Microsoft\MSCRM\Logs

    By default, the location of the configuration log files (including crm50clientconfig.log), where User is the account of the user who ran Configuration Wizard, is as follows:

  • Windows 10, Windows 8, and Windows 7: SystemDrive:\Users\<User>\AppData\Local\Microsoft\MSCRM\Logs

Important

By default, the AppData folder is hidden. To view the AppData folder, use Folder Options in Control Panel to enable viewing for hidden files and folders.

Tip

You can use the shortcut path to access the AppData folder, %LocalAppData%\Microsoft\MSCRM\Logs.

Event Viewer

To access event logging information for Dynamics 365 for Outlook, open Event Viewer from the client computer where Dynamics 365 for Outlook is installed, and then view the entries in the Application log.

To view the Application log in Event Viewer:

  1. On the computer where Dynamics 365 for Outlook is installed, start Event Viewer.

  2. In the navigation pane, expand Windows Logs and then click Application.

  3. To make it easier to locate events that apply to Dynamics 365 for Outlook, use Create Custom View or Filter Current Log and then select the following Event sources:

    • Event sources that begin with MSCRM (such as MSCRMAddin and MSCRMAddressBook)

    • MSSQL$Dynamics 365 apps

Disable the Dynamics 365 for Outlook notification bar on the Web application

By default, if a user does not have Dynamics 365 for Outlook installed and configured, the Microsoft Dynamics 365 apps web application displays a Get Dynamics 365 for Outlook button on the notification bar. This button provides a link for users to download and install software features that configure a local SQL Server Express data store. If you do not want users to have this capability, you can remove the button.

Remove the Get Dynamics 365 for Outlook button from the Microsoft Dynamics 365 apps web application

  1. With a security role that has read and write permissions (for example, the System Administrator role), start the Microsoft Dynamics 365 apps web application.

  2. Go to Settings > Administration.

  3. Click System Settings.

  4. Click the Outlook tab.

  5. Set the value for Users see “Get Dynamics 365 for Outlook” option displayed in the message bar to No.

  6. Click OK to close System Settings.

See Also

Blog: Microsoft Dynamics CRM for Outlook Configuration Diagnostic
Troubleshooting and monitoring server-side synchronization