Users
Contents
In the Users area, you manage all user accounts of your tenant: you create accounts, change master data, assign roles, import users via Excel and manage the lifecycle through to archiving, anonymisation or deletion.
16.1 The user list
Filters
| Filter | Function |
|---|---|
| Search | Searches first name, last name, email and external reference. |
| Status | All (default) · Active · Inactive · Archived · Anonymised. Deleted users are never displayed. |
| Roles | Multiple selection. Use the Must match: at least 1 | all toggle to specify whether a user must have at least one or all of the selected roles. |
| Site | Multiple selection. Shows users assigned to one of the selected sites. |
| Teams | Multiple selection with at least 1 | all toggle. The No team entry shows users without a team assignment. |
| Projects | Multiple selection with at least 1 | all toggle. The No project entry shows users without a project assignment. |
Tip
Example for the role filter: you select Coach and Auditor. With at least 1, you see all users who are coach, auditor or both. With all, you only see users who have both roles.
Table
The table shows the columns User (picture, “Last name, First name” and external reference), Status, Site, Role(s) (up to two roles, further roles as “+N” with tooltip) and Actions. Use Entries per page to select 10, 25, 50 or 100 entries.
Buttons above the table
Actions per user (⋮ menu)
| Action | Effect | Available |
|---|---|---|
| Edit | Change master data, site, teams, projects, SSO options (16.3) | active users |
| Roles | Assign roles and permission scopes (16.4) | active users, not your own account |
| Deactivate | Prevents sign-in, data is retained | active users, not for super administrators |
| Activate | Allows sign-in again | inactive users |
| Archive | See lifecycle (16.5) | active and inactive users |
| Anonymise | See lifecycle (16.5) | active, inactive and archived users |
| Delete | See lifecycle (16.5) | all displayed users |
You confirm Deactivate by entering the user's email address. Activate takes effect immediately. If the user's site has been deactivated in the meantime, a dialog informs you that the user will be assigned to the Default site on activation.
Note
Archiving, anonymising and deleting are never possible for your own account or for accounts with the super administrator role.
16.2 Adding a user
In the user list, click Add user.
Fill in the fields (see table).
Click Create. The button only becomes active once all mandatory fields are valid. The message User created confirms the process.
Then assign the required roles via the ⋮ > Roles menu (section 16.4).
| Field | Mandatory | Description |
|---|---|---|
| First name / Last name | yes | max. 255 characters |
| yes | Valid address that is unique in the system. It is also the user name for signing in. | |
| External reference | no | ID from another system (e.g. employee number), max. 255 characters |
| Site | yes | The default site is preselected. |
| Email communication enabled | – | Default: on. The user receives emails from the system, e.g. for setting the password. |
| Require password change at first sign-in | – | Only with email communication enabled. Default: on. |
| Password / Confirm password | yes* | *Only with email communication disabled. Automatically pre-filled with a secure 16-character password (eye icon to display it). 10–100 characters, at least 3 different characters. |
| Projects / Teams | no | Multiple selection; only active teams are offered. |
Note
If email communication is disabled, the user does not receive a password by email. In that case, give them the password through a secure channel.
If only the assignment to teams or projects fails, the user is still created. A notice then offers Retry assignments or Go to user list.
16.3 Editing a user
The Edit user dialog contains the same master data fields as when creating a user, plus additional options:
Save with Update.
| Email address rule | |
|---|---|
| Target is super administrator | The email address cannot be changed. |
| Target has an administrator role | Only a super administrator may change the email address. |
16.4 Managing roles
Use ⋮ > Roles to open the Manage roles dialog. Each role is switched on or off using a toggle; a short description explains the role (complete list in section 17). You cannot edit your own roles.
Administrative roles
Super administrator, content administrator, structure administrator, evaluation form administrator and user administrator. Only super administrators can see and assign the Super administrator role. When it is switched on, all roles are automatically activated with a global scope and locked – a super administrator cannot have restricted permissions.
Scoped roles and scopes
The roles Analyst, Auditor, Coach and Case manager each apply to a scope made up of teams and projects:
Note
The Coach role includes Auditor: when Coach is switched on, Auditor is automatically active and takes over the coach's scope.
System roles
Basic user is always active for every account and cannot be switched off. Save with Save; the message Roles updated confirms the change.
16.5 User lifecycle
In addition to activating and deactivating, three permanent actions are available that you can use to meet data protection requirements:
| Action | What is retained | What is removed |
|---|---|---|
| Archive | Name and history of the user | Email address, phone number, roles, team and project assignments, recordings, coachings in preparation as an agent. The email address becomes available for a new account; signing in is no longer possible. |
| Anonymise | Monitorings and completed coachings for statistics – with a pseudonym instead of the name | Name (replaced by a pseudonym), all other personal data, comments on their cases, recordings, roles, assignments, coachings in preparation |
| Delete | Monitorings and coachings they created as auditor or coach – displayed as “Deleted user” | The user and all data relating to them: cases, monitorings and coachings as an agent |
To confirm, enter the following depending on the current status: for active or inactive users the email address, for archived users the full name, for anonymised users the pseudonym.
Caution
Archiving, anonymising and deleting cannot be undone. Archived and anonymised users can neither be edited nor reactivated. Possible status changes: Active <> Inactive > Archived > Anonymised; deletion is possible from any status.
16.6 Importing users via Excel
Use the import to create many users at once or to update existing ones. The import runs in the background.
“Import jobs” overview
Import first takes you to the Import jobs overview. It shows the most recent imports with Import ID, Started by, number of Users, Status (Queued, In progress, Successful, Failed), the times Queued, Started, Completed and any Errors. The list refreshes automatically every 30 seconds; Refresh now refreshes it immediately. New import job starts an import.
Step 1: File upload
If required, download the template under IMPORT TEMPLATE with Download template (.xlsx) and fill it in.
Drag the file into the upload field or click into it to select it (one .xlsx file only, max. 10 MB).
Click Check data & continue.
Format rules:
Step 2: Import review
The preview shows key figures (Read from file, Planned new accounts, Will be updated, Validation errors), under Conflicts & new entities the projects and teams to be created and those that already exist, as well as the Detailed user list. Incorrect rows and duplicates are highlighted in red; the tooltip on the status icon states the error.
If everything is correct, click Queue import. You can continue working immediately and track progress under Import jobs. Use Back to upload to upload a corrected file.
Caution
The import can only be started once the file contains not a single incorrect row. Correct the Excel file and upload it again.