You are viewing documentation for Structure Server and Data Center version 5.5 and patch releases. For other versions, see Version Index or [Structure Cloud].
26th of March, 2019
Structure 5.3 adds possibility to group by fix version name and several improvements and fixes.
Download the latest version of Structure and its Extensions
Try It: Structure Sandbox Server (no installation required)
The new Version Name... Grouper allows you to group issues with the same version names across multiple projects.
You can group issues by the Affects Version, Fix Version or a version custom field (multiple or single).
It is now possible to hide the Quick Transformations panel (as could previously only be done with the Transformations panel), while continuing to use Quick Transformations in your structure. Just click the hide button:
When transformations are applied, but the panel is hidden, the Quick Transformations button is colored blue.
The Mark Manual Adjustments option is now selected by default, whenever manual adjustments are enabled for a structure.
Structure 5.3 and all extensions support Jira versions 7.6 or later. All editions of Jira (Jira Core, Jira Software, Jira Service Desk) are supported. Jira Data Center is supported.
With respect to other add-ons and custom integrations, this release is backwards-compatible with Structure 3.4–5.2. Structure.Testy extension, Colors, Structure.Pages, Structure.Gantt and integrations with third-party apps should continue working normally.
If your Jira server does not have Structure yet, the installation is simple:
catalina.out
or jira-application.log
for log messages from Structure.If you're upgrading from version 2.11.2 or earlier, please read Structure 3.0.0 Release Notes.
The upgrade procedure from versions 3.x–5.2 is simple:
Install the new version of the plugin.
catalina.out
or jira-application.log
for warnings or errors.We strongly recommend that you back up your data before upgrading. The introduction of manual adjustments required changes to our backup file format, which makes previous versions of Structure unable to restore data from backup files created by Structure 5.0 and later. For more information, see Backup Format Version Change.
Structure 5.3 contains several changes to its core components that could be important for large installations and Jira Data Center instances.
The newly-introduced Version Name item type is special because its core attributes, like summary and icon, depend not on the Version Name item itself, but on the issues below it. In order to support that, we had to change how those attributes are loaded for all item types, not only Version Names.
Previous versions of Structure could show custom field values for fields that are no longer available for the project and type of the issue. Those values could also be used by generators, even though Jira itself wouldn't show or let you edit them. Starting with Structure 5.3, we check the scope of custom fields when generating structures and loading issue attributes. We use the Lucene index when possible to speed up these checks.
Given the changes described above, if you have large, multi-level structures (10,000 issues or more), we advise that you test their performance on a staging system before upgrading. You can try the following scenarios:
Watch the log files for errors and warnings while running these experiments.
The usual load and stress testing can also be performed.
Should you have any questions on Enterprise Deployment, let us know at support@almworks.com.