Page tree
Skip to end of metadata
Go to start of metadata

Last updated: Feb 09, 2020 19:00

Starts a new execution, and returns the executionId and reportKey.

Request syntax

https://mycloud.perfectomobile.com/services/executions?operation=start&securityToken=value[&optionalParameters=value]

Note: All REST API commands require authentication, see the general authentication methods here.

Parameters

NameTypeDefaultDescription
securityToken*string
A unique cryptographic key assigned to an authorized user.
scriptName string
Defines a name for the script. This name is used for the report folder name and report key.
output.reportbooleantruetrue to generate a report containing the execution commands.
output.videobooleantrue

true to record a video of the device screen during the execution. This value applies to all devices used in the execution.

Applicable only when the output.report is not sepcified as false.

output.visibilitystringprivateThe repository section where the report will be stored. The section determines the access to the report. Possible values: private, group, public.
responseFormatstringjsonThe format to use for the response. Possible values: xml, json.

 * Mandatory

Response

NameDescription
executionIdThe unique identifier that you can use to execute Perfecto commands and to end the execution. The execution id is valid until sending the end execution request or the execution is expired, due to inactivity.
reportKey The identifier used to download the execution report from the repository. This is valid for the legacy formatted report. The key is only valid only after ending the execution. For example, PRIVATE:reportName.xml.

testGridReportUrl

The Perfecto report library URL.

singleTestReportUrl

The single test report URL.

reportPdfUrl

URL to download a PDF formatted version of the Execution Summary Report

Examples

Request with default json format response

This example shows the request and response for starting a new execution without specifying any optional parameters.

Request
https://mycloud.perfectomobile.com/services/executions?operation=start&securityToken=<your_token>
Response
{
	"reportPdfUrl":"https://reporting.aws-stg.perfectomobile.com/export/api/v1/test-executions/pdf?externalId[0]=johnp@perfectomobile.com_controller_17-02-16_13_13_52_6",
    "executionId":"johnp@perfectomobile.com_controller_17-02-16_13_13_52_6",
    "testGridReportUrl":"https://mycloud.reporting-stg.perfectomobile.com?externalId[0]=johnp@perfectomobile.com_controller_17-02-16_13_13_52_6",
    "singleTestReportUrl":"https://mycloud.perfectomobile.com/nexperience/singletest/report/?reportRepositoryKey=PRIVATE:controller/170216/controller_17-02-16_13_13_52_6.xml&ownerId=johnp@perfectomobile.com&sharingCode=d996b557-b108-48ed-99ca-476902694fa9",
    "reportKey":"PRIVATE:controller/170216/controller_17-02-16_13_13_52_6.xml"
}