Batch Actions help administrators manage and modify potentially large groups of users simultaneously. You will find the Batch Action icon on the License Information page.
The Batch Actions include:
- Assign projects
- Reset Passwords
- IMPORTANT: Resetting a user's password will reset all of that user's tokens.
- Export Users
- Update Users
- Activate Users
- Deactivate Users
- Resend Invite Emails
Why Use Batch Actions?
Some Administrators may be in charge of very large numbers of users and having to act upon each of these users one by one can become very costly. Batch Actions can vastly cut down the time administrators spend when modifying users and their information in qTest.
Users will need to be a Site Administrator in order to be able to access the Administration features and use Batch Actions.
Assign Users to Projects: Use Case
If a Site Administrator wants to assign multiple users to multiple projects using the Batch Action feature, follow these steps:
- In qTest Manager, select Administration from the username drop-down menu.
- The Licenses tab page displays. Here, select the checkbox(es) associated with the users whom you want to be added to your project(s).
- Select the Batch Action icon. From the drop-down menu, select Assign to Projects.
- The "Add Users to Projects" dialog displays. Select the Project(s) from the menu on the left, and then select the right arrow.
- Select Save. Your selected users have now been added to the selected project(s).
Bulk Edit User Profiles: Use Case
Site Administrators can also bulk edit User Profiles for one user across multiple Projects. This is helpful for adding a user to multiple Projects, while also managing their User Profiles (which might vary based on the Project.)
- Edit Projects and Profiles:
- Allows you to update the user's User Profile on a per Project basis.
- This can also be used for adding this individual user to other Projects.
User Authentication: Use Case
Site Administrators can batch manage User Authentication. The following actions can be performed in batches:
- Admins can import user info from an XLS file allowing you to change authentication system information.
- Admins can save the external username of an internal user. That way, you can reuse these usernames if there is a switch from LDAP to SSO authentication. Previously, these external usernames were not imported when changing the authentication system, and if changing back, the admin had to re-enter external usernames.
- Users are automatically activated when an admin changes their authentication system from Internal to LDAP/SSO using the import tool.
Update Users (Import) Batch Action
The Batch Action associated with updating user information allows site administrators to export an Excel file from qTest. Users can then modify the Excel file and re-import the file into qTest. The imported file differs from the exported file, and columns will need to be removed from the exported file, to accommodate the acceptable import file format.
The imported file is scanned for viruses or malware. If the file is clean, it is processed and users will see results after the import is done.
If the file is infected or the scanning service is down, then an error will be shown on the Import dialog: "Some of the imported file(s) are found virus or malware infected and cannot be processed. Please remove the infected file(s) to proceed."
qTest will read the file and can update the following user information accordingly:
- First Name
- Last Name
- Auth system
- SSO username
- LDAP username
Note: If an internal user was once authenticated by an SSO system, his or her old SSO username would be included in the export file.
Admins can also check logs for exact error reports for each user. These logs can be exported into Excel, modified, and then re-imported back into qTest Manager to send an invitation with the correct information.
Example Use Case:
When changing the authentication system from LDAP to SSO, in most cases, SSO usernames will be the same as LDAP usernames. The site admin may want to export users with LDAP usernames first and then re-use the LDAP usernames as SSO usernames.
In qTest, enabling SSO will automatically disable LDAP, and all LDAP usernames are cleared out. In this case, the site admin should export users BEFORE disabling LDAP or enabling SSO.