Structured JQLIn 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 | <ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="fd67372a-4089-434c-884b-2a5306b03cbd"><ac:plain-text-body><![CDATA[ | Retrieve all Epics in a certain status and all of their sub-issues | issue or ancestor in [type = Epic and status = Open] | ]]></ac:plain-text-body></ac:structured-macro> | <ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="237b0116-fbc2-4e2a-9fd0-efbb44c23a51"><ac:plain-text-body><![CDATA[ | Find a closed issue that has an open sub-issue at any level | [status = Closed] and descendant in [status = Open] | ]]></ac:plain-text-body></ac:structured-macro> |
Tip |
---|
Wiki Markup | 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 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 Other ChangesNotable FixesSupported JIRA VersionsStructure 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. Note |
---|
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. |
InstallationThe plugin may be installed from the Atlassian Marketplace or from the Administration | Add-ons menu. Further information is available in the Administrator's Guide. Upgrading from a Previous VersionUpgrade 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 |
---|
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 or jira-application.log for warnings or errors.
|