Project Tree View

The Project Tree

The Project Tree is reached by selecting a project from the Requirements section in the main navigation bar. The tree is located on the left side of the view and is always visible. Selecting a requirement in the project tree opens the Detail View for the requirement on the right side by default. Selecting a folder in the project tree opens the Reading View on the right side by default. Depending on preference, the view may be switched between the Detail View, Reading View, or Tabular View for both issues and folders. The last selected view for a folder and issue will be retained.

The requirements of a given project can only appear once in its tree. However, since requirements in one project may be reused in other projects, they may appear in multiple project trees.

Requirements may be included in other requirements as child requirements. Child requirements are manipulated in exactly the same ways as other requirements and may be indefinitely nested.

Jira subtasks are not automatically displayed as children of their parent issues in the project tree. If this is desired, they can be added as child requirements of their respective parents.

If not all issues are visible in the tree, your Jira administrator may have configured a Maximal visible sub-items in tree.

Context Menu Operations

The project tree consists of folders, issues and references to pages in Confluence. To access the context menu, right-click on any item in the tree. Each type of item has its own set of context menu entries for performing appropriate operations, as indicated in the following tables.

Folder operations

Availability



Root Folder

Other Folders

Create issue

Opens the Jira Create Issue dialog. Select Create to create the new requirement or issue and add it to the selected folder.

Create folder

Opens the create folder dialog, where you enter a name and a description for the new folder. The names of folders within one parent folder must be unique. Select Create to create the new folder below the selected one. 

Create baseline

Opens the create baseline dialog, which allows you to enter a name and an optional description for the new baseline. Select Create to create a new baseline for the folder. 

Add existing issues

Opens the Add Existing Issues dialog, where the following possibilities are available:

  • The first option (Add all issues) adds all issues in the project that are not already in the tree.

  • The second option (Add issues from filter) adds issues matching the provided filter or JQL query.

  • The third option (Search for issues) allows selecting recently viewed issues.

  • The fourth option (Move issues) adds issues matching the provided filter or JQL query, regardless whether they are already in the tree or not. Issues that match the filter that are are already present in the tree will be moved to the new location.

Select the option Run scheduled to enable automatic import based on the selected source.

Due to the fact that issues may only appear once in a project’s tree, any issues that are already in the tree (in some other folder), are ignored, even if they match a filter or are manually selected to be added to a given folder.

Only filters shared with the requirements project, or in the categories “My“, “Favorite“ or “Popular“, may be used when selecting a filter.

Issues can only be added from activated projects.

Sort issues

Opens the sort issues dialog, where you choose the issue field to sort by, as well as the sort order. Issues can be sorted by issue key, creation date, issue summary, issue type or priority. Select Sort to perform the operation.

This operation is disabled while the tree is still loading. Only issues directly contained in the selected folder are sorted. The sort order of Issues in subfolders as well as any child requirements is not affected.  

Add page

Opens the add Confluence page dialog, allowing you to search for existing pages in any linked Confluence instance.

This operation is only available if Confluence Integration is enabled.

Get URL

Creates a URL for the selected folder or requirement. Opening the URL in a browser displays the project tree with the folder or requirement preselected. 

Refresh folder

Refreshes the folder's content and fetches any updates from the server.

Show in issue navigator

Opens the Jira issue navigator in a new browser tab or window. All issues contained in the selected folder and its subfolders are displayed by applying a search query using the JQL function requirementsPath, provided by R4J.

Expand

Expands the selected folder and all subfolders.
Jira administrators can configure number of levels that can be expanded at a time.

Collapse all

Collapses the selected folder and all subfolders.

Cut

Stages one or more folders or requirements for pasting within the same project or to a different project.

Copy

Stages one or more folders or requirements for copying within the same project or to a different project.

If a filter is applied to the tree, only issues that satisfy the filter are included in the staged items.

Paste

Pastes staged items to the selected folder, as follows:

  • cut and paste: The items are moved to the new location. When performed within the same projects, the operation simply moves items within the project tree and can also be accomplished using drag and drop. When performed between different projects, the cut items are removed from the source project and moved to the target project. If one or more issues already exist in the target project, the issues are automatically moved the new location.

  • copy and paste: The Reuse Issues dialog is displayed, where options for copying the items are presented. See https://easesolutions.atlassian.net/wiki/spaces/REQ4J/pages/2244804629.

This operation is disabled while the tree is still loading.

Properties

Opens the edit folder dialog. Folders are just a special type of Jira issue, made available by R4J, and their fields are edited in the same way as for other types of issues (except that the name of the root folder cannot be changed). R4J enhances the edit dialog with a statistics section showing, for example, the number of issues in a folder.

You can add an image to a folder by attaching it to the folder. To make it visible in the Reading View , add a link to the image in the description. Note that R4J only allows images to be attached to folders, not other types of files.

Delete

Opens the delete folder dialog.

Removing folders from the tree removes all its subfolders and requirements recursively. They are not deleted in Jira and can be added again to the tree.

Issue and page operations

Availability



Issues

Pages

 

Edit issue

If the selection contains one issue the Jira Edit Issue dialog opens. If the selection contains multiple issues the Jira Bulk Edit dialog opens.

 

Create child issue

Opens the Jira Create Issue dialog. Select Create to create the new requirement or issue and add it as child of the selected requirement.

Create linked issue

Opens the Create Linked Issue dialog, which allows you to specify the the outgoing link type, as well as project in which the new issue should be created and the issue type of the new issue. Selecting Create opens the Jira Create Issue dialog, prefilled with the information entered in the dialog. Select Create to create a new issue of the chosen type in the chosen project, linked to the new issue with the chosen link type.

Add existing issues

Opens the Add Existing Issues dialog, where the following possibilities are available:

  • The first option (Add all issues) adds all issues in the project that are not already in the tree.

  • The second option (Add issues from filter) adds issues matching the provided filter or JQL query.

  • The third option (Search for issues) allows selecting recently viewed issues.

  • The fourth option (Move issues) adds issues matching the provided filter or JQL query, regardless whether they are already in the tree or not. Issues that match the filter that are are already present in the tree will be moved to the new location.

Select the option Run scheduled to enable automatic import based on the selected source.

Due to the fact that issues may only appear once in a project’s tree, any issues that are already in the tree (in some other folder), are ignored, even if they match a filter or are manually selected to be added to a given folder.

Only filters shared with the requirements project, or in the categories “My“, “Favorite“ or “Popular“, may be used when selecting a filter.

 

Add link

Opens the Add Link dialog, allowing you to add a Jira issue, Confluence page, or Web link for the issue selected.

Sort issues

Opens the sort issues dialog, where you choose the issue field to sort by, as well as the sort order. Issues can be sorted by issue key, creation date, issue summary, issue type or priority. Select Sort to perform the operation.

This operation is disabled while the tree is still loading. Only issues directly contained in the selected issue are sorted.  

Get URL

Creates a URL for the selected folder or requirement. Opening the URL in a browser displays the project tree with the folder or requirement preselected. 

Open in Confluence

Opens the linked page in Confluence.

Cut

Stages one or more folders or requirements for pasting within the same project.

Copy

Stages one or more folders or requirements for copying within the same project or to a different project.

If a filter is applied to the tree, only issues that satisfy the filter are included in the staged items.

Paste

Pastes staged items to the selected folder, as follows:

  • cut and paste: The items are moved to the new location. Paste is only available if the cut items are from the same project as the selected folder. The operation simply moves items within the project tree and can also be accomplished using drag and drop.

  • copy and paste: The Reuse Issues dialog is displayed, where options for copying the items are presented. See https://easesolutions.atlassian.net/wiki/spaces/REQ4J/pages/2244804629.

This operation is disabled while the tree is still loading.

Remove

Opens the remove issue/page dialog.

Removing issues from the tree will remove all its child issues recursively. Issues will not be deleted in Jira and can be added again to the tree.

Multiple select operations

Bulk Edit

Opens a new tab that redirects to the Jira Bulk Edit view.
Disabled when pages or folders are included in the selection.

Cut

Stages one or more folders or requirements for pasting within the same project.

Copy

Stages one or more folders or requirements for copying within the same project or to a different project.
Disabled when a page is included in the selection.

If a filter is applied to the tree, only issues that satisfy the filter are included in the staged items.

Remove

Opens the remove items dialog to confirm removing items from the tree.

  • Project folder cannot be removed even when included in the selection.

  • Removing folders from the tree will remove all its subfolders and issues recursively.

  • Removing issues from the tree will remove all its child issues recursively.

  • Issues will not be deleted in Jira and can be added again to the tree.

Drag and Drop Operations

This operation is disabled while the tree is still loading.

The project tree supports the following drag and drop operations:

  • Change folder positions

  • Change the folder hierarchy

  • Change the position of requirements

  • Move requirements between folders

  • Create and remove child requirements

  • Change the order of child requirements

  • Move child requirements around the hierarchy

Tree Filter

To filter the issues in the project tree, select the Filter button just above the detail view and the following options appear immediately below the query:

  • Basic: Use predefined Jira filters. (Only Managed Filters from the following categories can be selected in the Filter picker: Filters shared with current requirements project, as well as filters in “My“, “Favorite“ or “Popular“.)

  • Advanced: Directly enter the desired JQL to use as filter.

After setting the filter, select the Search icon to apply the filter to the tree. To undo the filter, select Clear.

The current filter is reflected in the browser's URL for convenient sharing.

Tree Settings

To access the project tree settings dialog, click on the Settings button on the top right of the view. The following options are available:

Auto numbering for tree folders

Toggle to add automatic numbering to folders in the tree and the reading view.

Show issue tooltips in tree

Toggle to show tooltips with issue information.

Remember tree selection

Toggle to show the last viewed folder or issue when loading a project tree.

The plugin version is also displayed in the Settings dialog.

Keyboard Shortcuts

  • Del: Opens the Remove Issue dialog for the item.

  • Shift + Del: Deletes an item without opening the Remove Issue dialog.

  • e: Edit an issue