Legacy | Start test

  • Command: test

  • Subcommand: start

  • Supported Platforms: Native (legacy), UFT (legacy), Selenium

    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

Description

Adds specific test tags to represent the specific test context (what is being tested). For example, you can add “ValidateLogin” to represent a test that validates a user login. Other examples of tags that can be used here are test types such as regression, nightly, or smoke test.

Use the End test command to end the logical test and report the test status .

Parameters

Name

Value

Default

Description

name

  

Unnamed Test

The name of the test to be used in the Reporting dashboard.

tags

    

The test tags, separated by semicolons.

Tags are freestyle text used for filtering in the Reporting app.

For example, "AndroidNativeAppTests;ValidateLogin"

jobName

    

The job name, as it appears in Jenkins, any other CI automation tool, or any other configuration file.

jobNumber

    

The job number, as it appears in Jenkins, any other CI automation tool, or any other configuration file.

jobBranch

    

Provides identifier of the branch of the job.

projectName

    

The project or specific execution name.

projectVersion

    

The project or specific execution version.

customFields

    

Provides sets of [name, value] pairs that are associated with this test run. Format of the pair is: name=value.

* Mandatory parameter

Request & Response

Copy

Request

https://mycloud.perfectomobile.com/services/executions/johnt_controller_17-02-23_10_41_28_9?operation=command&securityToken=<your_token>&command=test&subcommand=start&param.name="TodayTest"&param.tags="sample"
Copy

JSON response

 "reportPdfUrl": "http://localhost:8082/export/api/v1/test-executions/pdf?externalId[0]=johnt_controller_17-02-23_10_41_28_9",
 "executionId": "johnt_controller_17-02-23_10_41_28_9",
 "reason": "Success",
 "returnValue": "N/A",
 "testGridReportUrl": "http://localhost:3000?TENANTID=10000001&externalId[0]=johnt_controller_17-02-23_10_41_28_9",
 "singleTestReportUrl": "http://localhost:8080/nexperience/singletest/report/?reportRepositoryKey=PRIVATE:controller/170223/controller_17-02-23_10_41_28_9.xml&ownerId=johnt@perfectomobile.com&sharingCode=c6f3b25c-2c46-4060-a32c-167b397b0506",
 "description": "Success",
 "reportKey":"PRIVATE:controller/170223/controller_17-02-23_10_41_28_9.xml",
 "completed": "true",
 "flowEndCode": "SUCCEEDED"