View and manage devices
Click DEVICE LAB>DEVICES to display the devices in the Lab.
- Administrators will see all the devices that have been connected to UFT Mobile. An admin user will also have full control over the devices and the workspaces to which they belong.
- Users will see all of UFT Mobile's shared devices (devices in Shared Assets), as well as devices assigned to the workspace in which they are working.
The following details are displayed in the Devices page and device card:
License capacity. This the number of devices that can be accessed concurrently. For more, see License installation and management.
- Device Host.The device host type, for example, for a device hosted privately, or EMULATED for an emulated device. For details about hosted devices, see UFT Mobile hosted device lab integration. You can use the Features filter to filter by physical, emulated devices, or hosted devices.
- Settings app blocked . If your administrator has not granted permission to non-admin users change the settings on the device, this icon is displayed in the top-right of the device card. If for some reason access to the Settings app could not be restricted for non-admin users, this icon will be displayed. Note that while you can still interact with the Settings app, replay will fail with a 2700 error.
- Number of devices. The number of devices that match the current filter, out of the total number of connected devices.
- Operating System and version. A read-only field in the card's top left corner.
- Device name. Click the name to edit it. The default is the model number of the device.
Note that if your administrator has not granted you permission to update this field, you will not be able to edit the device name.
- Manufacturer, model, and ID. A read-only field in the indicating the device information.
- Workspace name. The workspace to which the device is assigned .
Connector latency. The latency between the client and connector to which the device is connected. To view the connector's latency value, for example Remote view latency: 18 ms, hover over the latency icon . For optimal remote screen viewer performance, select a device with good latency. The latency is considered good if it is less than 100 ms (green), mediocre if it ranges between 100 and 200 ms (yellow), poor if it ranges between 200 and 300 ms (red), and bad if it exceeds 300 ms (gray).
Note: The latency display is not supported for Internet Explorer or Edge browsers.
Reservations. The reservations for the device. For example, Available or Reserved by... Until. Click this section to view and create reservations. A triangular emblem at the bottom right of the device indicates its status:
Reserved for you Reserved and in use by you Reserved for someone else Reserved and in use by someone else
You can also view the devices in a list. Click the List and Card view buttons in the upper right corner to toggle between the views. To see device details in List view, select a device and click More.
Note: To use iOS devices with UFT Mobile you must re-sign the Agent apps with a development certificate of an Apple Developer account. For details, see Re-sign the Agent apps.
You can find a specific device in one of the following ways:
- Search. In the right pane, click the Search button. In the text box, specify the name, device ID, model, or manufacturer of the device.
Filter. Use the left panel filter in the Devices page to limit what items are displayed, so that you can focus on the information that is important to you. Using the filter panel, you can specify your criteria in the following areas:
- OS. Operating System: Android or iOS. Use the slider to select an OS version.
- Features. Physical or Emulator device, Phone or Tablet
, SV enabled device, hosted device.
- Connector. The connector whose devices you want to display.
- Workspace. Display devices assigned to a specific workspace.
Available Available devices Reserved for me Devices reserved for you, or that are currently in use by you. Reserved for others Devices that have been reserved for someone else, or are currently in use by someone else. Disconnected Devices that were once connected to UFT Mobile, but are no longer connected. Disconnected devices are displayed faded.
Tip: Use the Clear link in the upper right corner of the filter panel, to remove all of your device filters.
When you hover over a specific device in Card view or select it in List view, the following options are displayed
Open device remotely. For Available or Reserved for me devices, access the device remotely. This reserves the device for 30 minutes or uses an existing reservation, allowing you to interact with the device
If the device is in the Reserved and In Use By Me state, the interaction with the device in the remote session will be limited and most options in the control panel will not be available. However, this option is useful for when you want to remotely connect to a device while an unattended test (such as an Appium test) is running. If the device is Reserved for or In use by others, or if you do not have the adequate license capacity, this button will be disabled.
When you are finished working with the device, click END SESSION in the top right-hand corner of the remote window to close the session and delete the device reservation.
For information about exploratory testing and interacting with the device, see Device control panel.
Remove device. Remove a Disconnected device. To remove a device with another status, it must first be disconnected from UFT Mobile.
Unlock device. Release a device that is locked.
The top section contains general information about the device: its ID, name, network connectivity level,
This window has four tabs:
Tip: You can also access the Device Information window by clicking the lower section of a device card (for example, where it says "Available").
To view the devices associated with a specific connector, click the X Devices link in the row of the desired connector. The Devices view opens with the devices filtered for the selected connector. If you enabled UFT Mobile Hosted Device Lab integration in the Administration Settings, you will also see the hosted device lab connectors. You can also see when the Agent Apps were last distributed to connectors, and by hovering over the icon, the versions of the Agent apps that were last distributed.
The action buttons above the grid enable you to :
- Distribute Agents to selected connectors.
- Reconnect Devices, a step required after the Agent app distribution status is complete. Select multiple rows to perform this action on several connectors at once.
- Remove a connector from the list. This can only be done for a disconnected connector. The button only removes the connector from the list of connectors; it does not delete the physical connector installed on a remote machine. When a connector that has been removed is restarted, it will be displayed again in the grid.
Tip: You can select multiple connectors and apply the actions to all of the selected connectors.
To add a new connector:
Click Download Connector.
To allow non-admins to install connectors and connect devices, you need to provide them with access keys. For details, see Access key management.
To distribute agents:
- Select the required connectors in the grid and click Distribute Agents.
- The distribution will begin. Refresh the page to see the distribution status in the Last Distibuted column of the grid.
When the distribution status is complete, you need to reconnect the devices. Do one of the following:
- Select the relevant connectors in the grid, and click Reconnect devices.
- From the Lab console, restart the iOS devices associated with that connector.
- Physically disconnect and reconnect the devices.
You can make a reservation for a specific device, provided that you have access to the workspace. Your administrator can set up workspaces and assign you to one or more of them.
For a new reservation, click to open the Create Reservation window. Once you reserve a device, it will be locked for you at that time.
Here are some guidelines to remember:
- You can specify a start and end time for your reservation, an open-ended reservation with no end time, or a reservation until the end of the test.
- By default, reservations are active for 15 minutes and extendable for 5 minute intervals. Your administrator can modify these values or edit specific reservations.
- After you reserve a device, the Reservations page indicates that you reserved it, and shows the start and end times.
A triangular emblem at the bottom right of the device indicates its status. For details, see Device display - Reservations.
Check the filter panel to see what 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.
To see a device, you need to have access to the workspace to which the device belongs. Make sure that your administrator has allowed you access to the devices you need to test.
If a device remain locked after you ended the remote device session, click Refresh in the Devices tab.
If you use photo or video simulation after installing an app through the Control Panel's device interaction—if you click Install app again, the spinning icon will remain. Workaround: End the remote device session and reopen it.