#Creating & Managing Test Runs - Step Guide

#Creating Test Runs

#To create a new test run:

1. Click the Create Test Run button in the header
2. Fill in the test run details:

Title: A concise name for the test run (required)

Description: A brief summary of what is being tested

Custom Fields: If your project has custom fields configured for test runs, they will appear here. Fill them in as needed.

Test Case Selection: Add test cases using one or more methods:

#Manual Selection

1. Click Add / Update Test Cases
2. Browse or search for test cases
3. Select test cases to add
4. Click Add to include them in the test run

Manually selected test cases are always included in the test run.

#From Requirements

1. Click Add Requirement
2. Select a requirement from the requirement selector
3. Select test cases linked to that requirement
4. Click Add to include them

Test cases from requirements are included based on requirement links.

#From Test Suites

1. Click Add Test Suite
2. Select a test suite from the test suite selector
3. Test cases from the suite are automatically included

Test cases from test suites are included based on suite membership.

Note: You can combine all three methods. Test cases are aggregated, and duplicates are handled automatically.

3. Click Create to create the test run

#Test Case Sources

Test cases in a test run can come from:

• Manual Selection: Explicitly selected test cases
• Requirements: Test cases linked to selected requirements
• Test Suites: Test cases included in selected test suites

Each test case shows badges indicating its source:

• Manual: Manually selected
• Requirement: From a requirement
• Test Suite: From a test suite

#Editing Test Runs

#To edit a test run:

1. Click the Actions menu (three dots) on a test run row
2. Select View Details
3. In the test run details view, click Edit
4. Modify the fields:
   • Title
   • Description
   • Custom Fields
   • Test Cases (add or remove)
5. Click Save to update the test run

Note: Editing a test run does not affect test case execution results that have already been recorded.

#Deleting Test Runs

#To delete a test run:

1. Click the Actions menu (three dots) on a test run row
2. Select Delete
3. Confirm the deletion in the confirmation modal

Warning: Deleting a test run will:

• Remove the test run permanently
• Delete all test case execution results
• This action cannot be undone

Note: Only delete test runs when you’re certain you want to remove all associated data.

#Permissions

Test Runs are subject to project-level permissions:

• View Test Runs: View test runs list and details
• Create Test Runs: Create new test runs
• Edit Test Runs: Modify existing test runs
• Delete Test Runs: Remove test runs
• Execute Test Cases: Execute test cases and record results
• Assign Test Cases: Assign test cases to users

Permissions are managed at the project level through roles. Contact your project administrator if you need additional permissions.