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.
Note: Browser cookies must be enabled to work with UFT Mobile.
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-shared space admin users can download the Appium logs using the Collect Appium Logs option.
Share space administrators 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 and downloads them using your browser. You can select the logs to download (server and/or connector). For connector logs, you can also select specific connectors.
You can include all logs in the download, or only the latest logs. Latest includes the two latest logs of each log type. For example, if there are 3 service log files, only service.log and service-1.log will be included. When shared spaces are enabled, server logs are not included and can only be downloaded by the Operator. For details, see Shared space management (on-premises).
Non-shared space 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 shared space 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 General settings section of 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 Intelligence) tools such as Tableau.
When you select Collect Usage Data, your machine downloads UFTM_usageData<date>.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.|
Start and end times for each reservation with the associated connectors and devices, as well as the actual duration of the reservation. This is useful because although there may have been a reservation for a device, this does not mean that the device was used. 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.|
Note: The format used for the time and date in these reports is epoch (Unix) time. For example, 1415836800000 corresponds to Thursday, 13 Nov 2014 00:00:00 GMT.
If the Unix time stamp value is in cell A1, enter the following formula in cell B1:
(A1/ 86400000) + 25569.
Format the values in cell B1 as a date so that the results are displayed as date and time.
If you only have a few values to convert, use an online epoch time converter.
Examples of typical scenarios
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. Click Clear to clear all active filter selections.
- 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.