Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Panel

Definition Tree - Context menu operations

The definition tree can contain items of three different types.
These are tree folders, test items and a root folder.
Each of these item types has its own set of context menu entries, whereby some menu entries are present in more than one set.
For each of the following context menu operations the item types providing this operation are indicated.

Folder related operations


Available for:tree folderroot foldertest item
Create folderOpens the create folder dialog.
Within the dialog you can enter a name and a description for the new folder.
Note that the names of folders with the same parent folder have to be unique.
Click Create to create the new folder below the selected one. 

Image Modified

Image Modified

Image Modified

EditOpens the edit folder dialog.
The dialog allows you to change the name and the description of a folder.

Image Modified

Image Modified

Image Modified

DeleteOpens the delete folder dialog.
Deleting a folder will also delete all subfolders and remove all contained tests from the definition tree.
The tests won't be deleted and can be added again later.

Image Modified

Image Modified

Image Modified

Expand allExpands the selected tree folder and all subsequent folders.

Image Modified

Image Modified

Image Modified

Collapse allCollapses the selected tree folder and all subsequent folders.

Image Modified

Image Modified

Image Modified

Refresh folderRefresh the folders content and fetch new data from server.

Image Modified

Image Modified

Image Modified

Show in issue navigatorOpens the JIRA issue navigator in a new browser tab / window.
Applies a search query using the testDefinitionPath JQL extension to display all issues contained
in the selected folder and its subsequent folders in the issue navigator. 

Image Modified

Image Modified

Image Modified

CutStage a folder or test for cutting.

Image Modified

Image Modified

Image Modified

PastePaste staged content into the selected folder.
Note that the staged content will be moved to the new folder not copied.
Cutting and pasting can be used only within the same plan tree.
A staged test can be pasted to every folder of the same plan tree.
A staged folder can be pasted to the root folder of the same plan tree.
Moving a folder to another tree folder can be done via drag and drop. 

Image Modified

Image Modified

Image Modified

Test related operations


Available for:tree folderroot foldertest item
Create issueOpens the JIRA Create Issue dialog.
More information to creating issues can be found in the JIRA documentation.
Click Create to create the new issue / test and add it to the selected folder or the parent
folder if a test item was selected.

Image Modified

Image Modified

Image Modified

Add existing issuesOpens the add existing issues dialog.
Select Add all ... to add all issues created on the selected test project that aren't already part of the tree.
Select Search for issues to search for recently viewed issues to add them to the selected folder.
Select From filter to add all issues matching the provided filter or JQL query.
Note that when selected Search for issues or From filter the selected issues do not necessarily come
from the same project the definition tree belongs to.
Also issues that are already part of this definition tree won't be added. 

Image Modified

Image Modified

Image Modified

Edit issueOpens the JIRA Edit Issue dialog.
More information to editing issues can be found in the JIRA documentation.

Image Modified

Image Modified

Image Modified

Add linkOpens the add link dialog.
This allows you to  add a JIRA issue link between the test selected in the definition tree and one or more
tests selected from the dialog. 

Image Modified

Image Modified

Image Modified

Test executionOpens the add execution dialog for this particular test.
This allows you to create and run a single test execution right out the definition tree.
For further information take a look at the Test Execution - Reference. 

Image Modified

Image Modified

Image Modified

RemoveOpens the remove test dialog.
The test will only be removed from the definition tree.
It won't be deleted and can be added again later. 

Image Modified

Image Modified

Image Modified

Panel

Definition Tree - Drag and drop operations

The definition tree supports the following drag and drop operations:

  • Change folder positions
  • Change the folder hierarchy
  • Change the position of tests
  • Move tests between folders

...

Panel

Definition Tree - Export

Click on the Export button to open the export menu.
Select an export format from the list to export the definition tree content to.
The exported content depends on the type of the item currently selected.
An applied filter also affects the exported content.

The following tables describe the export content in each format depending on issue type and applied filter.

Since the XML export provides information that can be used to integrate another application with T4J via its REST API a complete example export file is provided.
The example file is the result of an export with the root folder of the definition tree selected and no filter applied. It covers the structure of the root item, a folder item and a test item.
Note that there's no example export for Excel and Word since those export formats are mostly used for internal documentation purposes. Therefore a textual description of the content should be sufficient. 

Plan Tree - Export formats

XML

Type of the selected tree itemContentFilter applied
Test itemDetailed information about the selected test item including item ids that can be used for REST API calls.

Image Modified


Contains the same information stated above.

Image Modified

Tree folderContains no information except for the following items: <trees><tree/></trees> 

Image Modified


Detailed information about the selected tree folder and all subsequent folders and contained test items.

Image Modified

Root folder or nothing selectedDetailed information of the root folder.

Image Modified


The content is equivalent to the content when selecting a tree folder just with the root folder as top level element. 

Image Modified

Code Block
languagexml
titleExample response
collapsetrue
<?xml version="1.0" encoding="UTF-8"?>
    <trees>
        <tree>
            <folders>
                <name>PROJECT</name>
                <description/>
                <id>-1</id>
                <nameDisplay>PROJECT</nameDisplay>
                <parent>-2</parent>
                <folders>
                    <name>Example Folder</name>
                    <description>An example folder</description>
                    <id>658</id>
                    <nameDisplay>Example Folder</nameDisplay>
                    <parent>-1</parent>
                    <folders>
                        <name>Subfolder</name>
                        <description>A subfolder of the example folder.</description>
                        <id>668</id>
                        <nameDisplay>Subfolder</nameDisplay>
                        <parent>658</parent>
                        <issues>
                            <id>1000</id>
                            <issueId>12300</issueId>
                            <key>PRJ-20</key>
                            <url>http://host:port/jira/browse/PRJ-20</url>
                            <summary>ExampleTest</summary>
                            <description>test description</description>
                            <descriptionHTML>&lt;p&gt;test description&lt;/p&gt;</descriptionHTML>
                            <iconUrl>http://host:port/jira/images/icons/issuetypes/newfeature.png</iconUrl>
                            <issueType>New Feature</issueType>
                            <position>1</position>
                            <status>To Do</status>
                            <statusUrl>http://host:port/jira/images/icons/statuses/open.png</statusUrl>
                            <priority>Major</priority>
                            <priorityUrl>http://host:port/jira/images/icons/priorities/major.png</priorityUrl>
                            <attributes>
                                <attribute>
                                    <name>Custom - Hidden Job Switch</name>
                                    <value>false</value>
                                </attribute>
                            </attributes>
                            <links>
                                <link>
                                <linkName>is blocked by</linkName>
                                <issueKey>PRJ-17</issueKey>
                                <issueSummary>Linked Issue</issueSummary>
                                <issueUrl>http://host:port/jira/browse/PRJ-17</issueUrl>
                                <priority>Major</priority>
                                <status>To Do</status>
                                </link>
                            </links>
                            <teststeps>
                                <teststep>
                                    <id>53</id>
                                    <name>Example Test Step</name>
                                    <description>An example test step using parameter p1: ##p1##</description>
                                    <result>The expected result.</result>
                                </teststep>
                            </teststeps>
                            <parameters>
                                <parameter>
                                    <key>p1</key>
                                    <value>parameter value</value>
                                </parameter>
                            </parameters>
                            <path>Example Folder</path>
                            <path>Subfolder</path>
                            <combinedPath>\PRJ\Example Folder\Subfolder</combinedPath>
                        </issues>
                        <position>1</position>
                    </folders>
                    <position>1</position>
                </folders>
                <position>0</position>
            </folders>
        </tree>
    </trees>


Excel

Type of the selected tree itemContentFilter applied
Test itemContains basic information about the selected issue. Also contains information about issue links, test steps,
parameters and custom JIRA issue fields. 

Image Modified


Contains the same information stated above.

Image Modified

Tree folderContains no information.

Image Modified


Contains the name of the selected folder. Contains the folder path for all issues contained in the selected folder
and subsequent folders. Also contains basic informations for those issues and information about the test steps. 

Image Modified

Root folder or nothing selectedContains the name of the project.

Image Modified


The content is equivalent to the content when selecting a tree folder just with the root folder as top level element.

Image Modified


Word

Type of the selected tree itemContentFilter applied
Test itemContains basic information about the selected test item. Also contains information about issue links, test steps,
parameters and custom JIRA issue fields. 

Image Modified


Contains the same information stated above.

Image Modified

Tree folderContains no information.

Image Modified


Contains the name of the selected folder and all subsequent folders and basic information about the
contained issues. 

Image Modified

Root folder or nothing selectedContains the name of the project.

Image Modified


The content is equivalent to the content when selecting a tree folder just with the root folder as top level element.

Image Modified