Applies to ReadyAPI 3.4, last modified on October 14, 2020

Get test job results

To view results of a test job run, you can either use the web interface of TestEngine or send a request to the TestEngine API using curl, ReadyAPI, or any other similar tool.

Get an overview of test jobs in TestEngine

Use the following operation:

GET  http://<testengine-host>:8080/api/v1/testjobs

Authentication

The request must be authenticated by a TestEngine user.

Note: If you authenticate as a non-admin user, you will be able to view only those reports on test jobs that you have started. If you authenticate as an administrator, you will be able to view all the test jobs in TestEngine.

See details on SwaggerHub.

Example

Get a full report on a test job

Use the following operation:

GET  http://<testengine-host>:8080/api/v1/testjobs/{testjobId}/report

Authentication

The request must be authenticated by a TestEngine user.

Note: Results that you see depend on the authentication. If you authenticate as a user, you will see only the test jobs started by that user; if you authenticate as an administrator, you will see all the test jobs in TestEngine.

Headers

Header Description
Accept

Specifies the format of the report. Possible values:

  • application/json (for a JSON report)
  • application/junit+xml (for a report of the JUnit XML format)
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet (for an Excel report)
  • application/pdf (for a PDF report)

If the header is not set explicitly, a JSON report will be returned.

See details on SwaggerHub.

Example

To see test job results, go to the home page of TestEngine:

http://<testengine-host>:<port>/

For example, if TestEngine is installed on your local machine and you run it on the default port, use the following link:

The Overview page of the TestEngine web interface contains a list of existing test jobs:

Overivew page

Click the image to enlarge it.

Tip: You can filter test jobs by a name, status, and the user who has sent the job.

The table contains brief information on test jobs:

Column Description
Status Current state of a test job.
Possible statuses: QUEUED, RUNNING, CANCELED, FAILED, FINISHED.
Project The name of the project to run.
Test Type

Shows whether the test job is a functional test or security test.

Currently, TestEngine does not support load tests.
User The name of the user, who sent the test job to TestEngine.
Administrators can examine test jobs created by other users.
Submitted A timestamp when the test job was sent to TestEngine.
Run Time The time of the test run.
Queue Time How much time the test was in the queue.
Total Time The total time of the test run, including the time in the queue.
Cancel test job Cancel the test job.
Test job ID Get the test job ID.
Download job report Download the test job report in the JSON, JUnit XML, Excel or PDF format.

Get transaction report

A transaction report is a JSON file that contains full information on HTTP transactions that took place during a test job run. Transactions are logged only for request test steps, such as SOAP Request, REST Request, and so on.

Get a report on all the transactions within a test job

Use the following operation:

GET  http://<testengine-host>:8080/api/v1/testjobs/{testjobId}/transactions

Authentication

The request must be authenticated by a TestEngine user.

Note: Results that you see depend on the authentication. A user can see only the transactions of test jobs that they have started; an administrator can see transactions of all the jobs in TestEngine.

See details on SwaggerHub.

Example

Get a transaction report for a particular transaction

Use the following operation:

GET  http://<testengine-host>:8080/api/v1/testjobs/{testjobId}/transactions/{transactionId}

Authentication

The request must be authenticated by a TestEngine user.

Note: Results that you see depend on the authentication. A user can see only the transactions of test jobs that they have started; an administrator can see transactions of all the jobs in TestEngine.

See details on SwaggerHub.

Example

See Also

Run Tests
Get Status

Highlight search results