Welcome to the Structure 3 Quick Start Guide! We kept this guide as brief as possible while covering all the major features the plugin has to offer. It will only take a few minutes to read, and we're sure it will be useful both for the seasoned Structure pros and for new users!
To make new features easier to find, we've marked them with the icon. We've also added links to relevant articles from the previous version documentation.
You can quickly switch between structures in both main and secondary panels by clicking the structure name and selecting the structure you want to see. If your structure is not among the recent structures, start typing the structure name and the list of suggested structures will be updated to match your input. |
When you have two panels open side by side, you can hide from the right panel the issues that are present in the left panel by clicking the hide button in right side of the panel toolbar next to the view selector. |
Apart from adding existing issues into your structure you can also create new ones right there.
You can quickly see the full issue information in the Issue Details panel, which opens once you click the issue summary or issue key. If you don't want to open the panel, you can select another behaviour: either go to the standard JIRA Issue Details page or do nothing. You can change this setting by clicking the drop-down button next to the Layout control in the top right corner. |
You can edit issues right in the structure. Add the columns for the fields you want to edit and double-click the value you want to modify to switch to the editing mode. You can also edit issues in the Issue Details panel.
Structure offers several very useful custom columns:
Once you've added all the columns you need, you can save them as a custom view. To do that, click the name of the currently selected view (in the right corner above the structure grid) and click the Save As link.
While the ability to organize issues manually is already valuable in many situations, the true power of Structure lies in its automation functionality. Using the new features you can quickly create dynamic structures and easily segment and break down your issues based on various criteria.
The automation works through special Generators - a set of functions that manipulate issues in a certain way.
Insert. Insert Generators allow you to add the results of a JQL or text query to the structure and keep them up-to-date. If some issue is updated and no longer satisfies the query, it's not shown anymore. Apart from the query results, you can add entire structures into other structures or add epics and stories from selected Agile boards.
Filter. If you want to remove some of the issues after you've built the structure (for example, remove all closed issues), you can use the Filter Generator and specify the query that describes the issues that you want to keep - the rest will be removed from the strucutre.
Sort. To arrange your issues in a certain order you can use the Sort Generator. You can sort by pretty much any field, but note that there are two Sort Generators with different behaviour:
Rank. If you use JIRA Agile and add sorting by Rank, Structure can update the Rank as a user moves issues up and down inside the Structure.
Manual. If you are working with a structure where issues were added by the Insert Generator based on some JQL query, by default you will not be able to re-order issues in such a structure. To be able to do that, you need to add the Manual Sorting Generator.
Group. With this function you can break a list of issues into groups based on your JIRA fields. Groups can be nested. For example you can take a list of issues and group them by fixVersion and then by Assignee. Thus you will see the existing fixVersions on the top level, Assignees on the second and then the issues themselves on the third, grouped accordingly. If you enable editing via Structure in the generator settings, Structure can update the fields by which the issues are grouped when you drag-and-drop issues from one group to another.
Extend. Using the extend functions you can pull in issues related to those that are already in the structure. You can extend with sub-issues, JIRA links and Epic links (if you are using JIRA Agile). As with other generators, you can enable editing via Structure and the links will be updated as you move issues in your structure.
To configure generators you need to switch to the Automation Editing mode. To do that click the Automation (magic wand) button in the toolbar.
The special root item showing the structure name will be displayed at the top of the structure. Select this item and then click the Plus next to the Automation button and select the kind of the generator you'd like to add.
As you add more generators, they are re-ordered automatically based on their type. In some cases you can manually reorder generators. For example, you if you have two groupers, you can change their order to change by which field the issues should be grouped first. The same can be done with sorters.
If you want the generator to be applied to the whole structure, make sure you set focus on the root item before adding this generator. |
You cannot add generators under issues that were added to the structure by some other generators (for example, inserter or extender results). |
Once you are done with the configuration, click the Automation button to hide the details.
When you use the Group, Extend or Sort by Rank generators, by default the structure will be able to update some JIRA data as you move issues in the structure. For the grouper it will update the field by which you group as you move an issue between the groups. For the extender it will update the JIRA or Epic links as you move a child from one parent to another. For the sorter by rank it will update the Agile Rank as you move an issue up or down. If you want to disable this, deselect the Allow changes via Structure checkbox in the generator settings. |
Structure generators allow you to build a structure that you can share with other users. Sometimes you will need to adjust the way it's organized for your personal needs, but you won't want to modify the structure for everyone else. For example, you might only want to see issues assigned to you, ordered by a certain field, and the issues which are linked to them. You can do this with the help of Transformations.
The simplest transformation is Sorting. Click the column header to sort issues by the column field in descending order, click again to sort in ascending and click the Summary column header to remove the sorting and return to the original structure order. |
Transformations function in a way similar to the generators, but are only applied locally without affecting the structure settings: