|
1 | 1 | --- |
2 | | -title: Errors when opening 365 App for Outlook |
3 | | -description: Troubleshooting errors when attempting to open Dynamics 365 App for Outlook. |
| 2 | +title: Errors when opening Dynamics 365 App for Outlook |
| 3 | +description: Solves common errors that might occur when attempting to open Microsoft Dynamics 365 App for Outlook. |
4 | 4 | ms.reviewer: |
5 | | -ms.topic: troubleshooting |
6 | | -ms.date: 03/31/2021 |
| 5 | +ms.date: 03/10/2025 |
7 | 6 | ms.custom: sap:Dynamics 365 App for Outlook Add-In |
8 | 7 | --- |
9 | | -# Troubleshooting errors when attempting to open Microsoft Dynamics 365 App for Outlook |
| 8 | +# Error occurs when trying to open Dynamics 365 App for Outlook |
10 | 9 |
|
11 | | -This article provides a solution to errors that occur when using Dynamics 365 App for Outlook. |
| 10 | +This article provides resolutions for an issue where you can't open Microsoft Dynamics 365 App for Outlook due to an error. |
12 | 11 |
|
13 | 12 | _Applies to:_ Dynamics 365 App for Outlook |
14 | 13 | _Original KB number:_ 4345548 |
15 | 14 |
|
16 | 15 | ## Symptoms |
17 | 16 |
|
18 | | -When attempting to open Dynamics 365 App for Outlook, you receive an error message. |
| 17 | +When trying to open Dynamics 365 App for Outlook, you might receive an error message. |
19 | 18 |
|
20 | | -## Use the Help me resolve this issue link |
| 19 | +## Resolution 1: Use the "Help me resolve this issue" link |
21 | 20 |
|
22 | | -Most errors you may meet will include a **Help me resolve this issue** link. If it appears, make sure to select this link. If Microsoft is aware of a potential solution to the issue, this link will direct you to an article created to help solve that specific error. |
| 21 | +If an error occurs, check for a **Help me resolve this issue** link. Selecting this link will direct you to an article created to help solve the specific error if Microsoft is aware of a potential solution. |
23 | 22 |
|
24 | | -## Clear your browser cache |
| 23 | +## Resolution 2: Clear your browser cache |
25 | 24 |
|
26 | | -If you're using Office 365 version 16.0.11629 and Windows 10 version 1903 or later, follow these steps as Office Add-ins are now using [Microsoft Edge WebView](https://developer.microsoft.com/office/blogs/microsoft-edge-webview-for-office-add-ins/): |
| 25 | +### For Office 365 version 16.0.11629 and Windows 10 version 1903 or later |
| 26 | + |
| 27 | +Follow these steps as Office Add-ins are now using [Microsoft Edge WebView](https://developer.microsoft.com/office/blogs/microsoft-edge-webview-for-office-add-ins/): |
27 | 28 |
|
28 | 29 | 1. Install [Microsoft Edge DevTools Preview](https://www.microsoft.com/p/microsoft-edge-devtools-preview/9mzbfrmz0mnj#activetab=pivot:overviewtab). |
29 | | -2. In Outlook, launch the Dynamics 365 app for Outlook. |
30 | | -3. Run Microsoft Edge DevTools Preview. |
31 | | -4. You should see Dynamics 365 (EXP) as a debug target. |
32 | | -5. Select it to launch the **F12** tools. |
33 | | -6. Go to the **Console** tab. |
34 | | -7. Run: window.localStorage.clear(). |
35 | | -8. Open the app again in Outlook. |
| 30 | +2. In Outlook, open Dynamics 365 App for Outlook. |
| 31 | +3. Run Microsoft Edge DevTools Preview. You should see Dynamics 365 (EXP) as a debug target. |
| 32 | +4. Select it to open the **F12** tools. |
| 33 | +5. Go to the **Console** tab. |
| 34 | +6. Run `window.localStorage.clear()`. |
| 35 | +7. Reopen Dynamics 365 App for Outlook in Outlook. |
36 | 36 |
|
37 | | -If you're using early versions of Office 365 and Windows, use the following steps: |
| 37 | +### For earlier versions of Office 365 and Windows |
38 | 38 |
|
39 | | -|**Platform**|**Instructions**| |
| 39 | +|Platform|Instructions| |
40 | 40 | |---|---| |
41 | | -|Outlook (same as Internet Explorer)| [View and delete your browsing history in Internet Explorer](https://support.microsoft.com/topic/view-and-delete-your-browsing-history-in-internet-explorer-098ffe52-5ac9-a449-c296-c735c32c8678) | |
42 | | -| Internet Explorer| [View and delete your browsing history in Internet Explorer](https://support.microsoft.com/topic/view-and-delete-your-browsing-history-in-internet-explorer-098ffe52-5ac9-a449-c296-c735c32c8678) | |
43 | | -| Edge| [View and delete browser history in Microsoft Edge](https://support.microsoft.com/microsoft-edge/view-and-delete-browser-history-in-microsoft-edge-00cf7943-a9e1-975a-a33d-ac10ce454ca4) | |
44 | | -| Chrome| [Clear cache & cookies](https://support.google.com/accounts/answer/32050) | |
| 41 | +| Internet Explorer or Outlook| [View and delete your browsing history in Internet Explorer](https://support.microsoft.com/topic/view-and-delete-your-browsing-history-in-internet-explorer-098ffe52-5ac9-a449-c296-c735c32c8678) | |
| 42 | +| Microsoft Edge| [View and delete browser history in Microsoft Edge](https://support.microsoft.com/microsoft-edge/view-and-delete-browser-history-in-microsoft-edge-00cf7943-a9e1-975a-a33d-ac10ce454ca4) | |
| 43 | +| Google Chrome| [Clear cache & cookies in Google Chrome](https://support.google.com/accounts/answer/32050) | |
45 | 44 |
|
46 | 45 | > [!IMPORTANT] |
47 | | -> Although you may have other browsers installed on your computer, Outlook desktop always uses Internet Explorer when displaying web content such as inside Dynamics 365 App for Outlook. As mentioned in the beginning of this section, it's no longer true starting with Office 365 version 16.0.11629. |
| 46 | +> Although other browsers might be installed on your computer, the Outlook desktop client always uses Internet Explorer to display web content, such as the content inside Dynamics 365 App for Outlook. However, starting with Microsoft 365 version 16.0.11629, this is no longer the case. This means that Outlook desktop no longer relies solely on Internet Explorer for displaying web content and might use other browsers or web technologies instead. |
| 47 | +
|
| 48 | +After clearing your browser cache, close all Internet Explorer and Outlook desktop windows. Use Task Manager to ensure that no Internet Explorer processes are running. |
48 | 49 |
|
49 | | -After clearing your browser cache, close all Internet Explorer and Outlook desktop windows and make sure through Task Manager there are no remaining Internet Explorer processes running. |
| 50 | +### Use F12 IEchooser (not applicable for Windows 7) |
50 | 51 |
|
51 | | -If this issue only appears in Outlook desktop and clearing the cache via Internet Options doesn't help, try clearing it via F12 chooser (not applicable for Windows 7): |
| 52 | +If this issue only appears in the Outlook desktop client and clearing the cache via Internet Options doesn't help, try clearing it via F12 IEchooser (not applicable for Windows 7): |
52 | 53 |
|
53 | | -1. Open Dynamics app in Outlook desktop. |
54 | | -2. Open **IEChooser.exe** in `%WindowsFolder%\System32\F12`(example: `C:\Windows\System32\F12`). |
55 | | -3. Select **Dynamics 365**. |
| 54 | +1. Open Dynamics 365 App for Outlook in the Outlook desktop client. |
| 55 | +2. Open **IEChooser.exe** located in `%WindowsFolder%\System32\F12` (for example: `C:\Windows\System32\F12`). |
| 56 | +3. In the **Choose target to debug** window, select **Dynamics 365**. |
56 | 57 | 4. Select the **Network** tab and then select the **Clear cache** button. |
57 | 58 |
|
58 | | -After following the steps above, reopen Outlook and the Dynamics 365 App for Outlook to see if the issue is resolved. |
| 59 | +After completing the preceding steps, reopen Outlook and Dynamics 365 App for Outlook to check if the issue is resolved. |
| 60 | + |
| 61 | +#### More information |
| 62 | + |
| 63 | +[Debug a task pane add-in using the F12 tools](/office/dev/add-ins/testing/debug-add-ins-using-f12-tools-ie#debug-a-task-pane-add-in-using-the-f12-tools) |
59 | 64 |
|
60 | | -If you're using a Mac, see [Clearing the Office application's cache on a Mac](/office/dev/add-ins/testing/debug-office-add-ins-on-ipad-and-mac#clearing-the-office-applications-cache-on-a-mac). |
| 65 | +### For Mac users |
61 | 66 |
|
62 | | -## Other Known Issues |
| 67 | +To solve the issue, see [Clearing the Office application's cache on a Mac](/office/dev/add-ins/testing/debug-office-add-ins-on-ipad-and-mac#clearing-the-office-applications-cache-on-a-mac). |
63 | 68 |
|
64 | | -["The view is not available" error message appears when opening an email in the Dynamics 365 App for Outlook](https://support.microsoft.com/help/4338690) |
| 69 | +## Resolution 3: Open a support case |
65 | 70 |
|
66 | | -## Opening a support case |
| 71 | +If you can't resolve the issue and need assistance from Microsoft, include the following information to expedite your support case: |
67 | 72 |
|
68 | | -If you're unable to resolve the issue and need help from Microsoft, include the following information to help solve your case as fast as possible: |
| 73 | +1. Repro steps |
69 | 74 |
|
70 | | -1. Repro Steps |
71 | 75 | Provide detailed steps that result in the error. |
72 | | -1. Error Details |
| 76 | + |
| 77 | +1. Error details |
| 78 | + |
73 | 79 | Include the details of any error message that appears. If the error includes a **Show more** option, copy and paste these details into the case. |
74 | | -1. Environment Details |
| 80 | + |
| 81 | +1. Environment details |
75 | 82 |
|
76 | 83 | Include information such as the version of the following components: |
77 | 84 |
|
78 | | - - Outlook (ex. Office 2013 SP3) |
79 | | - - Microsoft Exchange (ex. Exchange 2013 CU15 or Exchange Online) |
80 | | - - Operating System (ex. Windows 10) |
| 85 | + - Outlook |
| 86 | + - Microsoft Exchange |
| 87 | + - Operating system |
| 88 | + |
| 89 | +1. User impact |
81 | 90 |
|
82 | | -1. User Impact |
83 | | - Indicate if the issue occurs for all users, or only certain users such as only users with a certain security role or only users with a certain version of Outlook. |
| 91 | + Indicate if the issue occurs for all users or only specific users, such as those with a certain security role or Outlook version. |
84 | 92 |
|
85 | 93 | [!INCLUDE [Third-party disclaimer](../../../includes/third-party-disclaimer.md)] |
0 commit comments