BeyondERP.Newsletter
Menu

Setup page · System administration

Assign users to roles

A setup page where administrators give users security roles, either by hand or through automatic assignment rules.

Used by
Security administrator
Business process
Administer system features
Menu item
SysSecRolesEditUsers
Main table
UserInfo
Data entity
None for this page's own settings
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 setup page where administrators give users security roles, either by hand or through automatic assignment rules.
What you do hereUse this page to assign users to security roles, exclude users from automatic assignment, or remove users from roles.
ExampleFor example, an administrator selects the Accounting supervisor role, adds a rule based on a query of business data, and then runs automatic role assignment.
Assign users to roles 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 › Security › Assign users to roles
Set up firstUsers Microsoft Learn Set up Users
Used next byUsers Microsoft Learn
Related pagesSegregation of duties rules 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.

Step by step, with screenshots

Assign users to roles1 screen

Use this page to assign users to security roles, exclude users from automatic assignment, or remove users from roles.

  1. Screen 1

    Assign users to roles

    Go to System administration > Security > Assign users to roles

    1. Select a role in the list on the left
    2. Under Users assigned to role, select Manually assign / exclude users to add or remove users
    3. Under Rules for dynamically assigning users to role, select Add rule to assign users automatically
    Assign users to roles (zoomed on the outlined fields)
    Show the full screenAssign users to roles
    page title tab to open what to set or check

Steps from Microsoft

  1. Go to System administration > Security > Assign users to roles.
  2. In the tree, select the role that you want to set up a rule for.
  3. Select Add rule.
  4. In the Select a query list, select the query to use for the rule.
  5. Select Edit query, change the query as needed, and then select OK.
  6. Select Run automatic role assignment.
  7. On the Users page, check the roles that users now have, and adjust the rule if needed.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExampleTable column
Assignment modeShows how a user is linked to the role: None when the user isn't assigned, or Manual when an administrator assigned or excluded the user by hand.Microsoft Learn AutomaticAssignmentMode

Common errors and fixes

MessageWhat to do
A user who changed job keeps the old roleManual assignments aren't removed by the rules. Remove the user from the role by hand, or move the role to a rule. Microsoft Learn
Assigning a role is refused because of a segregation of duties conflictDeny or allow the assignment on Segregation of duties unresolved conflicts; an allowed assignment needs a reason. Microsoft Learn

Test checklist

  1. Select a role, add a rule with a query and select Run automatic role assignment.
  2. Open Users in another tab and check that the expected users now have the role.
  3. Exclude one user from the role and run the assignment again; check that the user doesn't have the role.
  4. Assign a different user by hand and check that Assignment mode shows Manual.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Assign users to rolesAutomatic role assignment rules for roles that follow business data, Exclude from role for exceptions, and manual assignment only where no rule fitsRules assign roles from business data when you run automatic role assignment. Users added by hand aren't managed by the rules, so every manual assignment is one more user an administrator must remember to remove.Should users get this role through an automatic assignment rule or by hand?Assigning roles by hand and expecting the rules to clean up. Manually assigned users stay in the role until an administrator removes them, even after they change jobs.Test: Automatic role assignment follows the rule

Feature management and licence

Licence or add-inOn this system the page opens for Security administrator. Security administrators assign roles. No Feature management feature needs to be turned on for this page.

Microsoft Learn

Solution architect

5Design impact

Shared or per companyShared: role assignments are made once for the environment; a role can be limited to organizations when assigned. Microsoft Learn
Can it be undoneReversible: Remove users from a role at any time. Manual assignments must be removed by hand; rule-based assignments change the next time Run automatic role assignment runs. Microsoft Learn
If you change it laterUsers who were added to a role by hand stay in it until an administrator removes them, because automatic assignment rules don't remove them. Microsoft Learn
Technical architect

6Technical

Menu itemSysSecRolesEditUsers Checked in Dynamics 365
FormSysSecRolesEditUsers Checked in Dynamics 365
TableUserInfoShown as “User Information” in Record infoChecked in Dynamics 365
Data entitiesSystemSecurityUserRoleAssociationEntitySecurity user role association (only the user-to-role assignments, not the automatic assignment rules) SystemSecurityUserRoleOrganizationEntitySystem security user role organization assignment (only the organizations a user's role is limited to)
Who can open itPrivilegesMaintain role assignments for user SysSecRoleAssignmentMaintainDutiesMaintain security settings SysSecSecurityMaintain
1 security roleSecurity administrator SysSecSecurityAdministrator
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itSecurity administrator SysSecSecurityAdministratorGive people one of these roles. On this system, 1 role can open this page.Checked in Dynamics 365
Actions on the pageOptions: Personalize, Page options, ShareChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=SysSecRolesEditUsers
Data migrationSystemSecurityUserRoleAssociationEntity (Security user role association): shared by all companies, in Microsoft's default template 010 - System Setup.SystemSecurityUserRoleOrganizationEntity (System security user role organization assignment): shared by all companies; not in Microsoft's default templates.Load order: Microsoft's default template 010 - System Setup loads Security user role association at level 10, sequence 250, after User information (230). Load organization limits after the assignments. Set up automatic assignment rules again by hand.Load first: User information, Custom roles from Security configurationChecked in Dynamics 365
Everyone

8Sources