Document toolboxDocument toolbox

This article is for Data Center. Visit Cloud

Structure 6.5 Release Notes

1st of February, 2021

Structure 6.5 adds Perspective link sharing, Advanced Roadmaps Team Effector and more

Download the latest version of Structure and its Extensions

Try It: Structure Sandbox Server (no installation required)

Version Highlights

Structure 6.5 adds:

  • Perspective sharing via email
  • Advanced Roadmaps (Portfolio) Team Effector
  • Additional improvements and fixes

Changes in Detail

Perspective sharing via email

Let other users view structures with the same information you see, by sending perspective links directly to their email.

Share a perspective via email

Documentation: Sharing a Perspective

Advanced Roadmaps (Portfolio) Team Effector

It is now possible to update the Team field from Advanced Roadmaps using the Attribute to Issue Field Effector.

Additional Updates

  • When exporting a structure with horizontal scrolling enabled, the pinned column order can now be maintained with the export.
  • The Sort generator icon now indications whether the sort is in ascending or descending order.
  • Fixed: Could not group by Tempo 11 attributes using the Text Attribute grouper.
  • Fixed: Text color for disabled options in Structure global permissions was too light to read.
  • Fixed: Dates in the Work Logged column displayed incorrectly when a user's time zone was different from the system time zone.
  • Fixed: Loop markers created by synchronizers can be stored in DB after deleting the tasks they are pointed at.
  • Additional performance improvements.

Supported Versions

Structure 6.5 and all extensions support Jira versions 8.5 or later. This release is for customers using Jira Server or Data Center (Jira Core, Jira Software, or Jira Service Management/Service Desk).

Compatible plugins versions:

Cloud customers can learn more about our products on the “Cloud” tab of our marketplace listing.

Installation and Upgrade

Pick a Time

We strongly recommend that you install and upgrade your apps during off-peak hours or scheduled maintenance windows. There are known issues in the Jira plugin infrastructure that may cause performance degradation and impede app installation when your Jira instance is under heavy load.

Installing Structure

If your Jira server does not have Structure yet, the installation is simple:

  1. Download and install Structure app, either from the Atlassian Marketplace or our Download page.
  2. When Add-on Manager reports the successful installation, click Get Started to visit a page with important guidance for the Jira administrator. You may want to also check out the user's Get Started page, available under the "Structure" top-level menu.
  3. Monitor catalina.out or jira-application.log for log messages from Structure.

Upgrading Structure

The upgrade procedure from versions 3.0–6.4 is simple:

  1. Consider backing up Jira data. Use Administration | System | Backup System. (If you have a large instance and a proper backup strategy in place, you may skip this step.)
  2. Back up Structure data. Use Administration | Structure | Backup Structure menu item. If you have a lot of structures and a large Jira, consider turning off the "Backup History" option to avoid a long backup process.
  3. Install the new version of the plugin.

  4. Monitor catalina.out or jira-application.log for warnings or errors.

Upgrading from Structure 2.9–2.11

If you have a Structure version older than 2.9, please upgrade to Structure 2.11.2 version first.

Starting with version 6.0, Structure is no longer able to access the old Structure 2.x database, but old backup files are still supported. Therefore, you'll need to back up your Structure 2.x data before upgrading. The recommended upgrade procedure is as follows:

  1. While still running the old version of Structure, go to Administration | Structure | Structure Backup and create a backup of the current Structure data.
  2. Download and install Structure 6.5, either from the Atlassian Marketplace or our Download page.
  3. When the Add-on Manager reports the successful installation, click Get Started to visit a page with important guidance for the Jira administrator. You may want to also check out the Getting Started with Structure.
  4. To transfer your data, go to Administration | Structure | Restore Structure and use the Structure 2.x backup made earlier.

  5. Monitor catalina.out or jira-application.log for log messages from Structure.

Enterprise Deployment Notes

Additional Attributes subsystem permission checks

We have added additional permission checks for attribute calculation in structures that use substructures. If you have such structures with aggregate attributes (columns), please check to see that attribute values still load quickly.

Testing on Staging Environment

Apart from the changes and suggestions above, there are no particular special areas of interest for load testing and stress testing Structure 6.5. We advise running the same testing procedures as you've done for previous upgrades.

Unable to render {include} The included page could not be found.