Get Results

Applies to TestEngine 1.31, last modified on June 07, 2024

To view a test job result, you can either view a short summary report or download a detailed test job result.

View a summary report

You can click a finished test job to view the summary report. It shows what test suites and test cases were run, what environment was used, and the status of the assertions:

TestEngine Web Reports

Click the image to enlarge it.

Get test job results

To download detailed 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 Run History page of TestEngine:

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

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

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

Run History page

Click the image to enlarge it.

Tip: You can filter test jobs by a name, status, used tags, and the user who has sent the job. Besides that, you can search for a specific test job by a string included in its project, author, status, type, or tag.

The table contains brief information on test jobs:

Column Description
Project The name of the project to run.
Status Current state of a test job.
Possible statuses: Canceled, Failed, Finished.
Tip: Test jobs with the Running and In Queue statuses are listed on the Overview page.
Success Ratio Shows the number of tests that have passed/failed for the given execution.
Author The name of the user, who sent the test job to TestEngine.
Administrators can examine test jobs created by other users.
Test Type

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

Currently, TestEngine does not support load tests.
Tags

Shows which tags were used to run the test job.

Start Time A timestamp when the test job was sent to TestEngine.
Queue Time How much time the test was in the queue.
Run Time The time of the test run.
Total Time The total time of the test run, including the time in the queue.
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.
Remove the test job

Remove the test job from the test history.

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