Create a manual test run

The following flow demonstrates how to use the REST API to run a manual test.

Entity relationship diagram

We need to access the following entities for this flow, and understand the relationships between these entities.

Entity Relationships in this flow Description of relationship Reference / relationship fields
Tests Manual Tests, Gherkin Tests, and Test Suites This aggregate resource collection represents types of tests, including manual tests, Gherkin tests, automated tests, and test suites. subtype
Manual Tests Tests

The manual test is a subtype of the tests aggregate resource collection.

The manual test can also be accessed in the manual_tests resource collection.

There is no field that relates back to the aggregate resource collection, tests.

 
Steps

Manual test steps are stored in the ALM Octane internal repository. Steps are accessed as a script resource under the corresponding test in the tests resource collection.

tests\<test_ID>\script
Runs Manual Test Runs and Test Suite Runs This aggregate resource collection represents types of test runs, including manual runsand test suite runs. subtype
Manual Runs Runs

The manual test run is a subtype of the runs aggregate resource collection.

The manual test run can also be accessed in the manual_runs resource collection.

There is no field that relates back to the aggregate resource collection, runs.

 
Steps

Manual run steps are created when you execute the manual run.

If a manual run is only planned, the run steps are not created until the test is executed.

Note: This behavior is controlled by the CREATE_STEPS_DURING_RUN_CREATION configuration parameter. For more details, see Configuration parameters.

To generate the steps of a planned run without executing the run, you can run a PUT request to the runs custom resource:

PUT .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/runs/{run_id}/steps

 
Manual Tests

Manual test runs are associated with their respective tests.

test
Releases Manual Runs

Runs can be associated with releases.

release
List Nodes Manual Runs Run statuses are in the list_node resource collection. native_status

Back to top

Flow

Let's create the REST API call for creating a manual test run step-by-step.

See also: