The Lab console is for accessing devices and apps. You can also interact with a device and conduct exploratory testing. For details, see open a device remotely. Administrators use the console for configuring UFT Mobile settings and for managing users, workspaces, apps, and devices.
Note: Full multi-workspace functionality described here is only available with a Trial, Enterprise, or Ultimate license. If you install an Express or Pro license, or if you move from a Trial license to an Express or Pro license, you will have limited functionality. You will be able to manage the access of users to available devices by creating workspaces, and by moving devices and users to these workspaces, However, you will only be able to upload apps as shared assets.
UFT Mobile users can have either administrator or user roles. Existing administrators define the roles when creating new users. The menus displayed in the Lab console depend on the role of the logged-in user.
- Menus visible to users: DEVICE LAB and APPS. The view is a consolidated view of the devices or apps from all the workspaces to which the user has access. For details, see View and manage devices and View, upload, and manage apps.
- Administrators can view workspaces, users, and can see all the available assets. For details, see Admin Tasks.
When accessing the lab console without a testing tool, the displayed language is determined by the browser language.
UFT Mobile Lab console (on-premises deployment)
To access the UFT Mobile Lab console, navigate to:
http/s://<UFT Mobile server IP address>:<server port> and log in with your credentials.
If you enter a wrong password three consecutive times, UFT Mobile will lock you out. The default lockout time is 15 minutes.
Secure connection only (HTTPS): When using the default self-signed certificate, the browser displays a warning or error when you first access the UFT Mobile server over SSL. For web browsers to trust the SSL certificate presented by the server, it must be a certificate that was issued by a recognized Certificate Authority (CA). Although a self-signed certificate allows you to encrypt data, the warning informs you that the certificate was self-signed by the server, and not by a CA. To access the server, you need to trust the self-signed SSL certificate.
- Browser cookies must be enabled to work with UFT Mobile.
- Internet Explorer: If Internet security is set to High and meta refresh is disabled, the UFT Mobile Lab Management console displays a blank page. Meta refresh should be enabled, or alternatively, access the Lab console by navigating to:
https://<UFT Mobile server IP address>:<port>/integration/#/login
UFT Mobile Lab console (SaaS)
To access the UFT Mobile Lab console, navigate to the UFT Mobile SaaS URL provided to you, and log in with your credentials.
For first time login of the admin user, use the admin user credentials provided to you. Once logged in, you can add additional users and administrators.
Workspaces are individual work areas within your lab. Your administrator can create workspaces to segregate or share applications and devices between specific groups of users. Each individual workspace has its own devices, apps, and users. Devices and apps in the shared assets, are available to all users.
When you open the lab, you can view the devices and apps in the workspaces to which you have access, as well as shared assets. If you already logged in once, you will be connected to the last session's workspace. Admin users will have an additional page, Connectors with a list of the installed connectors. Select All in the masthead to view all devices and apps to which you have access.
To enable the Workspace filter to list a specific workspace, select the workspace name in the masthead, or alternatively select All for the filter to list all workspaces to which you have access. You can then filter by workspace as needed.
For a non-admin user: If you attempt to log in, and the workspace to which you had been assigned was removed, the login page indicates that you are not assigned to any workspaces and provides a link to the admin's email.
Tip: To allow the email link to open a new email, make sure to set your current email client as the default one. For details on doing this in Windows, see How to modify default mail client in Windows 10.
Non-admin users can download the Appium logs using the Collect Appium Logs option.
Admin users can access UFT Mobile version information, download log files, and obtain usage reports from the UFT Mobile server. Hover on the icon for a menu with these options:
- System Info shows the UFT Mobile version and build number, Linux edition/ Windows version, and the installed memory (RAM) on the server machine.
- Download Connector links to the AppDelivery Marketplace page with the UFT Mobile connectors.
- Collect Logs zips the log files created (including server, connector, and audit logs. ) and downloads them using your browser. Connector logs include the name of the connector.
Non-admin users can select Collect Appium Logs to download a zip file containing the Appium logs.
- Collect Usage Data downloads a zip file containing resource usage information. For details, see Data Usage Collection. This option is only available for Trial, Enterprise, and Ultimate license types.
Note: When using UFT Mobile as a managed service provided by an MSP or when shared spaces are enabled, only operators are able to view the system logs. For details, see Shared spaces (on-premises).
Users without administrator permissions, will see the UFT Mobile Help, Contact Your Admin, Download Connector, Collect Appium Logs, and What's New links. While the default email for admin is firstname.lastname@example.org, the admin can set the email address in the Administration Settings.
Data usage collection can help you:
- import data usage files to Excel or other services, to generate meaningful reports.
- integrate with BI (Business Insight) tools, such as Tableau, to connect to a database directly without the need to download the data every time.
When you select Collect Usage Data, your machine downloads audit.zip which contains the following CSV files:
- job.csv: General information about the job execution, such as job ID, start/end times, DevTunneled, workspace names, device information, and app information. DevTunneled indicates whether the device was tunneled using Dev Access.
- reservations.csv: Start and end times for each reservation with the associated connectors and devices. DevTunneled indicates whether the device was tunneled using Dev Access.
- application.csv: App name, app ID, upload ID, workspace, upload start and end times, and the upload duration.
- device.csv: Device ID, name, model, manufacturer, connection and disconnection times, connector name, DevTunneled, and workspace. DevTunneled indicates whether the device was tunneled using Dev Access.
- user.csv: Device ID, user name, login and logout information, workspaces, and jobs created.
Expand the sections below for examples of data processed in Excel representing a typical scenario.
The Reservations and Job CSV files allow you to visualize reservations and jobs over time and understand the workload and concurrency. You can sort the information by the relevant parameters, such as workspace, device, and user.
The following example shows the usage per device.
The Jobs CSV file allow you to visualize the duration of the jobs as a function of the workspace and time.
The following example shows the jobs per workspace per day and hour, for one month.
The Device CSV file allow you to visualize the device usage by workspace, as a function of time.
The following example shows the device usage over the duration of the job.
The Job CSV file also enables you to visualize the reservations and jobs of each user, per workspace and device, to better understand the user's activity.
The following example shows user activity on the various workspaces.
The data usage duration is determined from the General Administrator settings, where you set the duration time in days.
Note: The CSV files are encoded in UTF-8 format. By default, Excel uses ANSI encoding. To view the contents in Excel, we recommend that you specify UTF-8 when importing the data. For details, see How to import a .csv file that uses UTF-8 character encoding.
Why can't I see all my apps and devices?
- Check the filter panel to see which options are selected. UFT Mobile displays only the items that fit the filter conditions. To display all items, select all the filter options and clear the search field of any text that you have entered.
- Blue text in the filter pane indicates that a filter is active. The slider indicates the range of the OS versions. Make sure that you are not hiding your device's OS version number. In the following example, a filter is applied for the OS, but not for Features, Availability, or Connector.
You can use the clear filter link to clear all active filters.
- Make sure that you have access to the devices you need. Your administrator manages the workspaces and determines which devices will be available to you.
Why can't I log in?
If your user name is not associated with any workspaces, you will not be able to log in. This could happen if your admin deleted your workspace. Ask your UFT Mobile admin to check whether you are assigned to a workspace.