🔐Role Management

Qualitia Automation Studio (QAS) - Role Management supports pre-defined and custom role creation to streamline the roles and responsibilities. They ensure your software testing process is not only robust but also adaptable to your unique requirements.

In this guide, we will cover how to create, update, assign roles to users, and remove roles, as well as the workflow and best practices for ensuring effective collaboration.

 📚Prerequisites

You must have administrative access to your Qualitia Automation Studio (QAS) to manage roles and assign users to roles.

🔀 Procedural Steps

In this section, we will cover the step-by-step guide to create and manage roles.

Create Custom Role

To create a new custom role:

1. Login to QAS - Client.

2. Access User Management from left navigation of your QAS - Client.

   1. Clicking User Management takes you to the User & Role Management screen.

3. By default, you land on the Users tab.

   1. Here you can view the existing users.

4. Click Roles to manage roles and view available roles. 

5. Click +Create Role from the top-right corner of the Roles screen. You will see a popup window.

   1. Enter the role name in the Role field.

   2. Enter a brief role description in in the Description field.

   3. Under Assigned Privileges section, select the checkboxes to assign the privileges.

   4. Click Save to continue; otherwise, click Discard.

6. Repeat the steps 2 through 5 for each additional role you want to add.

Here are some of the privileges you can assign:

• Activate Deactivate Projects: Activate or deactivate a project.

• Create Project: Create a project.

• Import Artifacts: Import test artifacts or other project elements.

• Manage Custom Actions: Develop, add, edit, or delete a custom action.

• Manage Objects: Control the objects within your testing environment.

• Manage Projects: Oversee all aspects of your projects.

• Manage Roles: Assign and modify user roles.

• Manage Scenarios: Control the scenarios within your test suites.

• Manage Suite: Add, edit, or remove suites.

• Manage Users: Oversee user access and privileges.

• Synchronize Objects: Import and export objects from TSR (Desktop projects only).

• Test Development: Create, update, and record test cases and tasks.

• Test Execution: Edit & publish suits. Publish test cases. 

🔎 View Roles

1. Login to QAS - Client.

2. Access User Management from left navigation of your QAS - Client.

   1. Clicking User Management takes you to the User & Role Management screen.

3. By default, you land on the Users tab, where you can view the existing users.

4. Click Roles to open the Roles screen.

   1. The Roles screen displays the following two sections:

      1. Roles: You can see all the existing QAS Roles.

         1. By default, the first Role in the Roles section is selected.

      2. Role Details: You can view role Description, Assigned Privileges, and the Assigned Users.

🔭 Find Roles

1. Login to QAS - Client.

2. Access User Management from left navigation of your QAS - Client.

   1. Clicking User Management takes you to the User & Role Management screen.

3. By default, you land on the Users tab, where you can view the existing users.

4. Click Roles to open the Roles screen, you will see the list of existing roles.

5. Click Find to search from the list of roles. A Find here popup will open.

6. Enter the role name and the searched keyword will be highlighted.

7. From the results, you can click and open the role you are looking for.

Update Roles

On the Roles screen, you can see two sections, the Roles and the Role Details. You have more than one way to update a role.

Method 1: Through the Roles Section

1. Login to QAS - Client.

2. Access User Management from left navigation of your QAS - Client.

   1. Clicking User Management takes you to the User & Role Management screen.

3. By default, you land on the Users tab, where you can view the existing users.

4. Click Roles to open the Roles screen, you will see the list of existing roles.

5. Hover your mouse over a role to see a pencil icon (Edit Role).

6. Click Edit Roles and a popup window will appear to edit the following:

   1. Name

   2. Description

   3. Assigned Privileges. Select or de-select the checkboxes to add or remove privileges.

7. Once completed, click Save to apply your changes. Otherwise, click Discard.

Method 2: Through the Role Details Section

1. Go to the Roles section in your QAS.

2. Click a specific role you want to edit. This will open the Role Details section.

3. In the Role Details section, click the pencil icon (Edit Role) at the top-left corner of the screen. This will open a popup window.

4. Follow steps 6 and 7 in Method 1.

❌ Delete Roles 

On the Roles screen, you can see two sections, the Roles and the Role Details. You have more than one way to delete a role.

Method 1: Through the Roles Section

1. Login to QAS - Client.

2. Access User Management from left navigation of your QAS - Client.

   1. Clicking User Management takes you to the User & Role Management screen.

3. By default, you land on the Users tab, where you can view the existing users.

4. Click Roles to open the Roles screen, you will see the list of existing roles.

5. Hover your mouse over a role to see the Bin icon (Delete Role).

6. Clicking the Bin icon (Delete Role) will open a window Role Deletion.

7. Click Delete to proceed. Otherwise, click Discard.

8. Repeat the steps 5 through 7 for each additional role you want to delete.

Method 2: Through the Role Details Section

1. Go to the Roles section in your QAS.

2. Click the specific role you want to delete. This will open the Role Details section.

3. In the Role Details section, click the Bin icon (Delete Role) at the top-left corner of the screen. This will open a popup window.

4. Clicking the Bin icon (Delete Role) will open a window Role Deletion.

5. Click Delete to proceed. Otherwise, click Discard.

💡 Golden Nuggets: Best Practices for Role Management

Crafting roles is not just about user management, it is also a crucial line of defense in maintaining security. Here are some best practices to keep in mind:

• Unique Roles: Each role should be distinct and specific to a set of responsibilities. This prevents overlap and confusion.

• Avoid Overloading: Avoid loading a role with too many privileges. The principle of least privilege should be followed - assign only necessary rights to a role.

• Memorable Yet Secure: Role names should be intuitive and easy to remember, but not too predictable to avoid potential security risks.

• Ideal Length: A role name that is too short may lack clarity, while a long one may be hard to remember. Aim for a sweet spot between 6 to 14 characters.

• Special Characters? Think Twice: Avoid special characters in the role name instead use your creativity to provide a better name.

• Consistent Naming Convention: Managing multiple roles? Having a consistent naming structure can simplify management and identification.

• No Offensive Language: Ensure the role names are professional and respectful.

• Regular Audits: Review roles and their privileges regularly to maintain security and prevent unauthorized access.

• Delete: Need to temporarily suspend a role? Remove users from the role instead of deleting it. If the role is no longer needed, then consider deletion. 

🔧 Got trouble? Let’s Fix🛠️

Can't create a role? Check if you have the administrative permissions.

📞📚 Here to Help: Support and Resources 💡

If you have questions that are not addressed in the documentation, you may raise them here.