Legacy | Application.Element.Set
-
Command: application.element
-
Subcommand: set
-
Supported Platforms: Native (legacy), UFT (legacy), Selenium, Appium
All commands must be executed using the same framework. Sharing the execution ID between different frameworks is not possible. This means that if you work with a Selenium/Appium driver, you need to call the commands using the Selenium/Appium driver (or, in the case of Reporting commands, through the Reporting SDK that works with the driver) and not as part of a UFT test or another framework.
-
Supported OS: Android, iOS
Sets the text of a application element. Use the Text parameter to specify the text to set.
Description
Uses an element identifier (XPath or attribute value) to search for the element in the display of the active window and then enters the supplied text to the element. Uses either the Perfecto or Appium object tree framework.
Parameters
Name | Value | Default | Description |
---|---|---|---|
deviceId* | The device for this command. | ||
text* |
String - The text to insert in the edit field. Secured String - The encoded text to insert in the edit field. The text can be in any language. |
||
value* |
The object identifier. By default, an Xpath is generated by the object spy. Use the By parameter to specify another identification method. |
||
by |
xpath (XPath) className (Class) linkText (Text) partialLinkText (Partial text) name (Name) id (Id) accessibilityId (Accessibility id) uiAutomator (UIAutomator Selector) uiAutomation (UIAutomation Selector) cacheId (Class Chain) predicate () classChain () |
XPath |
Specifies the identification method. |
timeout |
0 |
The time, in seconds, to wait for the element to appear on the screen or the web page. |
|
framework |
appium-1.3.4 (Appium) perfectoMobile (PerfectoMobile) |
PerfectoMobile |
The automation framework (by default PerfectoMobile). |
report |
screenshot (Screenshot) screenshot-on-error (Screenshot on error) none (None) |
Screenshot |
The value to display in the report. Screenshot - display screenshot Screenshot on error - display screenshots only for actions in error None - display nothing Consider reducing the resolution in very long scripts that result in large report files. |
report.resolution |
high (High) medium (Medium) low (Low) |
High |
The image resolution. Consider reducing the resolution in very long scripts that result in large report files. |
* Mandatory
Request & Response
Request
https://mycloud.perfectomobile.com/services/executions/john@perfectomobile.com_controller_16-12-07_08_30_54_151?operation=command&securityToken=<your_token>&command=application.element&subcommand=set¶m.deviceId=570E7512&¶m.by=id¶m.value=searchText¶m.text=Clinton
JSON response
{
"reason":"Success",
"timer.elapsed":"578",
"testGridReportUrl":"https://mycloud.reporting-stg.perfectomobile.com?externalId[0]=john@perfectomobile.com_controller_16-12-07_08_30_54_151",
"description":"Success",
"timer.system":"15",
"completed":"true",
"flowEndCode":"SUCCEEDED",
"executionId":"john@perfectomobile.com_controller_16-12-07_08_30_54_151",
"timer.ux":"563",
"singleTestReportUrl":"https://mycloud.perfectomobile.com/nexperience/singletest/report/?reportRepositoryKey=PRIVATE:controller/161207/controller_16-12-07_08_30_54_151.xml&ownerId=john@perfectomobile.com&sharingCode=a8d8ba68-ee11-4594-a83a-2eca62034d2c",
"reportKey":"PRIVATE:controller/161207/controller_16-12-07_08_30_54_151.xml",
"timer.device":"563"}