Overview

In T4J you manage test cases in a view consisting of the following parts:

Definition Tree: The definition tree is located on the left side of the view and is always visible. It is used to organize the tests needed in the selected test project. To edit the T4J specific attributes of a test case, it has to be part of a definition tree. The test cases that have been placed in a definition tree can also be added to test plans more easily.

The definition tree starts with a root folder named after the corresponding project and contains other folders and test cases under this folder. This structure allows you to organize test cases according to the needs of your project. A test case may only appear once in a definition tree.

Selecting a test case in the definition tree opens a detailed view of the case on the right side. Selecting a folder in the definition tree opens the reading view for the folder on the right side.

Reading View: The reading view is located on the right side of the view and is visible when a folder is selected. The reading view displays the items in the selected folder as a list. Subfolders can be expanded and collapsed.

Issue Detail View: The issue detail view displays the important information about a test case and provides interfaces to edit its definition. It is located on the right side of the definition view and is visible when a test case is selected.

The issue detail view displays the fields of a test case, similar to the standard Jira issue view. It displays issue links and provides methods to create, edit, and delete issue links. It also contains the following test specific information: Test Steps, Parameters, Execution, and Plan Overview.

1 Overview
2 Reading View Actions
3 Issue Detail View Actions
4 Definition Tree - Context Menu Actions
5 Definition Tree - Drag and Drop Actions
6 Filtering Test Cases
7 Exporting Test Cases

Reading View Actions

Purpose	Action

Purpose	Action
Highlight test case in definition tree	Select the issue key of the test case in the reading view.
Expand or collapse a folder	Select the folder in the reading view.
Expand or collapse a folder and all its subfolders	Right click on the folder in the reading view and chose the desired option.

Issue Detail View Actions

Purpose	Action

Purpose	Action
Modify test case	Select Edit.
Manage issue links	Select the + icon to add a link. Select the Edit icon to edit a link. Select the Delete icon to delete a link.
Manage test steps	Select the + icon to add a step. Select the Edit icon to edit a step. Select the Copy icon to copy a step. The new step is added immediately after the copied step. Select the Delete icon to delete a step. Change the order of the steps using the arrow icons.
Manage parameters	Select the + icon to add a parameters. Select the Edit icon to edit a parameter. Select the Delete icon to delete a parameter.

Definition Tree - Context Menu Actions

Menu Entry	Action	tree folder	root folder	test case

Menu Entry	Action	tree folder	root folder	test case
Create issue	Opens the Jira Create Issue dialog. Select Create to create the new test case and add it to the selected folder or the parent folder of the selected test case.
Create folder	Opens the create folder dialog, where you enter a name and a description for the new folder. Attachments can be uploaded for folders and embedded in the description field. (Only images are supported.) Note that the names of folders within the same parent folder must be unique. Select Create to create the new folder below the selected one.
Edit	Opens either the edit folder or Jira edit issue dialogs, were you can modify the item.
Add link	Opens the link dialog, where you can add issue links between the selected test case and one or more test cases selected in the dialog.
Delete	Opens the delete folder dialog. Deleting a folder also deletes all subfolders and removes all contained test cases from the definition tree. The test cases themselves are not deleted and can be added again later.
Add existing issues	Opens the add existing issues dialog. Select Add all ... to add all issues in the selected folder that are not already part of the tree. Select Search for issues to search for recently viewed issues and add them to the selected folder. Select From filter to add all issues matching the provided filter or JQL query to the selected folder. Issues that are already part of the definition tree but located in other folders are not added to the selected folder. Note that issues from other projects can be added to the tree.
Expand all	Expands the selected tree folder and all subsequent folders.
Collapse all	Collapses the selected tree folder and all subsequent folders.
Refresh folder	Refreshes the folder's content by fetching new data from the server.
Show in issue navigator	Opens the Jira issue navigator in a new browser tab and executes a search query using the testDefinitionPath() JQL function to display all issues contained in the selected folder and both its direct and indirect subfolders in the issue navigator.
Test execution	Opens the execution dialog for this particular test, where you can create and run a single test execution.
Cut	Stages a folder or test case for pasting.
Paste	Pastes staged content into the selected folder by adding the items to the new folder. Cut and paste can only be used within the same definition tree.
Remove	Opens the remove dialog. Note that the test case is only removed from the definition tree. The issue itself is not deleted and can be added to the tree again later.

Definition Tree - Drag and Drop Actions

The following drag and drop operations are possible in the definition tree:

Change folder positions.
Change the folder hierarchy.
Change the order of test cases within a folder.
Move test cases between folders.

Filtering Test Cases

Select the Filter button to open the filter input, where you can restrict the the definition tree to display only test cases that meet specific criteria. There are two modes for specifying the criteria:

Basic: To simply select a saved filter.
Advanced: To enter a JQL expression.

You switch between the two modes by selecting the Advanced or Basic buttons.

Once a filter is applied, only test cases matching the filter query are displayed in the tree. An orange warning symbol in the top right corner of the tree indicates that a filter is applied.

To stop applying a filter, either select the Clear button in advanced mode or select the x next to the selected filter in basic mode.

Exporting Test Cases

Select the Export button to open the export menu, where you chose an export format from the list to export the contents of the selected item definition tree in a given format.

Export does not currently produce the expected results when a filter is activated. Remember to clear the active filter before exporting.

Format	Exported Content

Format	Exported Content
XML	Detailed information about the selected item including issue IDs that can be used for REST API calls. See below for an example of an XML export.
Excel	Basic information about the selected item, as well as information about issue links, test steps, parameters and custom Jira issue fields.
Word	Basic information about the selected item, as well as information about issue links, test steps, parameters and custom Jira issue fields.

<?xml version="1.0" encoding="UTF-8"?>
<trees>
  <tree>
    <issue>
      <id>243</id>
      <issueId>12810</issueId>
      <key>DPS-24</key>
      <url>https://eval.easesolutions.com/Jira/browse/DPS-24</url>
      <summary>Castle Size Test Case 1</summary>
      <descriptionHTML/>
      <iconUrl>
        https://eval.easesolutions.com/Jira/secure/viewavatar?size=xsmall&avatarId=10304&avatarType=issuetype
      </iconUrl>
      <issueType>Test Case</issueType>
      <position>1</position>
      <status>New</status>
      <statusUrl>
        https://eval.easesolutions.com/Jira/images/icons/status_generic.gif
      </statusUrl>
      <priority>Medium</priority>
      <priorityUrl>
        https://eval.easesolutions.com/Jira/images/icons/priorities/medium.svg
      </priorityUrl>
      <attributes>
        <attribute>
          <name>Assignee</name>
          <value>Unassigned</value>
        </attribute>
        <attribute>
          <name>Component/s</name>
          <value>None</value>
        </attribute>
        <attribute>
          <name>Updated</name>
          <value>2022-01-03 08:39:06</value>
        </attribute>
        <attribute>
          <name>Reporter</name>
          <value>DS</value>
        </attribute>
        <attribute>
          <name>Labels</name>
          <value>None</value>
        </attribute>
        <attribute>
          <name>Resolution</name>
          <value>Unresolved</value>
        </attribute>
        <attribute>
          <name>Created</name>
          <value>2020-12-28 08:37:27</value>
        </attribute>
      </attributes>
      <links>
        <link>
          <linkName>is blocked by</linkName>
          <issueKey>DPS-26</issueKey>
          <issueSummary>
            Failure in castle size test - Test Execution 2021-12-06 / 3.
          </issueSummary>
          <issueUrl>https://eval.easesolutions.com/Jira/browse/DPS-26</issueUrl>
          <priority>Medium</priority>
          <status>Draft</status>
          <inward>true</inward>
        </link>
        <link>
          <linkName>tests</linkName>
          <issueKey>DPS-10</issueKey>
          <issueSummary>Castle Size</issueSummary>
          <issueUrl>https://eval.easesolutions.com/Jira/browse/DPS-10</issueUrl>
          <priority>Medium</priority>
          <status>Draft</status>
          <inward>true</inward>
        </link>
      </links>
      <teststeps>
        <teststep>
          <id>38</id>
          <name>Measure test sandcastle size in moons.</name>
          <description>Here is a the use of variable: ##foo##</description>
          <result>
            The test sandcastle should be exactly 4 moons in height. Here is a the use of the variable foo: ##foo##
          </result>
        </teststep>
      </teststeps>
      <parameters>
        <parameter>
          <key>foo</key>
          <value>bar</value>
        </parameter>
      </parameters>
      <path>Unit tests</path>
      <combinedPath>\DS Project Sandcastle\Unit tests</combinedPath>
    </issue>
  </tree>
  <prjKey>DPS</prjKey>
</trees>

T4J - Test Management for Jira

Test Cases - Reference