Skip to content
Hawzu Docs
API reference Go to app

Creating Executions and Test Runs

3 min read

Executions and Test Runs both start by defining a testing session and selecting test cases.

Use Release Executions when the work belongs to a release. Use Test Runs when the work should stand alone in a project.

Create A Release Execution

Section titled “Create A Release Execution”

To create an execution:

  1. Open a release.
  2. Go to the release executions area.
  3. Click Create Execution.
  4. Enter a required Title.
  5. Add an optional Description.
  6. Select test cases.
  7. Click Create.

The execution title may be prefilled with the release name as a prefix. You can keep the prefix or update the title before creating the execution.

Create ExecutionCreate Execution
Create an execution by selecting test cases from requirements, test suites, or manual selection

Release Execution Fields

Section titled “Release Execution Fields”

Title
Required. The Create button is unavailable until a title is present.

Description
Optional. Use this to describe the execution cycle, such as smoke, regression, revalidation, or final validation.

Selected Test Cases
Choose test cases manually, from requirements, from test suites, or by combining sources.

Release Status Rules

Section titled “Release Status Rules”

Release status controls whether execution creation is available.

| Release Status | Creation Behavior | |------|------| | Not Started | Executions are allowed with a warning. | | In Progress | Executions are allowed. | | Paused | Executions are blocked. | | Completed | Executions are blocked. | | Archived | Executions are blocked. |

If Create Execution is unavailable, the release status or user access may be preventing creation.

Create A Test Run

Section titled “Create A Test Run”

To create a test run:

  1. Open a project.
  2. Go to Test Runs.
  3. Click Create Test Run.
  4. Enter a required Title.
  5. Add an optional Description.
  6. Complete any required custom fields.
  7. Select test cases.
  8. Click Create.
Create Test RunCreate Test Run
Create a new test run by filling in the test run details form

Test Run Fields

Section titled “Test Run Fields”

Title
Required. The Create button is unavailable until a title is present.

Description
Optional. Use this to describe what is being validated, the scope, or any special testing notes.

Custom Fields
If the project has active custom fields for test runs, they appear during creation. Required custom fields must be completed before the test run can be created.

Selected Test Cases
Choose test cases manually, from requirements, from test suites, or by combining sources.

Select Test Cases

Section titled “Select Test Cases”

Executions and Test Runs can include test cases from three sources.

Manual selection
Use Add / Update Test Cases to choose individual test cases.

Requirements
Add requirements to include linked test cases. Already selected requirements are not shown again in the requirement picker.

Test Suites
Add test suites to include their test cases. Already selected test suites are not shown again in the test suite picker.

You can combine all three sources in one execution or test run.

Create Test Run With Test CasesCreate Test Run With Test Cases
Select test cases from manual choices, requirements, and test suites

Source Indicators And Deduplication

Section titled “Source Indicators And Deduplication”

If the same test case is selected from more than one source, Hawzu keeps one copy.

Source indicators show whether a test case came from:

  • Manual selection
  • A requirement
  • A test suite
  • Multiple sources

This helps users understand why a test case is included without creating duplicate execution work.

Removing Sources Before Creation

Section titled “Removing Sources Before Creation”

Before creating, users can remove:

  • Manually selected test cases
  • Selected requirements
  • Selected test suites

If a test case is still included by another source, it remains selected. If it was included only by the removed source, it is removed from the selected test case list.

Cancel And Create Behavior

Section titled “Cancel And Create Behavior”

Cancel closes the create window without creating the execution or test run.

For release executions, the Create button shows Creating… while the execution is being created.

If the create action is unavailable, check:

  • Required title
  • Required custom fields for test runs
  • Project access
  • Release status for release executions
Section titled “Related Guides”