Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The JIRA Misc Custom Fields plugin's objective is to provide several new types of custom fields for use in custom JIRA workflows (although at this time it only provides one), as well as useful JQL functions.

Included custom fieldfields:

  • Calculated Number Field : a calculated custom field returning a number (integer or float). It is a read-only field that returns the result of the evaluation of a formula, such as the addition of two other fields.
  • Transition Date/Time Field : a calculated custom field returning the date and time of the last execution of a specified workflow transition.
  • Transition Caller Field : a calculated custom field returning the caller of the last execution of a specified workflow transition.

Included JQL function:

  • currentUserPropertyAsList (new in 1.1): a JQL function that returns the value of a property of the current user, transforming comma-separated values into a list of values.

...

The plugin is a "type TWO" plugin, which means that the plugin can be installed by copying it to jira-home/plugins/installed-plugins or, better yet, using the excellent Atlassian Universal Plugin Manager.

Usage

Anchor
calculated number fieldcalculated number fieldcalculatednumberfield
calculatednumberfield

Calculated Number Field

  1. Create a new custom field, choosing "Calculated Number Field" for its type.
  2. During step 2, in the Description field, include the calculation formula using the syntax described below.
  3. Re-index your data, as JIRA will kindly suggest you to.

Anchor
transitiondatefield
transitiondatefield

Transition Date/Time Field

  1. Create a new custom field, choosing "Transition Date/Time Field" for its type.
  2. During step 2, in the Description field, include the transition ID (recommended) or name as described below.
  3. Re-index your data, as JIRA will kindly suggest you to.

...

Indicating the transition

The formula transition should be included indicated in the field description inside an html comment (so that it remains invisible when showing the field description), preceded by the following keyword: @TransitionId:@@Formula or @TransitionName: (note the colon at the end). For example:

Panel
Span
stylefont-family:Courier

<!-- @TransitionId: transition ID ->

or

Panel
Span
stylefont-family:Courier

<!-- @@Formula: formula goes here @TransitionName: transition name ->

You can naturally include the real description of the custom field as well. For example:

Panel

This field represents the date and time of the number Resolution of Affected Versionsthis issue.
<!- - @@Formula: issue.get("versions").size() --@TransitionId: 5 ->

The formula itself is a Java-style expression that can reference any issue field value, include arithmetic operators as well as any other Java operator, and Java method calls (such as the .size() example above). Access to issue field values is achieved by the following syntax:

...

Code Block
<!-- @@Formula: (issue.get("customfield_10114") != null ? issue.get("customfield_10114") : 0) + (issue.get("customfield_10150") != null ? issue.get("customfield_10150") : 0) --> 

Anchor
currentUserPropertyAsList
currentUserPropertyAsList

...