Using “EWS Editor” to fix “Dynamics 365 App for Outlook” issues

This article describes how to use the EWS Editor for Dynamics 365 utility to resolve Dynamics 365 App for Outlook issues. This post is a continuation of my previous article where I listed several checks to fix deployment issues with the Dynamics Outlook App.

EWS Editor was originally created to demonstrate the capabilities of the Exchange Web Services API. EWS Editor for Dynamics 365 is based on that one to provide additional utilities and troubleshoot issues related to Server-Side Synchronization and the E-mail Router.

Because the Dynamics 365 App for Outlook relies on the Server-Side Synchronization, this utility becomes also useful to resolve issues with the Dynamics Outlook App. In our case, we were getting the following error:

ExchangeError:UnknownIncomingEmailIntegrationError

This happened to us when we enabled the Dynamics Outlook App in a different organisation. So the app for this user was first enabled in organisation A, then we needed to deactivate it in this org and add it in organisation B, but we started to get that error and we couldn’t deploy it in org B and it also stopped working in org A 😦 .

The following steps describe how we use this tool to finally fix the problem:

Step 1 – Download EWS Editor for Dynamics 365

Step 2 – Launch “EWSEditorForDynamics365.exe”

Step 3 – Connect to Exchange Service

ramontebar_blog_EWSEditor_Exchange Connection

ramontebar_blog_EWSEditor_Exchange Connection Authentication.png

Step 4 – Add Mailbox Root

ramontebar_blog_EWSEditor_Mailbox root dialog

ramontebar_blog_EWSEditor_Mailbox root folders

Step 5 – Connect to Dynamics 365 Service

ramontebar_blog_EWSEditor_Connect to Dynamics 365 Service

Step 6 – Open All Items

Expand MsgFolderRoot and select Allitems by double clicking it.

Step 7 – Show To-Be Tracked Items

Navigate to View => Filter View Items => Show To-Be Tracked Items

ramontebar_blog_EWSEditor_Show To-Be Track Items

Step 8 – Check that crmLinkState is set to 1

Exchange Items (email, tasks, contacts, appointments) that have been tracked in Dynamics will have some additional properties to define the link between the systems. One of those properties is crmLinkState, which should have one of these values:

0 – Item is not tracked

1 – Item To-Be tracked

2 – Item has been tracked

ramontebar_blog_EWSEditor_crmLinkState

Step 9 – Hard Delete* all items to be tracked (pending tracking) where crmLinkState is 1

Right click on each item and navigate to Delete Item => Hard Delete

ramontebar_blog_EWSEditor_Hard Delete.png

*Please notice you may lose important information, so make sure you are ok deleting those emails or other items.

Step 10 (END!) – Enable the Mailbox again

  1. Now navigate to your Dynamics instance.
  2. Open the User mailbox and click on “Test and Enable Mailbox”.
  3. Check the Box “Sync items with exchange
  4. Wait till you receive the “Success” message for both emails and appointments.
  5. Once you receive the Success message, deploy/add the app again.
  6. This should resolve the issue.

If you want to learn more about the EWS Editor, check the following URL:

https://blogs.msdn.microsoft.com/mstehle/tag/EWSEditor/

**Credits: Thanks to my colleague Narendra for helping me to put this content together.

About Ramon Tebar

Software Engineer specialised on Microsoft Technologies with experience in large projects for different industrial sectors as developer, consultant and architect. I enjoy designing and developing software applications, it is my job and one of my hobbies. I’m interested in design patterns, new technologies and best practices. Making those part of the ALM process is a great challenge. During the last years, I have specialised in Microsoft Dynamics CRM (now Dynamics 365). I customise and extend the platform to provide tailored solutions and integrations based on service-oriented architectures and messages queuing. Motivated by community events and contributor in blogs, technical books, open source projects and forums, I have been awarded Microsoft Most Valuable Professional (MVP) on Dynamics 365 (CRM) since 2012.

Posted on November 24, 2017, in Dynamics 365, Dynamics Outlook App, Microsoft Exchange, Outlook, Server-Side Sync and tagged , , , , . Bookmark the permalink. Leave a comment.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: