Manage users

1. On the Perfecto landing page, under Assets & Setup, click ACCOUNT SETUP.

2. In the Assets and Setup view, click Admin.
   

   The Admin view opens on the Users tab.

Org groups allow you to organize users into cohesive units. Users in the same org group can collaborate by sharing media and scripts stored in their own private group repository. When you add a new group, Perfecto automatically creates a repository for that group.

To add a group:

1. In the left pane, at the top, click the Add org group button.
2. In the Add org group dialog box, provide the following information:

   • Group name, for example My web team
     

     The group name cannot exceed 25 characters.

   • Description, for example Used by my web team
     

     The description cannot exceed 50 characters.

3. Add users to the group. You can enter a username or an email address.

   Restriction: Each user can only be part of one org group. For users that are already part of another group, Perfecto displays the name of the group that the user currently belongs to.

   If you decide to add the user to the group, Perfecto removes it from the other group.

4. To add additional org groups, turn on the Add another when done option.
5. Click ADD.

1. On the toolbar above the table, click the Add user button.

2. In the Add user dialog box, complete the new user details.
   

   For information on external users, see the External users section above.

3. To be able to receive SMS notifications, enter a mobile number for the user. This is of interest, for example, if you work with Scriptless Mobile and plan to schedule jobs.

4. To assign the user to an org group:

   1. Click Add to group.

   2. Select a group, or start typing a group name and then select the group.

5. Under Prompt user to change password after 1st login, do one of the following:

   • Keep the default selection of Yes. In this case, the system assigns a password, and the user receives a notification email with the username and password. When logging in to the system for the first time, the user is then prompted to change the password.

   • Select No and enter a custom password. Then specify how you want to notify the user:

     • Keep the Notify the user of the new account checkbox selected to have an email notification sent to the user. The message will include only the username, not the password. Make sure to share the password with the user through a secure channel.

     • Clear the Notify the user of the new account checkbox if you do not want to have an email notification sent to the user. Make sure to share both username and password with the user through a secure channel.

   Important: This option is also relevant if you use IdP.
6. To add additional users, turn on the Add another when done option.
7. Click ADD.
8. If you selected No in step 4, make sure to share the required information with the new user through a secure channel.

• Click a table row.
  

  The user details pane opens on the right. It displays information on:

  • The user, including status, username, email, last login, and created date

  • The roles that the user is assigned to

  • The device groups that the user is assigned to

1. Select one or more users in the table.

2. On the toolbar above the table, click the Change status button.

   This changes the status to active or inactive, depending on the current status of the user or users.

1. Select one or more users in the table.
2. On the toolbar above the table, click the Add to org group button.

3. Select a group, or start typing a group name and then select the group.

1. Select one or more users in the table.

2. On the toolbar above the table, click the Add to device group button.

   For more information, see Manage devices.

3. Select a group, or start typing a group name and then select the group.

1. Select the user in the table.

2. In the details pane on the right, on the DEVICE GROUPS tab, click the delete button next to the device group from which you want to remove the user.

   The user is removed from the group immediately. No confirmation is required.

1. Select one or more users in the table.
2. On the toolbar above the table, click the Add role button.

3. From the list, select a role:

   • Lab Administrator: User with privileges for device management, including editing, releasing, connecting, and disconnecting devices.

     Restriction: The Lab Administrator role is only available in hybrid clouds.

   • Administrator: User with privileges to perform most operations, including cloud administration.

     This user does not have privileges to perform device management. Operations around device management are reserved for users with the Lab Administrator role.

   • Handset viewer: User with privileges to:

     • Perform mobile automation, web automation, and manual testing using the devices in the assigned device group

     • View all reports and live executions

     • Stop all executions

   A user that has no role assigned has privileges to:

   • Perform mobile automation, web automation, and manual testing using the devices in the assigned device group

   • View all reports and executions

   • Stop own executions

You can edit a user's first name, last name, email address, and org group. In addition, you can set a user's password or delete a user.

1. Select the user whose details you want to edit.
2. On the toolbar, click the More actions button.
3. From the list, select Edit.

4. In the Edit user dialog box, do one of the following:

   1. Modify the information as needed. Then click SAVE.

      For information on external users, see the External users section above.

   2. Click DELETE USER. When prompted for confirmation, click YES.

1. In the left panel, select the org group from which you want to remove users.
2. Select one or more users in the table.
3. On the toolbar, click the Remove from org group button.

1. Select one or more users in the table.
2. On the toolbar, click the More actions button.
3. From the list, select Delete.
4. When prompted for confirmation, click YES.

1. Select a user in the table.
2. In the details pane on the right, on the ROLES tab, turn a role on or off as needed.

1. Select the user whose password you want to change.
2. On the toolbar, click the More actions button.

3. From the list, select Edit.

4. In the Edit user dialog box, in the Set password field, provide a new password.

5. Click SAVE.

1. In the right pane, select the org group you want to edit.
2. Click the edit button  on the right.
3. In the Edit Org group dialog box, make the required changes and click SAVE.

1. In the right pane, select the org group you want to delete.
2. Click the delete button on the right.
3. When prompted for confirmation, click YES.

You can export the list of users to a comma-separated values (CSV) file. This is helpful, for example, if you want to:

• Generate an email distribution list for announcements and updates

• Determine the number of users in each user group

• Identify users who have been inactive for a specified number of days or months

The file will include all available columns and a list of users based on the filter applied (if any).

To export to a CSV file:

• At the top right of the table, click the Download CSV button .