Lab and workspace management
When logging into Digital Lab as an admin user, you have access to the Management tab of the Administration menu . Here you can define and manage workspaces and manage users. This menu is visible only to admin users.
Getting started with workspaces
You can create multiple workspaces within your shared space. Workspaces are individual work areas within your lab. Create workspaces to segregate or share applications and devices between specific groups of users.
Note: Multi-workspace functionality is available in:
- UFT Digital Lab with a Trial, Enterprise, or Ultimate license.
If you install a UFT Digital Lab Express or Pro license, or if you move from a Trial license to an Express or Pro license, you have limited functionality. You can manage user access to available devices by creating workspaces, and by moving devices and users to these workspaces. However, you can only upload apps as shared assets.
ValueEdge Digital Lab.
UFT Digital Lab Managed SaaS.
You can create your own custom workspaces, according to the needs of your organization. For example, you can define workspaces according to specific geographical areas, or by company division or team.
As an admin user, in the Lab management tab in the left panel, you see all devices, all apps, and all users with the names of the workspaces that are associated with them. Devices and apps in Shared assets are available to all users.
Create and update workspaces
Administrators use the Management tab for overall visibility, and to distribute devices, users, and apps between workspaces. To view the tab, click Administration in the right of the masthead.
An admin user can manage workspaces as follows:
|Create a new workspace
Click Add Workspace in the left panel and enter a name for the workspace.
|Edit a workspace
|To edit a workspace name, in the left panel, click the name to select it and modify its text. You can also add or remove devices, users, and apps from a workspace.
|Delete a workspace
In the left panel, hover over the workspace and click the Remove icon. Removing the workspace unassigns all users from the workspace, deletes all app versions from the workspace, and returns the devices to the shared assets.
Note that you cannot delete or rename the Default workspace or the Shared Assets.
|View a specific workspace
|In the left panel, select the workspace. Use the tabs on the right to view the devices, apps, and users assigned to a specific workspace.
When you connect new devices to Digital Lab, they are added to the shared assets. Admin users manage user access to devices in the Management tab. A device can only belong to one workspace.
|Assign one or more devices to a different workspace
Note: Assigning a device to a different workspace:
|View device info and manage a device
|For more information on a device, select the device and click More to open the Device Information window. Click one of the tabs: Details, Reservations, or Actions. For details, see Manage devices.
Note: When more than one device is selected, the More option is disabled.
The All users tab in the Management > Lab management section, lists all the users in the shared space.
|UFT Digital Lab/
UFT Digital Lab Managed SaaS
Only authorized users, who are included in the list of users, can work with Digital Lab. Admins can perform the following user management tasks in the All users tab of the Lab management section, or in the Users tab of a selected workspace:
You can also integrate LDAP with Digital Lab. This enables individuals in organizations that use LDAP for managing user credentials and permissions, to access Digital Lab with their LDAP credentials, without the need for the administrator to first add them to the list of authorized users. For details about using LDAP with Digital Lab, see Use Digital Lab with LDAP.
ValueEdge Digital Lab
Users are added in ValueEdge Administration > Spaces. For more details, see Add users in the ValueEdge help center.
The first time that a ValueEdge user accesses Digital Lab, they are automatically added to the Digital Lab list of users.
Important: Digital Lab and ValueEdge user roles are not related. The first ValueEdge user to access Digital Lab is assigned a Digital Lab admin user role. Subsequent ValueEdge users are added as standard Digital Lab users when accessing Digital Lab for the first time. For details on the differences between user roles, see the table in the section on Add a new user.
Relevant only for UFT Digital Lab and UFT Digital Lab managed SaaS.
- In the toolbar above the list of users, click +.
Enter the new user's email address and password. The password must be at least 6 characters long (maximum of 20 characters) and must contain at least:
- one digit from 0-9
- one lowercase English character
- one uppercase English character
SSO: When SSO is enabled, enter the user name as defined in the Identify Provider (IdP). No password is required.
Assign a role for the new user. User, Workspace admin, or Admin.
The Workspace admin has identical permissions to a User, with the added ability to assign or unassign existing users to the workspaces that they administer. For details, see Assign users to workspaces.
Permissions User, Workspace admin Admin View system info Download logs Can only download logs for devices to which they have access.
Can download all logs.
ValueEdge Digital Lab: Admins can download only the logs of on-premises connectors.
Workspace admin: Can assign/ unassign existing users to workspaces to which they belong.
Can create and delete users.
Can assign/ unassign existing users to a shared space in which they are assigned as an administrator. Can assign user roles within a shared space
Download all Users Devices
Can only access their private devices, devices in shared assets, or devices belonging to workspaces to which they have been assigned as users.
Has control of all devices. Can move devices between workspaces. View Connectors Can only view their own connectors. Can view and manage all connectors. Connector Access Keys
Can generate Connector access keys for users. View Reservations Can manage only their own reservations in the Reservations tab. Can toggle between All and Mine in the Reservations tab. Administration Menu
Workpace admin: Management, Settings, and Access Key tabs are visible but only limited actions can be performed.
User: Only Access Keys tab is visible. Users can to create and manage their own Execution access keys
Can access the administration area of the Lab to create and manage users, configure Digital Lab settings, and manage licenses.
Can access the workspaces area of the Lab to create and manage workspaces, and to assign users and devices to workspaces.
Note: When using Digital Lab as a managed service provided by an MSP or when shared spaces are enabled, share space admins cannot download server logs. Operators (MSPs) can download the logs and reset passwords. For details, see Shared spaces.
When adding a user from Lab management, the user is automatically assigned to the default workspace. When adding a user from a specific workspace, the user is automatically assigned to that workspace. To assign users to multiple workspaces, see Assign users to workspaces.
You can also add users via the command line with the user management script.
For SAML SSO only: Users can be added when logging in. If you enable the Automatically add user on login option in the SAML SSO integration Administration settings, after a user is authenticated, an initial login adds them to the list of users.
LDAP: For details on adding users when LDAP is enabled, see Use Digital Lab with LDAP.
Filter the user list to find a specific user, or to update their details.
- To filter by role, click the All roles, and select the appropriate check boxes.
- To filter by name, click the Search button in the top right corner of the list of users, and enter the text of the user's email or username.
Relevant only for UFT Digital Lab and UFT Digital Lab managed SaaS.
Admins can download the full list of shared space users, including LDAP and SSO users, in Management > Lab management > All users .
To download all users, click download users in the toolbar above the list of users. The file is downloaded in .csv format. It includes the username, role, and workspaces. User passwords are left empty.
The file can also be imported into Digital Lab using the User Management CLI tool. User passwords for existing users are not required when importing the file. For details, see Manage user accounts with scripts .
Administrators can edit a user's details or delete one or more users. These actions can be performed in Management > Lab management > All users, or in Management > Selected workspace > Users.
To reset a user's password or to change a user's role
You can also use the user_management script to change a user's password, change the role of a non-admin user to an administrator, or create a new administrator. For details, see Manage user accounts with scripts .
Note that resetting passwords is disabled when using:
|To delete one or more users
Select one or more users and click in the toolbar.
When you delete a user, the user is removed from the workspaces to which they were assigned, and any execution keys generated by the user are also deleted. Deleted users are not able to access Digital Lab.
Both admin and workspace admin users can assign users to a workspace. Users can belong to multiple workspaces. When adding a user from Lab management, the user is automatically assigned to the default workspace. When adding a user from a specific workspace, the user is automatically assigned to that workspace. By default, imported users (in case of an upgrade) are assigned to the Default workspace. For details on assigning users to workspaces when LDAP is enabled, see Use Digital Lab with LDAP.
To assign or unassign users to a workspace:
Note: You can only assign/ unassign users to workspaces to which you belong.
Upload or view apps assigned to workspaces
An admin user can get an overall view of which apps are assigned to what workspaces.
To view all lab apps:
- In Administration , click the Management tab to view the Lab management page.
- Select All apps to view all the apps in your lab.
- To upload an app, click the Upload button .
- Select the app and the workspace for which you want to upload the app. Click Upload.
Alternatively, you can upload an app directly from within the workspace.
- In the left pane, select the workspace for which you want to upload an app.
- In the right pane, select the Apps tab and click Upload .
Tip: For more information about the app, for example to see the specific upload of that app being used in a workspace, click More information.