BeyondERP.Newsletter
Menu

Report page · System administration

Security role access

A report that shows the effective permissions of each security role, grouped by type across its sub-roles, duties and privileges.

Business process
Administer system features
Menu item
output:SysRoleEffectiveAccessReport
Setup steps
1 on this page
Show what matters for
PAGE GUIDEWhat the page does and how to use it8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA report that shows the effective permissions of each security role, grouped by type across its sub-roles, duties and privileges.
What you do hereUse this report to see exactly which objects a role gives access to.
ExampleFor example, before giving a warehouse supervisor a role copied from another site, an administrator runs this report for that role only, with Rebuild collection = Yes, and reads which menu items and tables it opens.
Security role access page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

Business processAdminister system features
Menu pathSystem administration › Inquiries › Security › Security role access
Set up firstSecurity configuration Microsoft Learn
Used next byAssign users to roles Microsoft Learn
Related pagesSecurity duty assignments Microsoft Learn User role assignments Microsoft Learn
End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

When to run it

When to run itWhen you need to know exactly which objects a role opens, for example before you assign a powerful role or after a role was changed.
How oftenOn demand, before role assignments and after role changes.
Batch settingsRun it in the background for many roles or when Rebuild collection is Yes, because building the data set can take some time.
What the output showsA flattened list of the effective permissions of each role, grouped by object type across all its sub-roles, duties and privileges. If a role change you just made doesn't show, the report was run with Rebuild collection set to No.

Source: Microsoft Learn

Setup steps on this page

Check what a role really gives access to

Use this report to review security assignments for an access review or audit.

Steps from Microsoft

  1. Go to System administration > Inquiries > Security > Security role access.
  2. Set Rebuild collection to Yes the first time you run the report or when role definitions might have changed. Set it to No to reuse the existing data set and finish faster.
  3. Limit the report to the roles you need under Records to include, because the full data set can be very large.
  4. Expand a role to see the categories of objects it gives access to, then expand a category to list each object of that type.
  5. Compare the objects with what the role is meant to allow, and note any object that should move to another role.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExample
Rebuild collectionWhether to rebuild the report data; No reuses the existing data and runs faster.Microsoft Learn
Records to include > FilterLimits the report to the users or roles you add as filters; by default all are included.Microsoft Learn
Batch processingUnder Run in the background, Yes runs the report as a batch task with a job name and batch group; the task creates the report when it runs.Microsoft Learn Yes

Common errors and fixes

MessageWhat to do
The report runs for a long time or blocks the sessionLimit the report under Records to include, or set Batch processing to Yes so a batch task creates it. Microsoft Learn

Test checklist

  1. Change a privilege in a test role.
  2. Run Security role access for that role with Rebuild collection = No, then with Yes.
  3. Compare the two outputs.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Check what a role really gives access toRun it for the roles you review with Rebuild collection = Yes after any role change, and No when nothing changedThe data set can be very large; Rebuild collection = No reuses the last data set and finishes faster, but then misses role changes made since.When is the report data set rebuilt?Running with Rebuild collection = No after changing a role, so the report shows the old permissions.Test: Check what a role really gives access to

Feature management and licence

Licence or add-inSecurity administrators run it for access reviews. No Feature management feature needs to be turned on for this page.

Microsoft Learn

Solution architect

5Design impact

Shared or per companySystem-wide: the report covers users and roles of the whole system, with any restriction of a role to a legal entity or organization shown under it. Microsoft Learn
Can it be undoneNothing to undo: The report only reads security data. Rebuild collection refreshes the report data set, not the roles. Microsoft Learn
If you change it laterRunning the report changes no roles. Rebuild collection = Yes rebuilds the report's data set, which can take some time for many roles. Microsoft Learn
Technical architect

6Technical

Menu itemoutput:SysRoleEffectiveAccessReport Checked in Dynamics 365
FormSysOperationTemplateForm Checked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=output:SysRoleEffectiveAccessReport
Data migrationLoad order: Security role access has no data entity in Data management, so it can't be loaded from a file or a configuration template. The report reads security data live, so there is nothing to move.Checked in Dynamics 365
Everyone

8Sources