14 June 2013
Structure 2.4 introduces S-JQL language for querying structures.
Download the Latest Version
Structure on the Atlassian Marketplace
1. Structured JQL
In this version, we're happy to introduce a long-awaited feature — Structured JQL (S-JQL) language for finding issues in structures that satisfy some structure-based conditions. Here are just a few examples:
Example |
S-JQL Expression |
---|---|
Select "leaf" issues (those that don't have sub-issues) |
|
Get top-level issues and 2nd-level issues only |
|
Retrieve all Epics in a certain status and all of their sub-issues |
|
Find a closed issue that has an open sub-issue at any level |
|
To use S-JQL expression in a normal JQL (for example, in the Issue Navigator), you need to use structure()
JQL function, for example:
issue in structure("Enterprise Portfolio", "issue or ancestor in [type = Epic and status = Open]")
There are a lot more examples in the S-JQL Cookbook.
Potential applications of the S-JQL queries:
- Configuring GreenHopper's Agile board based on a structure and specific issues from it.
- Using in JQL filters for selecting specific parts of work breakdown.
- Creating workflow conditions based on the position of the issue in structure.
- Using in synchronizers for limiting scope.
Documentation: Structured JQL
2. Other Changes
2.1. Notable Fixes
- Fixed: HJ-1184 Status rollup synchronizer does not correctly respond to Delete Issue action
- Fixed: HJ-1202 Send to Top / Send to Bottom don't work in Firefox
- Fixed: HJ-1338 Multiple problems with IE8-IE9 and JIRA 6
3. Supported JIRA Versions
Structure 2.4 supports JIRA versions 5.0.1 — 6.0+. There are two separate downloads: one for JIRA 5.x, another for JIRA 6.x.
JIRA 5.0 (not 5.0.1 or later) is not supported anymore. Structure 2.3.0.jira5 is the last Structure version that supports JIRA 5.0.
4. Installation
The plugin may be installed from the Atlassian Marketplace or from the Administration | Add-ons menu. Further information is available in the Administrator's Guide.
5. Upgrading from a Previous Version
- If you're upgrading from version 2.2.1 or earlier, please read Structure 2.3 Release Notes.
- If you're using GreenHopper 6.1 and the new epics functionality, and upgrading from version 2.0 or earlier, please read Structure 2.1 Release Notes.
- If you upgrade from version 1.7.1 or earlier, please read the upgrade section in Structure 2.0 Release Notes.
Upgrade procedure is simple:
- Create backup of Structure data. Use Administration | Structure | Structure Backup. See Backing Up Structure for details.
- Install the new version of the plugin.
Note for early adopters: if you have a pre-release version of Structure 2.3 installed, you need to uninstall it first, and only then install the released version. All structure data will be kept.
- Monitor
catalina.out
orjira-application.log
for warnings or errors.