roles.md

Domain 'roles'

The roles subfolder contains CSV import files for saving roles in bulk. This is a possible example of its content:

roles/
  ├──roles.csv
  └── ...

There is currently only one format for the role CSV line, here are the possible headers with a sample data set:

Uuid	Role name	Description	Inherited roles	Privileges	_order:1000
79e05171-afcb-47a3-84ec-3f7df078628f	Organizational: Clinician	A doctor having direct contact with patients rather than being involved with theoretical or laboratory studies.	Application: Records Allergies; Application: Uses Patient Summary	Add Allergies; Add Patient

Headers that start with an underscore such as _order:1000 are metadata headers. The values in the columns under those headers are never read by the CSV parser.

Let's review some important headers.

Header role name

This is not a localized header.
The role name is a primary identifier to access a role, therefore the role name cannot be edited once the role has been created.

Header Inherited roles

A list of roles to inherit from. This list is made of a semicolon ; separated list of role names.

Header Privileges

The list of privileges that this role contains. This list is made of a semicolon ; separated list of privilege names.

Further examples:

Please look at the test configuration folder for sample import files for all domains, see here.