|Available in: Logi Info|| Source code name: UserRoles||Introduced in: v10.0.189|
The UserRoles element controls how the server determines the current user's list of roles or groups.
From the list of roles, the security system can determine the list of rights for the user. Alternatively, you can directly get the rights without using roles at all. (See the Rights element for more details.) Roles are most valuable when there is not a one-to-one relationship between role values and right values or when role values and right values should are not the same.
Include a DataLayer under UserRoles to get the list from your own custom data source. The data should return roles in multiple rows or with a comma-delimited list in one row. Set the column containing roles with the RolesDataColumn attribute. The first column is used by default.
UserRoles is not used in some cases. When the "Authentication Source" attribute is set to "AuthNT" the list of roles automatically comes from the operating system roles or groups for the current user. When the "Authentication Source" attribute is set to "SecureKey" the list of roles is obtained from the SecureKey "Roles" parameter, and the rights from the “Rights” parameter.
The following elements have been deprecated, but are fully supported, in favor of this UserRoles element.