Versions Compared

Old Version 21

changes.mady.by.user Angelica Salazar

Saved on

compared with

New Version Current

changes.mady.by.user David Sedlock

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: TFJ-1841 - removed header column option from tables to make them consistent with the tables in the other reference pages.

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.

Table of Contents
minLevel1
maxLevel7

Reading View Actions

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

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

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.

(tick)

(tick)

(tick)

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. 

(tick)

(tick)

(error)

Edit

Opens either the edit folder or Jira edit issue dialogs, were you can modify the item.

(tick)

(error)

(error)

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. 

(error)

(error)

(tick)

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.

(tick)

(error)

(error)

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.

(tick)

(tick)

(error)

Expand all

Expands the selected tree folder and all subsequent folders.

(tick)

(tick)

(error)

Collapse all

Collapses the selected tree folder and all subsequent folders.

(tick)

(tick)

(error)

Refresh folder

Refreshes the folder's content by fetching new data from the server.

(tick)

(tick)

(error)

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. 

(tick)

(tick)

(error)

Test execution

Opens the execution dialog for this particular test, where you can create and run a single test execution. 

(error)

(error)

(tick)

Cut

Stages a folder or test case for pasting.

(tick)

(error)

(tick)

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.

(tick)

(tick)

(error)

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. 

(error)

(error)

(tick)

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.

Note

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

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. 

Expand
titleExample of an export in XML format:
Code Block
languagexml
<?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>