test-suite
2022.4
false
UiPath logo, featuring letters U and I in white

Test Suite User Guide

Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
Last updated Aug 13, 2024

Device Interaction

Device Interaction Conditions

When an action is executed, device interaction is locked until its completion.

Starting an Application

To interact with your device you must first start an application. You have three options to choose from in MDM, as listed in the following table.

Method

Procedure

Start an application from a device

  1. Go to the Devices tab and select a device.
  2. Click Start an application on this device.
  3. Choose an application from the dropdown and click Connect.

Start an application from a configured app

  1. Go to the Applications tab and select an application.
  2. Click Start application.
  3. Choose a device from the dropdown and click Connect.

Start an application using Quick Actions within the Welcome tab

  1. Go to the Welcome tab and select Start an application.
  2. Choose a device and an application from the dropdown.
  3. Click Connect.

    For more information about Quick Actions, refer to Quick Actions.

Interacting With The Device

You can interact with your device in MDM as you would with an actual physical device, using your mouse or the action bar. The screen and the actions are locked when you perform an action.



On-Screen Interaction

The following table lists the on-screen actions that you can take to interact with your device.

Action

Description

Procedure

Tap

Access an on-screen element.

Click an element on the device screen.

Double Tap

Perform double tap action on-screen.

Double-click an element on the device screen.

Long Tap

Long press.

Click and hold on an element.

Pinch (Zoom In/Out)

Zoom in and out. This action is not recorded.

Right-click and hold, and then drag to the bottom of the screen to zoom in, or towards the upper part to zoom out.

Swipe

Swipe on-screen.

Click and drag towards any part of the screen.

Keyboard Input

Type in your text and send it to the mobile. For example, you can use the search bar to quickly access a website.

  1. Double-click on a text area to open the input window.
  2. Type in your text.
  3. Select Press Enter key after sending text to type in and enter your input directly.
  4. Click Send Text.

Action Bar

The following table lists the actions that you can take to interact with your device. The action bar is right next to the device.

Action

Description

Procedure

iOS Home

Return to the home screen.

Click the iOS Home button.

Android Back

Get back to the previous screen/page.

Click the Android Back button.

Android Home

Return to the home screen.

Click the Android Home button.

Android Switch Apps

Switch between apps.

Click the Android Switch Apps button, and choose your next action.

Change orientation to landscape/portrait

Toggle between portrait (vertical) and landscape (horizontal) mode for your device. Screen orientation is not supported by all applications.

Click the Change Orientation toggle to switch between modes.

Refresh

Refresh the device connection.

Click the Refresh button.

Alternatively, click the Reconnect button when the connection has been lost.

Save Screenshot

Save the current screen.

Click Save Screenshot and choose a location to save the file.

Send Text

Type in your text and send it to the mobile. For example, you can use the search bar to quickly access a website.

  1. Select a focusable element and then click Send Text.
  2. Type in your text.
  3. Select Press Enter key after sending to type in and enter your input directly.
  4. Click Send Text to confirm.

Selection by identified elements/absolute position

Toggle between element coordinates used for selection.

Click the Selection by identified elements/absolute position toggle to choose the default element selection coordinates.

Install App

Install an application on your device.

  1. Click the horizontal ellipsis to open Advanced Settings.
  2. Click the Install App button and enter your app full location.
  3. Click Install to confirm.

Manage App

Manage the current application.

  1. Click the horizontal ellipsis to open Advanced Settings.
  2. Click the Manage App and select one of the following actions from the dropdown:
    1. Launch: Launch the default app page.
    2. Reset: Restart the app.
  3. Click Execute to confirm.

Manage Other App

Manage other applications on your device. You can use this when you test integrations between apps.

  1. Click the horizontal ellipsis to open Advanced Settings.
  2. Click the Manage Other Apps and enter your app's name.
  3. Choose on of the following commands from the dropdown:
    1. Remove: Uninstall the app.
    2. Activate: Open the app.
    3. Terminate: Close the app.
  4. Click Execute to confirm.

Open URL

Open URL in browser.

  1. Open a browser on your device.
  2. Click the horizontal ellipsis to open Advanced Settings.
  3. Click the Open URL and enter a full URL. For example: https://www.google.com/.
  4. Click Open to confirm.

Open Deep Link

Launch an app that opens a specific page.

  1. Click the horizontal ellipsis to open Advanced Settings.
  2. Click the Open Deep Link and configure the following:
    1. App: App path
    2. Deep Link: Specify the page that you want to open.
  3. Click Open to confirm.

Save Source

Save the XML source file of the device.

  1. Click the horizontal ellipsis to open Advanced Settings.
  2. Click the Save Source and select a location to save the file.

Set Geo Location

Set geographic coordinates.

  1. Click the horizontal ellipsis to open Advanced Settings.
  2. Click the Set Geo Location and use the Latitude, Longitude, Altitude finder on map to get coordinates. Alternatively, you can search for your location.
  3. Click Set to confirm.

Recorded Actions

You can interact with your device through the action bar or by indicating your actions on-screen to record the steps. For example, you can record and manage your actions to prepare mobile automation workflows in MDM. For more information, see Create Workflow Using Recorded Actions.



The following table lists the actions that you can take using Recorded Actions.

Action

Description

Procedure

Execute

Execute the action.

Click the Play button on an action to execute it.

Copy

Copy the action to your clipboard. You can use the Import Recorded Actions in Studio to paste it to your workflow.

Click the Copy button to copy the action to your clipboard.

Delete

Delete the action.

Click Delete to remove the action from the list. Alternatively, you can click Clear All to remove all actions.

Reorder

Reorder the list of actions in alternate order.

Drag and drop an action to different position within the list.

Wait for page update

Wait for the page source to retrieve a screenshot of each action.

Toggle the Wait for new screenshot after each action.

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.