Versions Compared

Old Version 5

changes.mady.by.user Support Advocate (ease solutions)

Saved on

compared with

New Version 6

changes.mady.by.user Support Advocate (ease solutions)

Saved on

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. 

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

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.

Expand allExpands the selected tree folder and all subsequent folders.

Collapse allCollapses the selected tree folder and all subsequent folders.

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

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. 

CutStage a folder or test for cutting.

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. 

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 - Filter

Click on the Filter button to open the filter input.

Similar to the JIRA issue search the filter input provides a basic and an advanced mode.
In basic mode you can select  a saved filter to apply. The advanced mode allows you to enter a JQL filter query.
You can switch between the two modes by clicking the Advanced / Basic button.

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

Click on the Clear button to remove a filter in advanced mode.
To remove a filter in basic mode click on the Image Removed Image Added next to the selected filter. 

<?xml version="1.0" encoding="UTF-8"?> <trees> <tree> <folders> <name>PROJECT</name> <description/> <id>-1</id>
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

Code Block
languagexml
titleExample response
collapsetrue
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 Added


Contains the same information stated above.

Image Added

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

Image Added


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

Image Added

Root folder or nothing selectedDetailed information of the root folder.

Image Added


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

Image Added

Code Block
languagexml
titleExample response
collapsetrue
<?xml version="1.0" encoding="UTF-8"?>
    <trees>
       <nameDisplay>PROJECT</nameDisplay> <tree>
            <folders>
  <parent>-2</parent>              <name>PROJECT</name>
  <folders>              <description/>
      <name>Example Folder</name>         <id>-1</id>
           <description>An example folder</description>   <nameDisplay>PROJECT</nameDisplay>
                 <id>658</id><parent>-2</parent>
                <folders>
   <nameDisplay>Example Folder</nameDisplay>                <name>Example Folder</name>
   <parent>-1</parent>                 <description>An example folder</description>
 <folders>                   <id>658</id>
     <name>Subfolder</name>               <nameDisplay>Example Folder</nameDisplay>
        <description>A subfolder of the example folder.</description>       <parent>-1</parent>
                 <id>668</id>   <folders>
                     <nameDisplay>Subfolder</nameDisplay>   <name>Subfolder</name>
                     <parent>658</parent>   <description>A subfolder of the example folder.</description>
                <issues>        <id>668</id>
                    <id>1000</id>    <nameDisplay>Subfolder</nameDisplay>
                        <issueId>12300<<parent>658</issueId>parent>
                        <issues>
    <key>PRJ-20</key>                        <id>1000</id>
    <url>http://host:port/jira/browse/PRJ-20</url>                        <issueId>12300</issueId>
    <summary>ExampleTest</summary>                        <key>PRJ-20</key>
    <description>test description</description>                       <url>http://host:port/jira/browse/PRJ-20</url>
      <descriptionHTML>&lt;p&gt;test description&lt;/p&gt;</descriptionHTML>                      <summary>ExampleTest</summary>
        <iconUrl>http://host:port/jira/images/icons/issuetypes/newfeature.png</iconUrl>                    <description>test description</description>
       <issueType>New Feature</issueType>                    <descriptionHTML>&lt;p&gt;test description&lt;/p&gt;</descriptionHTML>
       <position>1</position>                     <iconUrl>http://host:port/jira/images/icons/issuetypes/newfeature.png</iconUrl>
          <status>To Do</status>                 <issueType>New Feature</issueType>
          <statusUrl>http://host:port/jira/images/icons/statuses/open.png</statusUrl>                  <position>1</position>
          <priority>Major</priority>                  <status>To Do</status>
         <priorityUrl>http:                   <statusUrl>http://host:port/jira/images/icons/prioritiesstatuses/majoropen.png</priorityUrl>statusUrl>
                            <attributes><priority>Major</priority>
                            <priorityUrl>http://host:port/jira/images/icons/priorities/major.png</priorityUrl>
   <attribute>                         <attributes>
           <name>Custom - Hidden Job Switch</name>                 <attribute>
                   <value>false</value>                 <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

Word
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 Added


Contains the same information stated above.

Image Added

Tree folderContains no information.

Image Added


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 Added

Root folder or nothing selectedContains the name of the project.

Image Added


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

Image Added


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 Added


Contains the same information stated above.

Image Added

Tree folderContains no information.

Image Added


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

Image Added

Root folder or nothing selectedContains the name of the project.

Image Added


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

Image Added