Project Tree View

Project Tree View

Overview

The Project Tree View is located on the left side of the easeRequirements view and is always visible. Requirements can be displayed on the right side of the easeRequirements view in different formats:

To reach the Project Tree View:

  • DATA CENTER Select a project from the Requirements menu in the Jira navigation bar.

  • CLOUD From the Jira side bar select Your apps > easeRequirements. Then from the easeRequirements sidebar select a project from the dropdown menu. Then select Tree from the easeRequirements navigation bar.

The requirements of a given project can only appear once in the project’s 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 handled 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.

CLOUD Folders are Jira issues of a distinguished type that is specified by the Jira administrator. (See Folder Issue Type.) The items in a folder are treated as child requirements of the folder.

DATA CENTER Folders are stored in the database as a distinct entity type, independent of Jira issue types.

DATA CENTER It is possible that not all issues are visible in the project tree - see option Maximal visible sub-items in tree.

Tree Sidebar Options

The project tree sidebar appears above the project tree and provides options that apply to the entire tree:

Refresh tree

Refreshes the content of the project tree from the server.

Filter tree

 

Hides the items in the project tree that do not match the query criteria. See Filtering and searching the project tree.

CLOUD Search in tree

Highlights the items in the project tree that match the query criteria. See Filtering and searching the project tree.

Configure tree

Opens the Tree View Display Fields dialog. See Display Fields Configuration. When enabled, the last viewed folder or issue is shown when the project is reopened.

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

Purpose

Action

Comment

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/Add > Create folder

CLOUD Opens the Jira Create Issue dialog with the Folder issue type preselected. Select Create to create the new folder.

DATA CENTER Opens the Create Folder dialog. Select Create to create the new folder below the selected one. 

The names of folders within one parent folder must be unique.

Create/Add > Create baseline

Opens the Create Baseline dialog. Enter a name and an optional description for the new baseline and select Create to create a new baseline for the folder. 

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

Create/Add > Add existing issues

See Adding Existing Issues.

 

Create/Add > Add page

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

CLOUD This operation is only available if the easeConnect app is installed in Confluence. For more information, please refer to easeConnect - Connector of easeRequirements for Confluence.

DATA CENTER This operation is only available if the Confluence Integration is enabled.

ULTIMATE Create/Add > Create review

Opens the Jira Create Issue dialog, allowing you to create a new Review issue, which is used to conduct a review for the issues under the selected project. See Review Cockpit.

This operation is only available if a Review Scheme is associated with the selected project.

ULTIMATE Create/Add > Add coverage

Opens a dialog allowing you to select a public coverage view to add under the selected folder as a read-only report. See Coverage and Traceability Reports in Project Tree.

 

ULTIMATE Create/Add > Add tracematrix

Opens a dialog allowing you to select a public traceability view to add under the selected folder as a read-only report. See Coverage and Traceability Reports in Project Tree.

 

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 query with the easeRequirements JQL function requirementsPath.

 

DATA CENTER Export/Import > Export default Word

Exports the selected folder using the default Word template.

 

DATA CENTER Export/Import > Export default Excel

Exports the selected folder using the default Excel template.

 

Export/Import > Export Template

Opens the Export template dialog. Select the custom Word or Excel template to export the selected folder.

 

DATA CENTER Export/Import > Export XML

Exports the selected folder using the default XSLT (Extensible Stylesheet Language Transformations).

 

DATA CENTER ULTIMATE Export/Import > Export ReqIF

Opens the Export ReqIF dialog. Select the ReqIF Field Mapping to be used to generate the ReqIF file. See Export and Import using ReqIF.

 

DATA CENTER ULTIMATE Export/Import > Import ReqIF

Opens the Import ReqIF dialog. Select the ReqIF Field Mapping to be used to import the ReqIF file. See Export and Import using ReqIF.

 

Cut

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

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

Copy

Stages one or more folders or requirements for copying in the same project or in 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 project, the operation simply moves items within the project tree (which can also be accomplished using drag and drop). When performed between different projects, the cut items are removed from the source project and placed in the target project. If one or more issues already exist in the target project, the issues are automatically moved to the new location.

  • Copy and paste: The Reuse Issues dialog is displayed, where options for copying the items are presented. See Requirements Reuse.

DATA CENTER This operation is disabled while the tree is still loading.

DATA CENTER Delete

CLOUD Remove

DATA CENTER Opens the Delete Folder dialog.

CLOUD Opens the Remove Item dialog.

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

DATA CENTER More > Get URL

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

 

DATA CENTER More > Sort issues

Opens the sort issues dialog for the selected issue. Select the the sort order and the issue field to sort 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.

More > Collapse all

Collapses the selected folder and all subfolders.

CLOUD This option is directly in the top-level of the context menu for the root folder, not under the More submenu.

 

More > Expand All

Expands the selected folder and all subfolders.

CLOUD This option is directly in the top-level of the context menu for the root folder, not under the More submenu.

DATA CENTER The number of levels that can be expanded at one time is configurable - see Configuration.

DATA CENTER More > Properties

Opens the Edit Folder dialog, where the Name, Description, Attachments and Watchers of the folder can be modified. Watchers are users that receive notifications of changes to the folder content. The statistics section of the dialog shows the number of issues in a folder as well as other statistics.

The name of the root folder cannot be changed and the description can only be changed in the Project Settings.

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.

CLOUD More > Edit

Opens the Jira Edit issue dialog.

Edit is not available for the root folder. Its properties can only be changed via the project settings.

Issue and page operations

Availability

 

 

Issues

Pages

Purpose

Action

Comment

 

Create child issue

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

 

CLOUD Create baseline

Opens the Create Baseline dialog. Enter a name and an optional description for the new baseline and select Create to create a new baseline for the selected issues.

If only one issue is selected, the option is under the submenu Create/Add.

Create/Add > Create linked issue

Opens the Create Linked Issue dialog. 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. Select Create to open 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.

The following additional options are available for the new issue:

  • as child: Add the linked issue as a child of the selected issue.

  • as sibling: Add the linked issue at the same level as the selected issue in the last position.

  • not to the tree. The linked issue will not be added to the tree and will only be available in Jira

ULTIMATE Issue link types may be restricted if there is a Data Model active for selected project.

 

Create/Add > Add link

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

ULTIMATE Issue link types may be restricted if there is a Data Model active for selected project.

Create/Add > Add existing issues

See Adding Existing Issues.

 

DATA CENTER Export/Import > Export default Word

Exports the selected issues or pages using the default Word template.

 

DATA CENTER Export/Import > Export default Excel

Exports the selected issue or page using the default Excel template.

 

Export/Import > Export Template

Opens the Export template dialog. Select the custom Word or Excel template to export the selected issues or pages.

If multiple issues are selected, the option is not under the submenu Export/Import.

DATA CENTER Export/Import > Export XML

Exports the selected issue or page using the default XSLT (Extensible Stylesheet Language Transformations).

 

DATA CENTER ULTIMATE Export/Import > Export ReqIF

Opens the Export ReqIF dialog. Select the ReqIF Field Mapping to be used to generate the ReqIF file. See Export and Import using ReqIF.

 

Cut

Stages one or more issues or pages for pasting within the same project.

 

Copy

Stages one or more issues for copying in the same project or in 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 issues 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 Requirements Reuse.

DATA CENTER This operation is disabled while the tree is still loading.

Remove

Opens the remove issue/page dialog.

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

DATA CENTER More > Get URL

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

Only available if a single issue is selected.

DATA CENTER More > Sort issues

Opens the sort issues dialog for the selected issue. Select the the sort order and the issue field to sort by (issue key, creation date, issue summary, issue type or priority). Select Sort to perform the operation.

Only available if a single issue with children is selected.

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

More > Collapse all

Collapses the selected issue and all child issues.

Only available if a single issue with children is selected.

More > Expand All

Expands the selected issue and its child issues.

Only available if a single issue with children is selected.

Jira administrators can configure number of levels that can be expanded at a time.

 

CLOUD More > Compare issue

Opens the Issue Comparison dialog for the selected issue.

 

 

More > Edit issue

Bulk Edit

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

 

Open in Confluence

Opens the linked page in Confluence.

 

Adding Existing Issues

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

  • Add all issues from this project not added to the tree: Add all issues in the project that are not already in the tree.

  • Add issues from filter (Jira Filter or JQL): Add issues matching the given filter or JQL query.

  • Search for issues: Allow selecting recently viewed issues.

  • DATA CENTER Move issues within own project tree: Add 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.

The results of a filter or query are displayed in the dialog according to the following categories:

  • Selected issues

  • Issues already in tree

  • New issues

DATA CENTER The displayed count of issues is a hyperlink that can be used to open them in the Jira Navigator.

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

CLOUD Select the option Create Link to create links of the given Link Type from the issue selected in the project tree to the added issues.

Due to the fact that an issue may only appear once in a project’s tree, any issues that are already in the tree (i.e. 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.

Drag and Drop Operations

This operation is disabled while the tree is still loading.

The following drag and drop operations in the project tree:

  • Change folder positions.

  • Change the folder hierarchy.

  • Change the position of requirements, pages, and folders.

  • Move requirements, pages, and folders around the hierarchy.

  • Create and remove child requirements.

  • Change the order of child requirements.

  • Move child requirements around the hierarchy.

Filtering and searching the project tree

Filtering: To filter the issues in the project tree, select the Filter button in the project tree sidebar.

  • DATA CENTER This opens a dialog in which you specify the criteria for a query used to hide items that do not meet the criteria.

  • CLOUD A simple textual query can be entered directly or you can select Advanced Search to specify the criteria for a query used to hide items that do not meet the criteria.

CLOUD Searching: To search for issues in the project tree, select the Search button in the project tree sidebar. A simple textual query can be entered directly or you can select Advanced Search to specify the criteria for a query used to highlight items that meet the criteria.

After configuring the query, select Filter or Search to apply it. 

  • DATA CENTER The results of filtering are initially collapsed to retrieve content faster. Expand the folders and issues to view all of the results.

  • DATA CENTER If the last item selected before filtering is included in the results, it will still be selected. If there is only one item matching the filter, it will automatically be selected.

The following video explains this behavior: Requirements Management for Jira: Collapsed Tree with Filtered Results.

To undo the filter, select Clear in the Filter or Search dialog.

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

Query Options

Basic

Form a query based on your selected Project, Type, Status, and Assignee values. Select "More" to add other fields to the query.
The following video explains this option in more detail: Requirements Management for Jira: More flexibility in search options.

Text search is also possible by entering a term in the field marked “Contains text”. The constructions for textual search available in JQL may be used here - see Search syntax for text fields.

DATA CENTER The current project is selected by default.

DATA CENTER The query specified here is repeated in the Advanced option as JQL after you execute the search.

Filter

Select a predefined Jira filter.

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“. → yes.

Advanced

Specify the desired query in JQL.

DATA CENTER The query is pre-filled with the current project by default.

DATA CENTER Folder

Base the query on a textual search of the summary and description of folders using a given term. The following types of search are supported:

  • exact word or phrase search: For example, “Component Requirements” matches folders containing that term in the summary or description. The match is case-insensitive.

  • wildcard suffix search: For example, “Comp*” matches folders whose summary or description starting with those letters. The match is case-insensitive. Note: The wildcard “*” can only be placed at the end of the search term, not at the beginning or within the term.

DATA CENTER Quick Filters

In the query options Filter and Advanced, any quick filters defined by project administrators are displayed. They can be used instead of, or in addition to, the Basic, Filter, and Advanced filters in the tree view. If you don’t see the desired quick filters in the dialog, request your project administrator to create some.

Select one or multiple quick filters to combine in your search.

Each filter selected is combined with an “AND“ operator.

DATA CENTER Export

To export one or more requirements, select a requirement or folder and select an option from the Export dropdown in the main easeRequirements menu bar - see Export generation.

DATA CENTER Keyboard Shortcuts

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

  • e: Edit an issue.

ULTIMATE Quick Linking

Drag an issue key hyperlink from the detail, tabular, or reading view to an issue in the tree to open the “Add Link“ dialog. See Quick Linking.