CLOUD | DATA CENTER AND SERVER
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 |
| |
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:
| 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:
| 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 |
| |
|
| 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:
| 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. 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:
|
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.