Message-ID: <510832762.13464.1711655086127.JavaMail.appbox@confluence> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_13463_1283686064.1711655086127" ------=_Part_13463_1283686064.1711655086127 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html Structure 1.3 Release Notes

Structure 1.3 Release Notes

=20

24 October 2011

=20

Structure 1.3 introduces the Structure API for integration with other pl= ugins, and contains important performance improvements a number of minor up= dates.

=20

Download the Latest Version
Structure on Plugin Exchange

=20

1. Version Highlights

=20 =20

Important Upgrade Notes

Structure Backup is strongly recommended before the upgrade.

=20

Also, after upgrade you may need to re-create GreenHopper synchronizer c= onfigurations (if using GreenHopper 5.8 or later) and revisit Sub-tasks syn= chronizer configurations - please read below.

=20

2. Changes in Detail

=20

= 2.1. Structure API

=20

Structure API is the biggest thing that we've worked on since version 0.= 4, and as of Structure version 1.3 (API versions 1.0.0 and 2.0.0), it's a b= ig window into the the structure data that lets other JIRA plugins and remo= te applications integrate with structure, read or update hierarchical issue= lists and extend Structure functionality.

=20

If you are a developer, take a look at our Structure Developer's Guide.

=20

2.2. Performance Improvements

=20

We're constantly improving performance of our plugin, which is especiall= y important if you have lots of issues in a single structure. In this versi= on, we've made three different performance improvements which can lower dow= n the load time of a large structure three to ten times, depending on the c= ircumstances.

=20

2.3. Support for GreenHopper 5.8

=20

GreenHopper 5.8 and 5.8.1, released last week, replaced the old Rank fie= ld with new Global Rank field. Now the Global Rank in GreenHopper allows to= prioritize issues across multiple projects on the Rapid Board.

=20

Updated version of the GreenHopper synchronizer in Structure 1.3 support= s the new Global Rank too, allowing you to select multiple projects in conf= iguration.

=20

Documentation: JIRA Agile (GreenHopper) Synchronizer

=20

2.4. Sub-tasks Synchronizer Changes

=20

Sub-tasks synchronizer logic has been made less confusing. Now when the = synchronizer "sees" a sub-task at a wrong position in the structure, it wil= l move it to the right position under its parent task. (The synchronizer us= ed to move a sub-task only if it wasn't in the structure or was at the top = level, but not under another parent issue.)

=20

Documentation: = Sub-Tasks Synchronizer

=20

2.5. Other Improvements and Notable Bugs Fix= ed

=20 =20

3. Supported JIRA Versions

=20

This version of Structure supports JIRA 4.2 =E2=80=94 4.4.x. Note that t= here are separate downloadable files for JIRA 4.4.x, 4.3.x and 4.2.x.

= =20

= 4. Installation

=20

The plugin may be installed from the Plugin Exchange or = from the Administration | Plugins menu. Further informatio= n is available in the Administrator's Guide.

=20

5. Upgrading from a Previous Version

=20

Migrating to version 1.3 from an earlier version involves automatic upgr= ade of the underlying database data, so it's a good idea to make database b= ackup. If you decide to downgrade back to 1.2 after upgrade, you'll need to= clear the database and restore from backup because 1.2 will likely not be = able to work with the upgraded database.

=20
    =20
  1. Create Structure= database backup
  2. =20
  3. Upgrade the plugin from UPM or manually
  4. =20
  5. When the plugin has been upgraded, verify the basic functionality works= . You may need to fully refresh you browser page with Ctrl+Reload or Alt+Re= load.
  6. =20
  7. Open Manage Structure page and go over structures that= have the following synchronizers installed:=20
      =20
    1. GreenHopper synchronizer: only important if you have upgraded to GreenH= opper 5.8. Check if you see Rank Field: ? in the synchronizer = configuration =E2=80=93 this synchronizer should be deleted and installed a= gain, because GreenHopper has changed the Ranking field.
    2. =20
    3. SubTasks synchronizer: make sure you're ok with the change in the synch= ronizer logic explained above (always forcing sub-tasks to be under their p= arent). If not, disable the synchronizer and run Resync manually when neede= d.
    4. =20
  8. =20
=20

6. Detailed Change List

=20

Our public JIRA contains the full list of issues resolved in Structure versio= n 1.3.

------=_Part_13463_1283686064.1711655086127--