Device control panel
The UFT Mobile Device Control Panel allows you to interact with a device and perform simulation of common events.
Accessing the device control panel
The Control Panel is available from:
- The UFT Mobile lab, as exploratory interaction with the device. To access it, open the device remotely by clicking or while hovering over a device in Card view, or by clicking Open or Open & Record in List view. Click the List and Card view buttons in the upper right corner to toggle between the views.
- Testing tools that integrate with UFT Mobile such as UFT, Sprinter, and TruClient. To access it, begin your record or replay session.
Secure connection only (HTTPS): When using the default self-signed certificate, the browser displays a warning or error when you first try to access a device through a connector with a secure connection. For web browsers to trust the certificate, the SSL certificate must be issued by a recognized Certificate Authority (CA). The connector's self-signed certificate still works to encrypt data, the warning is letting you know that the SSL certificate was self-signed and is not signed by a CA. To view the device, you need navigate to the URL of the connector and trust the self-signed SSL certificate.
Note: Depending on the tool that you are using and the testing state (idle, capturing, or running), certain options may not be available.
This section lets you interact with the device during the capture or replay session, or when idle.
|Change orientation. Toggles the orientation of the device (also available when idle, when you are not capturing or replaying a test).|
|Take screenshot. Saves a screenshot of the current screen as a <step_number>.png file to your default download folder. (Not supported when accessing the UFT Mobile Lab console through a Safari browser.)
|Download device logs.
Downloads the device logs as a text file to your default download folder (not supported when accessing the UFT Mobile Lab console through a Safari browser). For iOS devices, the time zone on the device must match the time zone on the connector machine.
Lab Apps are displayed with their version and build numbers. To select a different upload version, hover on the app and click More info . If the app you want to install is not shown, you can upload it by clicking Upload in the UFTM Apps tab. You can also uninstall a lab app installed on a device, by selecting the app and clicking Uninstall.
This option is currently available from the UFT Mobile Lab console, and from UFT Developer only.
Send text to device. Opens the Send text to device window. Enter the text you want to copy to an active input field on the device, and click Send.
|Capture device audio. Allows you to capture the audio output of a device. This button is only visible if your device is correctly configured for capturing audio output. For details, see Capturing audio.|
The Simulations section lets you perform common event simulations. Some simulations are not available when conducting exploratory testing from the Lab console, and are only available when accessing the Control Panel using testing tools.
|Simulate incoming call. The dialog box that opens lets you indicate the number calling, and how to handle the call.|
|Simulate incoming SMS. The dialog box that opens lets you indicate the number sending the message and the message text.|
|Simulate sending app to background. The dialog box that opens lets you indicate the duration for which the app should be sent to the background.|
Simulate GPS relocation. The dialog box that opens lets you specify the latitude and longitude for the simulation. Note that for iOS, GPS simulation is only supported for packaged apps.
For Android 6.0 and higher, you need to set the mock location app as follows: Developer options > Select mock location app and select UFTM Agent.
|Simulate photo. Supported only for packaged apps. Allows you to replace the photo taken by the device's camera. The dialog box that opens lets you specify a image files. For details, see Photo and video simulation.|
|Simulate video. Supported only for packaged apps. Allows you to replace the video taken by the device's camera. The dialog box that opens lets you specify a video file. For details, see Photo and video simulation.|
QR code or barcode scan Allows you to replace a scan of a QR code or barcode with an image. For details, see QR code and barcode simulation.
|Simulate authentication. Supported for package apps only. Allows you to simulate Fingerprint or Face ID authentication on mobile devices. Authentication Simulation is active by default on packaged apps that require fingerprint or face ID authentication. Navigate to the screen in the app that uses authentication. When prompted, select an authentication result. For details, see Fingerprint and Face ID simulation.|
|Network Virtualization. Simulate network conditions to test how various mobile networks affect your application's performance on different mobile devices. For details, see Perform exploratory testing with Network Virtualization. (Disabled for Genymotion or AWS devices)|
Device metrics are only available when accessing the Control Panel using a testing tool, not when interacting with a device from the lab console.
This section lets you view the device metrics collected during the test. You can only select which metrics to collect via your testing tool's options. For details, see UFT Mobile wizard.
In this section, you adjust the resolution of the images in the displayed device. You can scale down the image to the desired size.
Scaling down an image lowers its quality, but improves the performance of your tests and other interactions with the device.
Your scaling preference is preserved per browser and machine.
If Network Virtualization (NV) has been enabled, you can run an exploratory test using network virtualization. See Perform exploratory testing with NV, or click the Network Virtualization button to open the How to wizard.
The General information section is located at the bottom of the Control Panel.
The current zoom level. Use the plus and minus signs to zoom in and out.
The latency between the client and the connector to which the device is connected. The latency level is indicated as follows:
|Green||Good||Less than 100 ms|
|Yellow||Mediocre||From 100 - 200 ms|
|Red||Poor||From 200 - 300 ms|
Exceeding 300 ms
The device properties such as the device type, name, and ID.
To learn more about the device and its reservations, or to perform an action on the device (such as Restart or Reconnect) click the More information button to open the Device window.
If you opened the remote view in recording mode, using the Open and Record button , UFT Mobile opens the recording toolbar.
The toolbar lets you perform the following actions:
- Pause and resume the recording
- Stop the recording
- View the steps. Open the dropdown to see up to 30 steps, or clear the list using the CLEAR ALL option.
- Download a zip file of the steps. The zip file includes screenshots and the following text files: device_details, recorded_steps, and device_logs.
Tip: To clear all of the recorded steps and begin a new recording, select CLEAR ALL from the steps dropdown, or click the Stop button on the toolbar, and restart the recording.
- Recording steps is not supported for AWS Device Farm devices.
- A screenshot of the last action is not recorded and not saved to the report log.
- When recording on iOS devices, hybrid/web is supported only for iOS version 11 and higher.