Skip to content

Commit f9a93d3

Browse files
authored
Merge pull request #8300 from MicrosoftDocs/improve-language-and-add-links-with-more-details
AB#4120, AB#4125: Update privilege-error-occurs-when-using-dynamics-365-app-for-outlook.md
2 parents 21af9e7 + 2cba0d0 commit f9a93d3

4 files changed

Lines changed: 50 additions & 71 deletions

File tree

.openpublishing.redirection.json

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12879,6 +12879,10 @@
1287912879
{
1288012880
"source_path": "support/power-platform/dataverse/d365-app-outlook/error-when-installing-crm-2016-outlook.md",
1288112881
"redirect_url": "/previous-versions/troubleshoot/dynamics/crm/error-when-installing-crm-2016-outlook"
12882-
}
12882+
},
12883+
{
12884+
"source_path": "support/power-platform/dataverse/d365-app-outlook/current-user-role-not-have-required-permissions.md",
12885+
"redirect_url": "/troubleshoot/power-platform/dataverse/d365-app-outlook/privilege-error-occurs-when-using-dynamics-365-app-for-outlook"
12886+
}
1288312887
]
1288412888
}

support/power-platform/dataverse/d365-app-outlook/current-user-role-not-have-required-permissions.md

Lines changed: 0 additions & 47 deletions
This file was deleted.

support/power-platform/dataverse/d365-app-outlook/privilege-error-occurs-when-using-dynamics-365-app-for-outlook.md

Lines changed: 44 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,41 +1,65 @@
11
---
2-
title: A privilege error when using Dynamics 365 App for Outlook
3-
description: A privilege error occurs when attempting to use Microsoft Dynamics 365 App for Outlook. Provides options to solve this issue.
2+
title: Privilege or permission error when using Dynamics 365 App for Outlook
3+
description: Solves a privilege or permission error that occurs in Microsoft Dynamics 365 App for Outlook.
44
ms.reviewer:
5-
ms.topic: troubleshooting
6-
ms.date: 03/31/2021
5+
ms.date: 03/06/2025
76
ms.custom: sap:Dynamics 365 App for Outlook Add-In
87
---
9-
# A privilege error occurs when attempting to use Microsoft Dynamics 365 App for Outlook
8+
# A privilege or permission error occurs in Microsoft Dynamics 365 App for Outlook
109

11-
This article provides a resolution for the issue that you may receive the **You don't have required privilege (prvReadOrganization)** error when trying to use the Microsoft Dynamics 365 App for Outlook.
10+
This article helps solve errors that occur when you try to use or open Microsoft Dynamics 365 App for Outlook.
1211

1312
_Applies to:_   Dynamics 365 App for Outlook
14-
_Original KB number:_   4563997
13+
_Original KB number:_   4563997, 4229661
1514

16-
## Symptoms
15+
## Symptom 1
1716

18-
When attempting to use the Microsoft Dynamics 365 App for Outlook, you encounter an error referencing a missing privilege such as the following error:
17+
When you try to use Dynamics 365 App for Outlook, you receive an error that resembles the following one:
1918

2019
> You don't have required privilege (prvReadOrganization), which limits certain functionality. Please contact your administrator to get necessary access.
2120
22-
## Cause
21+
### Cause
2322

24-
This error will appear if the user associated with the mailbox record does not have sufficient privileges to use Microsoft Dynamics 365 App for Outlook.
23+
This error occurs if the user associated with the mailbox record doesn't have sufficient privileges to use Dynamics 365 App for Outlook.
24+
25+
## Symptom 2
26+
27+
When you open Dynamics 365 App for Outlook, you receive the following error:
28+
29+
> We're sorry
30+
> We are unable to show Dynamics 365 App for Outlook because current user role does not have required permissions. Please contact your administrator to have required security role assigned to the Dynamics 365 App for Outlook solution.
31+
32+
If you select **Show more**, the additional details include the following information:
33+
34+
> Error: Don't have permissions to retrieve AppforOutlookModule id
35+
> Trace: Error: Don't have permissions to retrieve AppforOutlookModule id at new ...
36+
37+
### Cause
38+
39+
This error occurs if the Dynamics 365 security role doesn't have access to the app module used by the Dynamics 365 App for Outlook.
2540

2641
## Resolution
2742

28-
Option 1: Assign Microsoft Dynamics 365 App for Outlook User security role
43+
To solve these issues, use one of the following options.
44+
45+
### Option 1: Assign the "Dynamics 365 App for Outlook User" security role
46+
47+
The [Dynamics 365 App for Outlook User](/dynamics365/outlook-app/deploy-dynamics-365-app-for-outlook#step-3-provide-security-role-access) security role can be assigned to users who need to use Dynamics 365 App for Outlook. This security role is available from build 9.1.0.4206 or later. This option ensures that the users have the basic privileges needed to access Dynamics 365 App for Outlook.
2948

30-
A standard role exists to provide the privileges required to use Microsoft Dynamics 365 App for Outlook. This role is named Microsoft Dynamics 365 App for Outlook User and can be assigned to users who need to use App for Outlook. For more information on this role, see [Provide security role access](/dynamics365/outlook-app/deploy-dynamics-365-app-for-outlook#provide-security-role-access).
49+
### Option 2: Assign privileges to a custom security role
3150

32-
Option 2: Custom Role
51+
If you prefer to customize a security role to include the required privileges, refer to the [More information](#more-information) section for a list of privileges required to use Dynamics 365 App for Outlook.
3352

34-
If you prefer to customize a role to include the required privileges, refer to the More information section for a list of privileges required to use Microsoft Dynamics 365 App for Outlook.
53+
> [!IMPORTANT]
54+
> Custom security roles don't have access to the Dynamics 365 app module by default. The steps provided in [Step 3: Provide security role access](/dynamics365/outlook-app/deploy-dynamics-365-app-for-outlook#step-3-provide-security-role-access) are also required.
3555
3656
## More information
3757

38-
The following table lists privileges required to use Microsoft Dynamics 365 App for Outlook and the tab in a security role where the privilege can be found. A user with the System Administrator role can locate and modify a security role by navigating to **Settings** > **Security** > **Security Roles**. To view which role(s) are assigned to a specific user, navigate to **Settings**, select **Security**, select **Users**, select the specific User record, and then select **Manage Roles**.
58+
The following table lists privileges required to use Dynamics 365 App for Outlook and the tab in a security role where the privilege can be found.
59+
60+
A user with the System Administrator role can locate and modify a security role by navigating to **Settings** > **Security** > **Security Roles**.
61+
62+
To view which role(s) are assigned to a specific user, navigate to **Settings**, select **Security**, select **Users**, select the specific User record, and then select **Manage Roles**.
3963

4064
| Privilege name| Entity| Location (tab) within security role|
4165
|---|---|---|
@@ -45,8 +69,8 @@ The following table lists privileges required to use Microsoft Dynamics 365 App
4569
|prvWriteMailbox|Mailbox|Business Management|
4670
|prvReadMailbox|Mailbox|Business Management|
4771
|prvReadOrganization|Organization|Business Management|
48-
|prvSyncToOutlook (exchangesyncidmapping|Sync to Outlook|Business Management --> Privacy-related privileges|
49-
|prvUseOfficeApps|Use Dynamics 365 App for Outlook|Business Management --> Privacy-related privileges|
72+
|prvSyncToOutlook (exchangesyncidmapping)|Sync to Outlook|Business Management > Privacy-related privileges|
73+
|prvUseOfficeApps|Use Dynamics 365 App for Outlook|Business Management > Privacy-related privileges|
5074
|prvAppendToAccount|Account|Core Records|
5175
|prvReadAccount|Account|Core Records|
5276
|prvDeleteActivity|Activity|Core Records|
@@ -69,9 +93,9 @@ The following table lists privileges required to use Microsoft Dynamics 365 App
6993
|prvReadUserApplicationMetadata|User Application Metadata|Customization|
7094
|prvReadQuery|View|Customization|
7195
|prvReadWebResource|Web Resource|Customization|
72-
|prvSearchAvailability|Search Availability|Service Management --> Miscellaneous Privileges|
96+
|prvSearchAvailability|Search Availability|Service Management > Miscellaneous Privileges|
7397

74-
The following table lists additional privileges that are required to view some of the default views used inside the Microsoft Dynamics 365 App for Outlook forms. Without these privileges, a user may see the following error instead of the expected view (subgrid) of records:
98+
The following table lists additional privileges that are required to view some of the default views used inside the Dynamics 365 App for Outlook forms. Without these privileges, a user might see the following error instead of the expected view (subgrid) of records:
7599

76100
> You do not have permission to access these records. Contact your Microsoft Dynamics 365 administrator for help.
77101

support/power-platform/dataverse/toc.yml

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@
5252
href: d365-app-outlook/error-install-dynamics-365-app-outlook.md
5353
- name: Item level Server-Side Synchronization issues
5454
href: d365-app-outlook/troubleshoot-item-level-server-side-synchronization-issues.md
55-
- name: Privilege error when using App for Outlook
55+
- name: Privilege or permission error when using Dynamics 365 App for Outlook
5656
href: d365-app-outlook/privilege-error-occurs-when-using-dynamics-365-app-for-outlook.md
5757
- name: Something went wrong during sign-in when accessing App for Outlook
5858
href: d365-app-outlook/something-went-wrong-during-sign.md
@@ -64,8 +64,6 @@
6464
href: d365-app-outlook/the-view-is-not-available-error-when-opening-emails.md
6565
- name: Track and Set Regarding options are missing
6666
href: d365-app-outlook/track-set-regarding-options-miss.md
67-
- name: User role doesn't have required permissions
68-
href: d365-app-outlook/current-user-role-not-have-required-permissions.md
6967
- name: We're unable to connect to your server
7068
href: d365-app-outlook/we-are-unable-to-connect-to-your-dynamics-365-app-for-outlook-error.md
7169
- name: You don't have required role or privilege

0 commit comments

Comments
 (0)