Skip to content

Commit 7733dd1

Browse files
authored
combine two articles
1 parent c69f544 commit 7733dd1

4 files changed

Lines changed: 45 additions & 67 deletions

File tree

.openpublishing.redirection.json

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12867,6 +12867,10 @@
1286712867
{
1286812868
"source_path": "support/power-platform/dataverse/d365-app-outlook/error-when-installing-crm-2016-outlook.md",
1286912869
"redirect_url": "/previous-versions/troubleshoot/dynamics/crm/error-when-installing-crm-2016-outlook"
12870-
}
12870+
},
12871+
{
12872+
"source_path": "support/power-platform/dataverse/d365-app-outlook/current-user-role-not-have-required-permissions.md",
12873+
"redirect_url": "/troubleshoot/power-platform/dataverse/d365-app-outlook/privilege-error-occurs-when-using-dynamics-365-app-for-outlook"
12874+
}
1287112875
]
1287212876
}

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: 40 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,63 @@
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 Permissions Error When Using Dynamics 365 App for Outlook
3+
description: Solvess the privilege or permissions error that occurs in Microsoft Dynamics 365 App for Outlook.
44
ms.reviewer:
55
ms.date: 02/25/2025
66
ms.custom: sap:Dynamics 365 App for Outlook Add-In
77
---
8-
# A privilege error occurs when attempting to use Microsoft Dynamics 365 App for Outlook
8+
# A privilege or permissions error occurs in Microsoft Dynamics 365 App for Outlook
99

10-
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.
1111

1212
_Applies to:_   Dynamics 365 App for Outlook
1313
_Original KB number:_   4563997
1414

15-
## Symptoms
15+
## Symptom 1
1616

17-
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:
1818

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

23-
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.
2440

2541
## Resolution
2642

27-
Option 1: Assign Microsoft Dynamics 365 App for Outlook User security role
43+
### Option 1: Assign the "Dynamics 365 App for Outlook User" security role
44+
45+
The [Dynamics 365 App for Outlook User](/dynamics365/outlook-app/deploy-dynamics-365-app-for-outlook#provide-security-role-access) security role can be assigned to users who need to use 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.
2846

29-
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).
47+
### Option 2: Assign privileges to a custom security role
3048

31-
Option 2: Custom Role
49+
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.
3250

33-
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.
51+
> [!IMPORTANT]
52+
> 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#provide-security-role-access) are also required.
3453
3554
## More information
3655

37-
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**.
56+
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.
57+
58+
A user with the System Administrator role can locate and modify a security role by navigating to **Settings** > **Security** > **Security Roles**.
59+
60+
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**.
3861

3962
| Privilege name| Entity| Location (tab) within security role|
4063
|---|---|---|
@@ -44,8 +67,8 @@ The following table lists privileges required to use Microsoft Dynamics 365 App
4467
|prvWriteMailbox|Mailbox|Business Management|
4568
|prvReadMailbox|Mailbox|Business Management|
4669
|prvReadOrganization|Organization|Business Management|
47-
|prvSyncToOutlook (exchangesyncidmapping|Sync to Outlook|Business Management --> Privacy-related privileges|
48-
|prvUseOfficeApps|Use Dynamics 365 App for Outlook|Business Management --> Privacy-related privileges|
70+
|prvSyncToOutlook (exchangesyncidmapping)|Sync to Outlook|Business Management > Privacy-related privileges|
71+
|prvUseOfficeApps|Use Dynamics 365 App for Outlook|Business Management > Privacy-related privileges|
4972
|prvAppendToAccount|Account|Core Records|
5073
|prvReadAccount|Account|Core Records|
5174
|prvDeleteActivity|Activity|Core Records|
@@ -68,9 +91,9 @@ The following table lists privileges required to use Microsoft Dynamics 365 App
6891
|prvReadUserApplicationMetadata|User Application Metadata|Customization|
6992
|prvReadQuery|View|Customization|
7093
|prvReadWebResource|Web Resource|Customization|
71-
|prvSearchAvailability|Search Availability|Service Management --> Miscellaneous Privileges|
94+
|prvSearchAvailability|Search Availability|Service Management > Miscellaneous Privileges|
7295

73-
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:
96+
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:
7497

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

support/power-platform/dataverse/toc.yml

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -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)