Separate Structure Widget
Structure Board is a full-screen view with the Structure Widget, available from the top navigation menu in JIRA.
Structure Board is opened with one or more parameters, telling the plugin which issues to show. You don't need to manually specify the parameters (although you can, by manually typing them in the URL), usually you use "Open in Structure" or "Add to Structure" actions explained below.
Once you've opened some issues in the Structure Board, you can use the Struture Widget as you do on any other struture-enabled page. The parameters that were used to open the Structure Board are remembered in the browser cookie, and you can later open one of the recently used Structure Board configurations:
When you start using the plugin, the drop-down menu under Structure tab will only show "Empty board", which will open an empty Structure Board. It's not of much use as of version 0.1, but we later will add the possibility to add issues to the structure board right from the Structure Widget, so starting with a blank board will be a valid move.
Opening Issues in Structure Board
Two new actions are added to the list of issue actions: Open Structure and Add to Structure:
Open Structure |
Opens Structure Board that shows this issue and all its relatives. |
Add to Structure |
Opens the last used configuration and adds the viewed issue there. |
For example, let's say MARS-1 and MARS-2 are standalone issues (not participating in any structure yet). You'd like to make MARS-2 a subissue of MARS-1.
- Open issue MARS-1, click on Open Structure: structure board opens with MARS-1 issue.
- Open issue MARS-2, click on Add to Structure: structure board opens with both MARS-1 and MARS-2.
- Use the structure widget to place MARS-2 under MARS-1.
Opening Search Results in Structure Board
Two special links are added to the Issue Navigator search results page. And they are quite similar to the issue actions: Open Results in Structure and Add Results to Structure.
Open Results in Structure |
Opens Structure Board that shows all the issues from the search result, along with their relative issues. |
Add Results to Structure |
Opens the last used configuration and adds all the issues from the search result (and their relative issues too). |
Let's say both MARS-1 and MARS-2 are Blocker issues, you need to make MARS-2 to be a sub-issue of MARS-1. Then you realize that issues with priority Critical should also be added to the structure.
- Search for priority=Blocker in the issue navigator, then click Open Results in Structure: structure board opens with MARS-1 and MARS-2 issues.
- Make MARS-2 to be a sub-issue of MARS-1
- Search for priority=Critical in the issue navigator, then click Add Results to Structure: structure board opens with MARS-1, MARS-2 and all the critical issues.