QMetry allows testers to organize and manage test cases in a Folder structure-based hierarchy. Testers can group related test cases and organize them systematically during authoring/post authoring. As an example, testers can create folders like Regression Test, Smoke Test, Sanity Test, etc. to group related test cases. Each new test case folder creates the next level of test case organization in your test case tree. It helps in carrying out bulk operations like associating test cases to a story, copy/move test cases from the source folder to the destination folder.

Where to find the feature?

Open the QMetry app.

It opens the menu like below. Select Test Management on it.

Open

There are four sections in Test Management:

• Test Case

• Test Cycle

• Test Plan

• Test Report

Click on the Test Case tab to organize test cases in folders.

The left pane displays the folder structure of test cases. The right pane displays all test cases until you select a particular folder to view particular test cases.

Open

1. Project selection: By default, the project that you selected in Jira will be displayed here. You can select another project. The folder tree is rendered in accordance with the project selection.

2. Root test case folder, which shows all the test cases created within the project irrespective of the folder within which it is created.

3. Sub folders within the root folder.

Open

Create Test Folders/Sub Folders

Add Folder

Follow either of the following ways to add a new folder under the root/sub folder.

A. Right-click on the folder under which you want to create a new folder and select Add Folder.

Open

B. Select the folder under which you want to create a new folder and click on the + Folder button above the tree.

Open

The Add new folder screen opens.

• Enter Folder Name and Description, select/change the Parent Folder Path, and click Submit. It creates a sub-folder under the selected folder.

• Create another: Select the checkbox to keep the Add New Folder pop-up open to continue adding folders.

Open

A new folder is added to the tree on the sub-level hierarchy.

Folder Hierarchy View

Users can view the details about the number of test cases within the current folder and the total test cases, including test cases of sub-folders.

The syntax of folder hierarchy represents -

<folder name> No. of test cases within current folder (Total no. of test cases, including test cases of sub-folders)

Open

Edit Folder

Right-click on the folder name and select Edit Folder.

Open

You can rename the folder and change the description.

Open

You can expand the size of the folder structure panel. Keep the panel size as per your requirement by clicking on the arrow button or by dragging it with the mouse.

Open

Choose to show/hide Child Test Cases from Sub Folders

Users can opt to show/hide test cases from sub folders at parent folder. By default, the Display Test Cases of Sub Folder(s) option remains disabled for new projects and new users. The test cases from sub-folders remain hidden at parent folder level on the test case list view. To display the child test cases, open the More options menu on the test case tree at left, and select Display Test Cases of Sub Folder(s).

Use Case: Users want to view test cases of the sub-folders at the parent folder level instead of navigating to the sub-folders.

• The set preference is applied to all the screens from where the test case module list opens up.

• If the same test case is part of multiple sub-folders, then it is displayed only once at parent folder.

• Export and other Bulk Operations from parent folder level are carried out as per the set preference for child test cases.

Open

Reordering Test Cases

The Sequence No. column is visible in a folder on the test case list view, allowing you to rearrange the test cases to ensure the correct order. The column shows the current position of each test case in the folder hierarchy. The Sequence No. column supports sorting. The drag and drop and manual reordering functionalities will not work if you enable sorting in any other columns.

The Sequence No. column is visible only when:

• The Display Test Cases of Sub Folder(s) option is disabled on the folder tree.

• You have selected a folder other than the All Test Cases folder at the root level.

Open

You can change the test case sequence using either of the following methods:

• Changing the sequence number in the column

• Dragging and dropping the test cases

Changing the Sequence Number

You can change the test case sequence on the list by editing the number in the Sequence No. column.

Open

Dragging and Dropping the Test Cases

Hover over the icon, then drag and drop the test case to the required location. The sequence of the other test cases is adjusted accordingly.

Open

The following screens display test cases in the same sequence as set on the test case list view:

• Copy Steps from Existing Test Case

• Link Test Case to Test Cycle Screen (From a Test Cycle)

• Link Existing Test Case to Story (Test Case Acceptance Criteria section in Story)

Audit Logs

Audit logs for individual test cases and the Configuration section store records and information related to the test case sequence changes.

Perform the following steps to view the audit logs of individual test cases:

1. Navigate to the test case detail page.

2. Click the Audit Logs tab.

The reordering or test case sequencing details appear.

Open

Perform the following steps to view Audit Logs in the Configuration section:

1. Navigate to the Configuration section.

2. Select Audit Log.

3. Click the Test Entity Logs tab.

4. Select the following options from the list:

Open

Rearrange/Sort Folders

Test Case folders can be arranged on Name and Date. Open the Sort by drop-down and select the option to arrange the folders on the tree. The folders can be sorted alphabetically and by date of creation in an ascending/descending manner. By default, folders are sorted on Oldest First.

Open

Copy/Cut and Paste Folder

Copy & Paste: You can Copy a folder and Paste it to another folder. This will create a copy of the existing folder with test cases under it.

Cut & Paste: You can also Cut a folder and Paste it to another location/folder on the tree to change the hierarchy. All the test cases under the folder will also move along with the folder.

Open

Right-click the folder in which you want to paste the cut/copied test case folder.

Open

Delete Folders

Right-click on the folder that you want to delete and select Delete Folder. It will permanently delete the selected folder. If there are sub-folder under the folder, then all these sub-folders will be deleted. All the test cases under such folders will be disassociated with the folders and moved to the root folder. You will still have an option to move these test cases to the folder of your choice.

Open

On clicking Delete, the user is asked to select a folder in which they want to move the underlying test cases so that they can keep the test cases in the preferred folder.
If a folder is not selected, then the test cases will be moved to the root folder. i.e. "All Test Cases" folder here.

Open

Copy Folder Path 

Right-click on the folder for which you want to copy the folder path and select the Copy Folder Path option. The folder path will be copied to the clipboard.

Open

Copy Folder ID

Users can directly add test cases created via Automation into the defined test case folder using the Folder Id.

Use Case: An automation engineer wants to arrange test cases created via Automation API, Maven Plugin, Jenkins/Bamboo into a specific folder that can be provided as a parameter, instead of default root folders.

Right click on the folder the Folder ID of which you want to copy and select the Copy Folder Id option on the menu. The folder Id will be copied to the clipboard. You can use it in Automation API and Maven, Jenkins & Bamboo plugins for adding created test cases in a particular folder.

Open

Copy Folder Link

Users can share a specific Test Case folder by sharing the folder link with other users. The link is accessible to other users within the project. Users with whom the link is shared can open the folder link and directly go to the folder. Users can access the folder and its data. If it is a parent folder/root folder, the data is displayed accordingly.

For example,

In a project, Project Managers, Developers, and other teams are working in collaboration with each other. They also create test assets like test cases required for the project. They prefer to have a direct folder link and share it across teams for the ease of adding test cases to it.

Steps

1. Right-click on the folder and select the Copy Folder Link option. The link is copied to the clipboard.

2. Share this link with other users through the channel accessible to them. For example, you can paste the copied folder link in the email. The recipient of the email can then directly go to the folder and start working on it.

Open

Export Test Cases to Excel

Test Case folders can be exported using the Export Excel option. This enables users to share test cases as per the folder structure in QMetry projects and to save for further references.

If the Display Test Cases of Sub Folder(s) option is enabled on the tree, then the test case of sub-folders will also be exported along with the test cases of parent folder.

Right-click on the folder the test cases under which you want to export and select “Export to Excel”.

Open

Click on the notification icon as shown below:

Open

Once the process is complete, click on the Download File as shown below. Users will be able to get data for all Test Cases in an excel format.

Open

Search Folders

Users can search for folders on the folder structure through the search box. It is useful where the folder structure is very complex with multiple hierarchies or the folder list is too long to locate a specific folder.

Open

All Test Cases (Root Folder)

You can perform the following operations on the root folder:

• Add Subfolder

• Paste the copied/cut folder

• Copy Folder Link

• Export to Excel

• Link with Test Cycle: Link all the test cases under the folder with the test cycle.

• Link with Story: Link all the test cases under the folder with the story.

Open

You can not perform other operations on the root folder that are available on sub-folders like edit, delete, cut, copy, etc.

From the root folder, you can perform only Reuse action (and not Move action) for test cases as the test cases remain on the root folder and are not moved.

Bulk Operations

The options for carrying out Bulk Operation remain invisible by default. The options available for Bulk Operations become visible on the screen as soon as you select at least one record.

Open

You can also perform the following Bulk Operations on test cases. Follow the links for more details.

Move/Reuse Test Cases

Bulk Update

Bulk Delete

Link with Test Cycle (Plan Test Case for Execution)

Link with Story (Plan Test Cases in Story)

Export Test Cases

Import Test Case

The Import Test Case feature helps you import test cases from Excel file (CSV/XLSX format) file into QMetry for the Jira add-on. Read more details on this page Import Test Cases.

Moving and Re-ordering Folders

You can re-order or move folders within the folder hierarchy using the drag and drop functionality across all modules. Refer to Moving and Reordering Folders for more information.