Structure Plugin for JIRA - Version 2.4

Index

Child pages
  • Structure 2.4 Release Notes

This documentation relates to an older version 2.4 of the Structure Plugin for JIRA. View the current documentation home.

Skip to end of metadata
Go to start of metadata

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)

leaf

Get top-level issues and 2nd-level issues only

root or child of root

Retrieve all Epics in a certain status and all of their sub-issues

issue or ancestor in [type = Epic and status = Open]

Find a closed issue that has an open sub-issue at any level

[status = Closed] and descendant in [status = Open]

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

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

Upgrade procedure is simple:

  1. Create backup of Structure data. Use Administration | Structure | Structure Backup. See Backing Up Structure for details.
  2. 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.

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