Mobile App Agent
Purpose
The Mobile App Agent automates interactions with mobile applications during test execution. It enables validation of UI elements, user actions, scrolling behavior, text input, and mobile device features such as WiFi and Bluetooth.
Mobile App Agent Blocks
1. Find Element
Locates a mobile UI element.
Properties
Inputs
Parameter Name |
Description |
|---|---|
By |
Locator strategy (ID, XPath, Accessibility ID) |
Element |
Locator value of the element |
Find Element - input parameter.
Outputs
Output Code |
Description |
|---|---|
0 |
Element found |
1 |
Element not found |
2 |
Error |
Find Element - output parameter.
Output Possibilities Configuration
2. Click Element
Performs click action on a mobile element.
Properties
Inputs
Parameter Name |
Description |
|---|---|
By |
Locator strategy (ID, XPath, Accessibility ID) |
Element |
Locator value of the element |
Click Element - input parameter.
Outputs
Output Code |
Description |
|---|---|
0 |
Click successful |
1 |
Unable to click element |
2 |
Error |
Click Element - output parameter.
Output Possibilities Configuration
3. Wait For Element
Waits until a mobile element is visible.
Properties
Inputs
Parameter Name |
Description |
|---|---|
By |
Locator strategy |
Element |
Element to wait for |
Timeout |
Maximum wait time (seconds) |
Wait For Element - input parameter.
Outputs
Output Code |
Description |
|---|---|
0 |
Element appeared |
1 |
Element not found |
2 |
Timeout occurred |
Wait For Element - output parameter.
Output Possibilities Configuration
4. Scroll And Click
Scrolls the screen and clicks the target element.
Inputs
Parameter Name |
Description |
|---|---|
By |
Locator strategy |
Element |
Target element |
Scroll And Click - input parameter.
Outputs
Output Code |
Description |
|---|---|
0 |
Scroll and click successful |
1 |
Unable to perform scroll and click |
2 |
Error |
Scroll And Click - output parameter.
5. Scroll Into View
Scrolls the screen until the element is visible.
Inputs
Parameter Name |
Description |
|---|---|
By |
Locator strategy |
Element |
Element to scroll into view |
Scroll Into View - input parameter.
Outputs
Output Code |
Description |
|---|---|
0 |
Element scrolled into view |
1 |
Unable to scroll element |
2 |
Error |
Scroll Into View - output parameter.
6. Get Element ID
Retrieves the unique ID of a mobile element.
Inputs
Parameter Name |
Description |
|---|---|
By |
Locator strategy |
Element |
Target element |
Get Element ID - input parameter.
Outputs
Output Code |
Description |
|---|---|
0 |
Element ID retrieved |
1 |
Unable to retrieve element ID |
2 |
Error |
Get Element ID - output parameter.
7. Get Element Text
Retrieves text from a mobile element.
Inputs
Parameter Name |
Description |
|---|---|
By |
Locator strategy |
Element |
Target element |
Get Element Text - input parameter.
Outputs
Output Code |
Description |
|---|---|
0 |
Text retrieved |
1 |
Unable to retrieve text |
2 |
Error |
Get Element Text - output parameter.
8. Click List Element
Clicks an item from a list view.
Inputs
Parameter Name |
Description |
|---|---|
By |
Locator strategy |
List Element |
List view locator |
Index / Text |
Item index or visible text |
Click List Element - input parameter.
Outputs
Output Code |
Description |
|---|---|
0 |
List item clicked |
1 |
Unable to click list item |
2 |
Error |
Click List Element - output parameter.
9. Clear Text Field
Clears text from an input field.
Inputs
Parameter Name |
Description |
|---|---|
By |
Locator strategy |
Element |
Text field element |
Clear Text Field - input parameter.
Outputs
Output Code |
Description |
|---|---|
0 |
Text field cleared |
1 |
Unable to clear text |
2 |
Error |
Clear Text Field - output parameter.
10. Send Keys To Element
Enters text into a mobile element.
Inputs
Parameter Name |
Description |
|---|---|
By |
Locator strategy |
Element |
Target element |
Value |
Text to enter |
Send Keys To Element - input parameter.
Outputs
Output Code |
Description |
|---|---|
0 |
Text entered successfully |
1 |
Unable to enter text |
2 |
Error |
Send Keys To Element - output parameter.
Inputs
Parameter Name |
Description |
|---|---|
By |
Locator strategy |
Element |
Radio button element |
Select Radio Button - input parameter.
Outputs
Output Code |
Description |
|---|---|
0 |
Radio button selected |
1 |
Unable to select radio button |
2 |
Error |
Select Radio Button - output parameter.
12. Click and Set Value
Clicks an element and sets a value.
Inputs
Parameter Name |
Description |
|---|---|
By |
Locator strategy |
Element |
Target element |
Value |
Value to set |
Click and Set Value - input parameter.
Outputs
Output Code |
Description |
|---|---|
0 |
Value set successfully |
1 |
Unable to set value |
2 |
Error |
Click and Set Value - output parameter.
13. Fetch Element Attribute
Retrieves an attribute value from an element.
Inputs
Parameter Name |
Description |
|---|---|
By |
Locator strategy |
Element |
Target element |
Attribute |
Attribute name |
Fetch Element Attribute - input parameter.
Outputs
Output Code |
Description |
|---|---|
0 |
Attribute retrieved |
1 |
Unable to retrieve attribute |
2 |
Error |
Fetch Element Attribute - output parameter.
14. Get Available WIFI List
Retrieves available WiFi networks.
Outputs
Output Code |
Description |
|---|---|
0 |
WiFi list retrieved |
1 |
Unable to retrieve WiFi list |
2 |
Error |
Get Available WIFI List - output parameter.
15. Get List View Items
Retrieves items from a list view.
Inputs
Parameter Name |
Description |
|---|---|
By |
Locator strategy |
List Element |
List view locator |
Get List View Items - input parameter.
Outputs
Output Code |
Description |
|---|---|
0 |
List items retrieved |
1 |
Unable to retrieve list items |
2 |
Error |
Get List View Items - output parameter.
16. Toggle Bluetooth
Enables or disables Bluetooth.
Inputs
Parameter Name |
Description |
|---|---|
State |
ON / OFF |
Toggle Bluetooth - input parameter.
Outputs
Output Code |
Description |
|---|---|
0 |
Bluetooth state updated |
1 |
Unable to update Bluetooth |
2 |
Error |
Toggle Bluetooth - output parameter.
17. Toggle WIFI
Enables or disables WiFi.
Inputs
Parameter Name |
Description |
|---|---|
State |
ON / OFF |
Toggle WIFI - input parameter.
Outputs
Output Code |
Description |
|---|---|
0 |
WiFi state updated |
1 |
Unable to update WiFi |
2 |
Error |
Toggle WIFI - output parameter.