Introduction

The Test Cases module is the central repository of test cases. This module enables you to create, organize, reuse, and manage test cases.

In QMetry, you can reuse a single test case multiple times. You can link a test case to multiple requirements and test suites, as well as associate it with multiple releases and cycles. The execution status of test cases is independent per cycle, which means you can repeatedly execute the same test case for different cycles without affecting the test results between separate runs.

Key Features of the Test Cases Module

• Organize Test Cases into folders and sub-folders.

• Add and Edit Test Cases.

• Import Test Cases from Excel and JIRA.

• Execute Test Cases for ad-hoc testing.

• View the Status of individual Test Cases.

• Link relevant Requirements and Issues to Test Cases.

• Set Predecessor and Successor relationships between Test Cases.

Test Case Module

The test case module grid view offers various customization options.

Manage Grid Columns

The Arrange Columns option in the Test Case Module grid enables you to customize the asset view. Refer to the Manage Grid Columns page to know more.

Filtering Assets

Filter test cases using system or custom fields across all modules. To learn more about filters, refer Filtering Assets document.

To view test cases not associated with any folder, use the Show Test Cases Not Assigned to Any Folder filter. This displays test cases that exist only under the Project Root.

You can move, reuse, archive, or delete such test cases, either individually or in bulk.

Folder Management

Organize your requirements in a hierarchical structure using folders. To learn more about available actions, refer to Basic Folder Operations document.

Bulk Operations

Perform bulk copy or move actions at the folder level within or across projects. To learn more, refer to the Bulk Copy/Move document.

Test Case Module List View Columns

By default, the system displays the Entity Key, Summary, and Version columns. You can include additional columns such as Priority, Latest Execution Status, Testing Type, Dates, and counts for linked Requirements, Test Cases, Test Suites, and more.

Open

Latest Execution Status

You can view the Latest Execution Status column in the Test Case List View. This column indicates the current execution status based on settings configured under Customization on the Execution Status tab. Refer to Execution Status Management to know more.

Open

Click the status to view further details of the test execution.

Testing Type

The Testing Type field indicates whether the user generated the test case manually or automated it.

QMetry classifies test cases as Manual when the user creates them through the UI or imports them from Excel, and as Automated when the user creates them using Automation APIs. This field is read-only and cannot be modified.

Test Case Detail

The test case detail page displays

A. Individual Section Tabs (Editable)

B. Combined View (Read-Only View)

Open

Managing Test Cases

You can create, edit, copy, move, archive, and delete test cases. Admins can grant permissions from Roles in the Customization screen.

Let’s have a detailed look at these features.

Creating New Test Case 

You can create new test cases manually. Learn more about Creating New Test Case.

Importing Test Cases

You can import test cases from Excel and Jira. Learn more about Importing Test Cases from Excel.

Editing Test Case Details

You can edit the values of both system-defined and user-defined fields from the ​Details​​ tab.

Open

To update the test case in bulk, perform the following steps:

1. Go to the test case details screen.

2. Access the Details tab.

3. Hover over the values you wish to edit.

4. Enter the new values and click the checkmark to save your changes.

Inline Editing

​You can edit the test case steps, step description, input data, expected outcome, and other user-defined fields directly by hovering over and clicking on specific cells.

Open

To edit the steps with in-line editing, perform the following steps:

1. Go to the cell to update.

2. Hover over the desired cell to display it in editable mode.

3. Click on the cell and make the necessary modifications directly in the field.

Editing or Updating Test Steps

You can edit the steps within a test case. This includes, editing existing steps, adding new steps, adding attachments to test steps, inserting shareable test case or copying steps from existing test cases.

To edit test steps, perform the following steps:

1. Click the ​Test Case Entity Key​​.

2. Go to the ​Test Steps​ tab and click ​Edit​​.

3. You get two options: In-line editing and test-step editing.

In-Line Editing

Hover over the cells to edit.

Open

Test Step Editing

You can also update the details of a test step by clicking the edit icon next to that step.

Open

Click the ​Edit​​ icon for a particular test step.

This allows you to edit the step description, input data, expected outcome and custom fields.

In the expanded view, the Large Text UDFs have seperate tabs while all other UDFs are combined in a single tab named ​Other​​. You can edit the fields within the ​Other​​ tab using in-line edit.

Actions on Test Step Cog Icon

Open

You can perform the following actions on the Steps grid:

Changing the Order of Test Case Steps

While executing the test suite, the test case steps appear in the same sequence as arranged in the test case.

To reorder test case steps, perform the following steps:

1. On the Steps tab, click the cog icon to the right of the step.

2. Select Move and choose the new index for the step.

Adding Attachments to Test Steps

You can add attachments to test case steps either by clicking the attachment button for a test step or by embedding attached images/files in rich text fields.

Read Managing Attachments to know more

Deleting or Removing Test Case Steps

You can delete unwanted test case steps by clicking the remove icon.

Deleting or Removing Test Steps in Bulk

To delete test steps in bulk, perform the following steps:

1. Select the test steps that you want to delete. The Delete button gets enabled on the selection of test step(s).

2. Click on the Delete button.

3. Click Update.

Copying Test Cases

Copying a test case creates a duplicate, allowing you to reuse the test case across different folders and projects. When copying or moving test cases, you must select a destination folder.

If you don't select a folder, the system automatically places the copied test cases in the Root folder by default.

Open

Moving Test Cases

You can move test cases within the current project, either individually or in bulk.

• From a Specific Folder
  When a test case is moved from a specific folder, it is removed from the source folder and added to the selected destination folder.

• From the Root Folder
  When a test case is moved from the Root folder, it is not removed from the Root folder but is instead added to the selected destination folder. 

Dependent Test Cases

You can establish test case dependencies from the Dependent Test Cases tab in the test case details screen to manage the execution order. This ensures a logical and organized testing process, as one test case's execution depends on the successful completion of another.

For more information, refer to Test Case Dependencies.

Creating a New Version of the Test Case

You can edit a test case and save it as a new version. Read more about ​Creating New Test Case Versions​​.

Archiving a Test Case

Archiving removes test cases from all associated folders and moves them to a dedicated “Archived” bucket. To view archived test cases, apply Show Only Archived Test Cases filter in the test case list view.

Open

Once you have archived a test case, you cannot perform any operations like adding attachments, linking test cases, issues, and release cycles on an archived test asset.

A. Archiving from the Test Case Detail Page

To archive a test case from the detail page, perform the following steps:

1. Open the test case details page by selecting the test case.

2. Click the Archive icon located at the top right corner of the page.

3. The test case is archived after confirmation.

Open

B. Archiving from the Test Case module list view

Open

To archive a test case from the test case module list view page, perform the following steps:

1. Open the test cases module.

2. The test case list view opens with a list of existing test cases within the project/folder.

3. Click on the Cog icon for the test case you want to archive and select Archive. The test case is archived after confirmation.

Archiving a Specific Test Case Version

To Archive a Specific Test Case Version, read the document: Archiving a Specific Test Case Version 

Unarchiving a Test Case

When unarchiving test cases, you can select one or more folders to associate.

To unarchive an archived test case, perform the following steps:

1. Click on filters

2. Select Show Only Archived Test Cases.

3. Click the cog icon next to the archived test case.

4. Click Unarchive.

Open

Deleting Entire Test Cases

Deleting a test case is a two-step process: Archive the test case and then deleting it.

To delete a test case, perform the following steps:

1. Archive the Test Case

   • All the versions of the test case must be archived to delete that particular test case.

2. Delete the Test Case

   • This will permanently delete the test case, including all its archived versions.

Deleting from the Test Case List View

You can also delete a test case from the Test Case List View.

To delete a test case from the Test Case List View, perform the following steps:

1. To view archived test cases, select the Show Only Archived Test Cases check box in the filters section.

2. Search for the archived test case you want to delete.

3. Click the Cog icon next to the archived test case and select Delete.

Deleting a Specific Test Case Version

For instructions on deleting a specific test case version, refer to the section Deleting a Specific Test Case Version

Sharing Test Cases with Other Users

You can share the test case summary and test case link with other members of the team for easy access to the latest version.

To share a test case, perform the following steps:

1. Open the Test Cases details page.

2. Click the Share icon at the top (refer to the image below).

3. Enter one or more email addresses.

4. Write a message (optional but recommended) describing the test case or required actions.

5. Click Share.

Open

Copy Test Case Link

You can copy the test case link and share it with other users to provide direct access to a specific test case. Authorized members can access the test case directly via the shared link.

URL Syntax

Steps to Copy a Test Case

1. Open the test case details page.

2. Locate and click the Copy Link icon on the breadcrumb navigation.

3. You can share this link through any preferred communication channel.

Open

You can share this link with team members using email, chat, or other communication methods.

Linking Requirements to Test Cases

You can link requirements to the corresponding test cases to ensure traceability, allowing testers to validate that all requirements are covered by test cases and easily track testing progress.

This linkage applies to all versions of the test case, ensuring that any updates to the test case maintain the requirement's relevance.

→ Use Case: Users link requirements with related test cases for testing. Testers get the idea of what is developed by studying requirements and on that basis, they write test cases to describe how to test the developed application. Thus, linking the test case with the requirement gives relevance between the two what is developed and what to test.

Linking Requirements

Requirements can be linked to a test case through the Requirements tab on the Test Case Details page.

Open

To Link Requirements to a test case, perform the following steps:

1. Go to the Requirements tab of the test case details page or the test case edit page.

2. Click the Link button.

3. It opens the Link Requirements screen, displaying a list of all available requirements.

4. You can filter the requirements, sort the requirements, or manage the view as needed.

Open

You can link a single requirement or multiple requirements to a test case.

• For linking a Single Requirement, click the Link () icon on the right.

• For linking Multiple Requirements, select the desired requirements and click Link and Close button (as shown in the above image).

You can also link multiple requirements from different projects to a single test case.

Linking Requirements Across Projects

To link multiple requirements from different projects, perform the following steps:

• Select Project from the Project drop-down in the top-left corner.

• The associated requirements for the selected project will be displayed.

• Tick the checkboxes next to the relevant requirements.

• After selecting the requirements from one project, click the Link before switching to another project.

• Once all requirements are linked, click Link and Close.

Open

Selecting Version

To link a specific version of a requirement, expand the requirement and select the specific version.

Open

Filtering Requirements

To find the relevant requirements, you can apply basic as well as advanced filters on the requirement records. Labels and Folder path filters further aid in searching records.

Open

Requirements of Release and Cycle of this Test Case

When viewing test assets of other projects, the Requirements of Release and Cycle of this Test case checkbox remains unavailable. For test cases within the same project, this check box enables the users to view only those test cases that are associated with the same Release and Cycle to which the test case is linked.

Open

Linking Requirements by Entity Key 

This feature allows users to link requirements to a test case using comma-separated requirement entity keys.

To link requirements by entity key, perform the following steps:

1. Go to the Requirements tab of the test case.

2. Click on the Link By Entity Key button.

Open

3. It opens the Link Requirements pop-up. Mention comma-separated Requirement keys.

4. Click Link.

Open

The requirements with the mentioned keys get linked to the test case.

Viewing Linked Requirements

The linked requirements are shown on the lower grid pane.

Open

If the requirements linked are from other projects, the Entity Key of the corresponding project will be displayed. Click on the Requirement Entity Key to view the requirement detail page in the respective project.

Unlinking Requirements from a Test Case

To unlink requirements from a test case, follow these steps:

1. Navigate to the Requirements tab on the test case details page.

2. To unlink a single requirement: Click the Unlink icon next to the requirement to remove. The requirement is unlinked after confirmation.

3. To unlink multiple requirements, select the requirements from the test case and click the Unlink Selected button.

Open

Syncing the Latest Test Case Version with Requirements

You can sync the latest version of the test case to its linked requirements individually or in bulk. The sync feature in the Requirement tab under the Test Case module allows you to sync the test case version with individual requirements or with multiple requirements.

For example, the current version of the test case is v2. All the requirements are linked to this version of the test case. Now, a new version (v3) is created. Users can sync the v3 of test case with the linked requirements.

(A) Syncing the Latest Test Case Version with a Single Requirement

To sync the latest test case version with a single requirement, perform the following steps:

1. Navigate to the Test Case module.

2. Select the Requirement tab.

3. Sync with a Single Requirement:

   • When a new version of the test case is available, the sync icon under the Test Case Version column turns blue.

   • Click on this blue sync icon to sync the latest version of the test case with the requirement.

This action ensures that the linked requirement is aligned with the most recent version of the test case.

Open

(B) Syncing the Latest Test Case Version with Multiple Requirements in Bulk

If multiple requirements are linked to a test case and a new version of the test case is available, you can bulk sync all linked requirements to the latest test case version.

To sync the latest test case version with multiple requirements in bulk, perform the following steps:

1. Navigate to the Requirement tab on the Test Cases Detail Page.

2. Select the requirements you want to sync the latest test case version.

3. Click the Sync Latest Version of Test Case button.

Open

4. Click Yes to proceed. Upon successful synchronization, a success message will appear on your screen.

For bulk synchronization, you can monitor the progress in the Scheduled Tasks section. The selected requirements will be updated to reflect the latest version of the test case.

Linking Test Suites to Test Cases

In QMetry, you can link test suites to the corresponding test cases through the Test Executions tab on the Test Case Details Page or the Test Case Edit Screen.

Test Suites are linked to the test case in multiple Platforms associated with it.

Open

Clicking the Link Test Suites button opens the test suite list view. You can customize the view using arrange columns, filters or other customization options.

Open

Linking Test Suites within the Same Project

Open

1. Open the Test Executions tab and click the Link Test Suites button.

2. On the Link Test Suite pop-up, you can link single or multiple test suites:

   • For linking a Single Test Suite, click the Link () icon on the right.

   • For linking Multiple Test Suites, select the desired test suites and click on the Link and Close button.

The linked test suites will appear on the Test Executions tab of the test case details page.

Linking Test Suites Across Projects

To link test suites from other projects, perform the following steps:

1. Open the Test Executions tab and click the Link Test Suites button.

2. On the Link Test Suite pop-up, click on the project drop-down menu to select the required project.

3. Available test suites for the selected project are displayed.

4. Select and link test suites for the chosen project by clicking the link button.

5. Once all the test suites are linked, click Link and Close.

Open

Viewing Linked Test Suites

All test suites linked to the test case are displayed in the Test Executions Tab. To view the details of a linked test suite, click on the Test Suite Entity Key.

If the test suite belongs to another project, the Entity Key of the corresponding project is displayed. Clicking the entity key will open the test suite details page in that respective project.

View Archived Test Runs

An execution/test run is archived when the associated Platform, Release, Cycle, or Test Suite is archived. Once a Platform, Release, Cycle, or Test Suite is archived, any test executions linked to it will not be displayed on the Test Executions tab of the test case.

To view archived Test Runs, select the Show Archived Records checkbox in the filter options.

Open

eSignature Considerations

The Project drop-down on the Link Test Suite screen will only show projects where eSignature settings align with linking permissions.