Project Tree
- Bruno Marotta
- David Sedlock
Overview
To get to the project tree, select a project created in the organization in Azure DevOps, then go to the menu on the left and position the cursor on the Boards option, and click on Requirements. The tree is on the left side of the view, it can be extended or collapsed. Selecting a folder or a Work Item in the project tree opens the detailed view of the item on the right side.
Each work item of a project can only appear once in its tree. However, since WIs in one project may be reused in other projects, they may appear in multiple project trees. It is worth mentioning that the user will only be able to see WIs of projects to which he/she has permission.
- 1 Overview
- 2 Context menu operations
- 2.1 Requirements Tree Management
- 2.2 Create Item / Create Folder
- 2.3 Add existing
- 2.4 Edit
- 2.5 Remove
- 2.6 Baseline Management
- 2.7 Create Baseline
- 2.8 Requirements Reuse
- 2.9 Copy
- 2.10 Cut
- 2.11 Paste
- 2.12 Report
- 2.13 Open items in Queries
- 2.14 Export to Word
- 3 Expand and collapse
- 4 Drag and drop operations
- 5 Tree Filter and Search
Context menu operations
The project tree consists of the project folder and work items. 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 table.
Requirements Tree Management
Purpose | Action | Availability | ||
|---|---|---|---|---|
Root folder | Folders | Work Items | ||
Create Item / Create Folder | Opens the Azure dialog to create a new work item. Clicking on the save button will close the dialog, create the new item and add it to the tree on the selected position. | |||
Add existing | Allows to add an existing item to the tree on the selected position. To add an item just start typing its name in the edit box. The most relevant items will be displayed in the drop-down. You can add more than one item at once. To do it, type and select the first item. Then start typing again. Due to the fact that work items may only appear once in a project’s tree, any work item that is already in the tree won't appear in the search results. | |||
Edit | Opens Azure's edit dialog for the selected item in the tree. After changing and saving the work item, the changes are reflected in the tree and in the detail view. | |||
Remove | Allows to remove the selected item from the tree. Removing work items from the tree will remove all its children recursively. Work items will not be deleted from Azure DevOps and can be added again to the tree by selecting Add existing. | |||
Baseline Management
Purpose | Action | Availability | ||
|---|---|---|---|---|
Root folder | Folders | Work Items | ||
Create Baseline | Creates a new Baseline from the selected item by simply choosing this option. Once selected, you can assign a name and description to the Baseline. Upon completing the Baseline creation process, you will be automatically directed to the Baselines page. | |||
Requirements Reuse
Purpose | Action | Availability | ||
|---|---|---|---|---|
Root folder | Folders | Work Items | ||
Copy | Copies a reference to the selected tree items for pasting | |||
Cut | Copies a reference to the selected tree items and flag it to be removed after pasting. | |||
Paste | Paste the previously copied or cut items and all its children into the selected position within the tree. This option becomes available only after an item has been copied or cut. Upon selection, additional paste options may be offered. | |||
Report
Purpose | Action | Availability | ||
|---|---|---|---|---|
Root folder | Folders | Work Items | ||
Open items in Queries | Open the selected items and all its children in the Queries module. | |||
Export to Word | Export the selected items and all its children to a Microsoft Word document. Only the work items. | |||
Expand and collapse
Click on the arrows on the left side of the tree item icon to expand or collapse the hierarchy.
Expanding an item only expands items directly under it.
Collapsing an item closes all items under it recursively.
Drag and drop operations
The project tree supports the following drag-and-drop operations:
Change the position of requirements.
Create and remove child requirements.
Move child requirements to other parents.
Add Work Items to a folder.
Tree Filter and Search
easeRequirements offers two options to find interesting details in the tree: The search option highlights all matching Jira issues, and the filter options reduces the tree to the queried items.
To filter the issues enter the desired text in the input field above the project tree, select the Filter Tree icon above the tree. To search for relevant issues, select the Search in Tree icon next to it.