Administration Guide
This guide will empower administrators to maintain their tenants, projects and users.
Q12-TMT has three different Admin Roles that users can be assigned to:
- User Admin: Manages user accounts, their roles and respective access rights
- Project Admin: Manages project and several overviews within the project
- Tenant Admin: Manages and configures the company's TMT tenant
User Admin
The User Admin can create, edit, delete and set active/inactive users, as well as their respective roles and the corresponding access rights. Only users that are not assigned to a business object of Q12-TMT, e.g. a Test Case, can be deleted.
It is possible to use user directories to manage accounts but there is also a built-in standalone management tool within TMT.
To navigate to the administrative functions, click on the 
icon in the top left corner.
User Management
The user management can be found via the icon in the top left corner, just below "My Projects".
Here you can find a list of all users and maintain the details of their profiles.
To search for a user accounts, click on the search icon at the top 
. To only filter for the keyword in specific fields, e.g. the name, click on the filter icon 
.
Click on the "+ User" button to create a new user, or select an existing user from the list to maintain it.
For each account, email, password and name can be set here, as well as the corresponding roles of the account. Roles can either be assigned to the whole system or to a specific project. When they are assigned to a project, they are automatically assigned to all subprojects too. Lastly, it is possible to set an expiration date for accounts on which Q12-TMT will set them to "inactive".
A user has to be assigned to a project to be able to interact with the project.
Role Management
The role management shows a list of all existing roles. A role is a collection of access rights which can be assigned to a user. To distinguish roles more easily, a name and a description can be set for each role.
To search for a specific role, simply enter a keyword into the search field at the top , Q12-TMT then will only list roles that contain the String in the name or description. It is possible to filter only by name or by description by clicking on the icon.
Click on the "+ Create" button to create a new role, select it from the list to edit an existing one.
Besides the name and the description, you can select specific access rights to define the role in detail by clicking on the desired available access right. The selected access right will appear on the right-hand side. To unselect it, simply click on the selected access right again.
Roles can also be restricted to a specific client.
Note: For roles with read-only access, such as guest users, certain actions like project editing may be visible in the user interface but cannot be executed.
Access Rights Management
The access rights management shows a list of all existing access rights. They consist of a name and a description and represent a specific permission. Permissions are needed to be able to read, edit or interact in any other way with Q12-TMT's documents.
Be aware, that the name is a static attribute which references a specific permission function and cannot work without an exact match with available permissions.
Similar to the Role Management, it is possible to search for access rights that contain a particular keyword in the name or the description. With the button, Q12-TMT will exclusively filter one of the two fields.
Click on the "Create" button to create a new access right.
To edit an existing access right, just select it in the list.
Since access rights are collected in roles and therefore are assigned to projects and users with them, they are only valid in the contexts of said accounts and projects.
Project Admin
The Project Admin is assigned to a specific project and is able to customize it. This refers to the project information, e.g. the title and description.
Project Admins also can configure the tables that are displayed in the project. The following overviews can be customized:
- Test Cases
- Test Suites
- Test Runs
- Test Selection (Test Suites & Test Cases)
- Test Scope
To edit the displayed fields in the table, navigate to the projects tree. Search the project from the list, open the context menu by either clicking on it with the right mouse button, or by clicking on the 
button on the right-hand side. Select "Settings" 
and Q12-TMT will open the project settings. After clicking on "EDIT", you can tick and untick the fields you want to be displayed in each overview.
Tenant Admin
The Tenant Admin is able to oversee and export data of the tenant, as well as configuring the whole tenant.
To navigate to the administrative functions, click on the icon in the top left corner.
Tenant Settings
To configure the tenant, select "Tenant settings" from the menu. A view with two tabs will open:
- General configuration: Here the Tenant Admin can set the default language of the tenant, as well as the default time zone. The maximum number of active users is visible here too, but it can't be edited by the Tenant Admin. The amounts of allowed active users depends on the subscription plan.
- Jira integration: Here the default Jira URL is set which will be used to reference JIRA tickets within Q12-TMT's business objects.
Active Users
The list of active users can be accessed via the hamburger icon by selecting "Active users" 
.
It contains the username, the full name, the email address, as well as the projects the user is assigned to.
By clicking "EXPORT USER DATA", this list will be exported as .csv file.