Back to QMetry All Products Help Page
Creating New Test Cases
You can create test cases manually, import them from BDD feature files, or leverage AI to auto-generate them. This flexibility helps teams build and manage test cases based on their preferred workflow.
Creating New Test Cases Manually
The Create New Test Case screen provides a unified interface that streamlines the process of test case creation. It allows you to create test cases and manage requirement linking, test suite association, execution planning, and defect linking, all in one place.
To create a new test case manually, perform the following steps:
Go to the Test Cases module.
Click New.
Enter Test Case Details: Fill all required fields with the necessary information.
Link Requirements (Optional): You can link requirements to the test case by:
Selecting requirements from the list,
Entering the Requirement Entity Key manually.
After entering all relevant test case details, you can:
Click Create to save the test case.
Click Plan Executions to link the test case to a Test Suite and plan its execution.
If Plan Executions is selected:
Choose to either
Create a New Test Suite
Link an Existing Test Suite.
After selecting or creating the Test Suite, you will have two options:
Link Test Suite and Close
Links the test case to the selected Test Suite and closes the screen. Execution can be performed later.Execute
Opens the execution screen, where you can immediately run the newly created test case within the linked Test Suite.
The system saves the test case and redirects you to the Test Case list view, with the new test case added at the end.
Test Case Details
System Fields
The System Fields section contains standard fields for test case definition:
Field Name | Description |
|---|---|
Summary | Name of the Test Case |
Priority | Assign a priority level: Minor, Major, Blocker, Critical, or Trivial. |
Labels | Choose one or more labels to classify the test case. |
Status | Select from: New, Approved, In Progress, Ready to Review. |
Owner | Assign an owner from users with access to the project. |
Test Case Category | Categorize as Regression, Performance, Security, Functional, etc. |
Estimated Time | Specify the estimated execution time in HH:MM:SS format. Maximum: 99,999 minutes (1,666 hours). |
Description | Add a detailed description in plain or rich text. |
Folder Path | Auto-populated based on the creation location. Can be manually updated. |
User-Defined Fields (UDFs)
Custom fields added to the Test Case module appear under User Defined Fields.
UDFs can include look-up lists, multi-lookup lists, and cascading values.
Mandatory cascading fields require selecting both parent and child values.
UDFs can be configured under Manage Fields in Customization.
Test Steps
Test steps define the actions and expected outcomes for test execution.
Adding and Editing Steps
Go to the Test Steps section.
Click the expand icon for full-screen view.
To add a step:
Click the Edit (pencil) icon or press TAB to navigate.
Click the cog icon and select Insert Row for a new step.
Enter the Step Description, Input Data, Expected Outcome, and UDF details(if any).
Repeat to add additional steps.
Shareable or Copied Steps
Insert Shareable Test Case: Click the cog icon, select a shareable test case and link it.
Copy Steps from Existing Test Case: Click the cog icon, select steps and click Copy or Copy & Close.
The “+” icon can also insert shareable or copied steps.
User-Defined Test Step Fields
Additional UDF columns appear beside default fields if added in Customizations.
Column arrangement changes are reflected across all relevant screens (Execution, Detail, Version, Exploratory Testing).
Editing Steps
Hover over a step field and click the edit icon to enable inline editing.
Press TAB or click outside to save changes.
Risk Analysis
This section is visible only if you have enabled Risk Analysis feature from General Settings under Project Management.
Enter: Risk Type, Risk Category, Likelihood, Impact.
The system calculates Risk Priority Number and Extent of Testing, helping prioritize test cases.
Linking Requirements
Notes
Permissions Required: Link Test Case and Link Requirement.
To link requirements, perform the following steps:
Click Link.
You can link requirements by Entity Key or by selecting them directly from the Linking screen.
You can create a new requirement from the Linking screen and link it to the test case.
Notes
You can link up to 500 requirements to a test case using the Link Requirements section.
Planning Test Executions
Plan Executions helps streamline test execution. You can either add a new test case to an existing test suite or create a new test suite and schedule its execution.
Create Test Suite
You need Create Suite, Link Test Case, Link Test Suite permissions to create a new test suite.
On clicking Create Test Suite, the creation screen opens. The entity key of the newly created test case is displayed at the top. You can click this entity key to navigate directly to the test case.
All test cases linked to the Test Suite are listed in the Test Cases section.
To create a test suite, perform the following steps:
Enter Test Suite details and fields.
Associate a folder path.
Link one or more Releases, Cycles, and Platforms. This is mandatory.
By default, Release and Cycle are auto-filled from Test Case. Owner defaults to the logged-in user.
You can select multiple values in the Release, Cycle, and Platform fields to associate with a Test Suite. The Release and Cycle values are inherited from the Test Case.
Link Existing Test Suite
Link Existing Test Suite opens the list of available Test Suites in the current project.
The system excludes the following Test Suites from the list:
Test Suites without an associated Release/Cycle or Platform.
Test Suites in which all associated Releases/Cycles or all Platforms are archived.
Archived Test Suites.
Note
You need Modify Suite, Link Test Cases and Link Test Suite permissions.
A test case can be associated with only one Test Suite.
After selecting the Test Suite to link, choose one of the following actions:
Link and Close
Links the test case to the selected Test Suite and closes the screen. No execution runs are created.Proceed with Execution
Links the test case to the selected Test Suite and initiates execution runs. You will be redirected to the Execution Flow screen to begin execution.Cancel
The test case is saved but not linked to any Test Suite, and no executions are created.
Proceed with Executions
Proceed with Execution directs you to the test execution flow. This screen displays the following details:
Test Suite Key
Summary
List of all test case execution runs.
You can edit the following details for each execution:
Field | Description |
|---|---|
Build Name | Mandatory The mandatory build settings (project level) are applied when executing the test cases. |
Attended Time (timer) | Attended Time can only be edited manually. It does not auto-start with execution.
|
Planned Date | Select the date to set planned date. Optional |
Comment | Optional |
Execution Attachment | Optional files |
Link or Add Bug | Link or create bugs |
Execution Type | Defaults to Manual |
Tester or Execution Assignee | Defaults to logged-in user |
Setup Time | Hidden by default |
Execution Status | Editable |
The following project-level timer restriction does not apply on this screen:
“Enforce time tracking of 'Actual Attended Time' through the timer on the execution screen, preventing manual entry or modification of the recorded time.”
You can add or link existing bugs directly from the test case execution screen .
Test Case execution view.
Step execution view.
Create Test Case from Jira or Azure Work Item Synced as Requirements in QMetry
Permissions Required:
Create Test Case
Link Requirement
Link Test Case
If you do not have the necessary linking permissions, you will be able to create the test case, but linking will be restricted.
You can create a test case directly from a Jira or Azure Work Item that is synced with your QMetry project.
Steps to Create a Test Case:
Go to the Test Case section within the synced Jira or Azure Work Item.
Click +Test.
You are not logged in: You will be prompted to log in before proceeding.
You are logged in and have Project access: You will be redirected to the Create Test Case screen.
The following fields are auto-filled:
Project: Same as the project of the source Work Item.
Requirement Linking: The Requirement linked to the Work Item is auto linked to the Test Case.
Summary, Release and Cycle: Defaulted from the Work Item's summary.
The rest of the workflow is same as Creating Test Case from Requirement.
After a Test Case is created, the system navigates to the Test Case Details screen, where the new test case is automatically linked to its originating work item.
Create Test Suite from Jira or Azure Work Item Synced as Requirements in QMetry
Required permissions:
Create Test Suite
Link Test Cases
Link Test Suite
If the user lacks necessary linking permissions, the Test Suite gets created, but test cases are not linked.
For projects where the user has Link Test Case permission, only the test cases from those projects will be linked to the Test Suite.
You can also create a test suite directly from a Jira or Azure Work Item that is synced with your QMetry project.
Click the + Suite button.
This opens the Create Test Suite Screen in QMetry if you are already logged in and have necessary project access rights.
Similarly, the created test suite gets linked to all test cases associated with the originating requirement work item.
The following fields are auto-filled:
Project: Same as the project of the source Work Item.
Requirement Linking: The Requirement linked to the Work Item is auto linked to the Test Case.
Summary, Release and Cycle: Defaulted from the Work Item's summary.
All non-archived test cases linked to the requirement are auto-linked to the test suite.
Creating a Test Case from JIRA or Azure Work Item Synced with QMetry Issue Module
Required permissions:
Create Test Case
Link Issue
Link Test Case
If the user lacks necessary linking permissions, the test case gets created, but test cases are not linked.
For projects where the user has Link Issue permission, only those test cases are linked to the Test Case.
In the Test Case Section, click Create Test Case.
The following fields are auto-filled:
Project: Same as the project of the source Work Item.
Issue Linking: The Issue Work Item is auto linked to the Test Case.
Summary, Release and Cycle: Defaulted from the Work Item's summary
Enter all other relevant details.
Click Create to save the Test Case or Proceed with Execution to link a test suite and execute the test case.
The Issue gets auto-linked to the created test case.
Back to QMetry All Products Help Page