Versions Compared

Key

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

...

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

Panel

...

stylefont-family:Courier

<!-- @@Formula:

...

formula goes here -->

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

Panel

This field represents the number of Affected Versions.
<!-- @@Formula: issue.get("versions").size() -->

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:

font-family:Courier
Panel
Span
style

issue.get("<field_ID>")

where <field_ID> is a built-in JIRA field ID (see this list) or a custom field ID (in the form customfield_nnnnn).

...

Note that you must make sure the formula returns a number, or null.

...

Example
Adding two fields

To add two custom fields, such as "Business Value" and "Technical Value" to get an "Overall Value":

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

You can also specify custom formatting for the value of the Calculated Number field. In the Description field, add your formatting formula using the following syntax:

Panel

<!-- @@Format: formula goes here -->

The formula itself is a Java-style expression that can reference the value returned by the formula using the value variable. You can also use the numberTool object to format the number value:

Code Block

numberTool.format(value)

...

Example

...

To display an icon to the left of the field value depending on the field value:

Code Block

<!-- @@Format: 
if (value > 21)
  return "<img src='/images/icons/priority_trivial.gif'> "+numberTool.format(value);
else if (value >= 10)
  return "<img src='/images/icons/priority_major.gif'> "+numberTool.format(value);
else 
  return "<img src='/images/icons/priority_blocker.gif'> "+numberTool.format(value);
 -->

Anchor
transitiondatefield
transitiondatefield

...

Panel

This field represents the date and time of the Resolution of this issue.
<!-- @TransitionId: 5 - ->

Anchor
transitioncallerfield
transitioncallerfield

...

Panel

This field represents the Resolver of this issue.
<!-- @TransitionId: 5 - ->

Anchor
parentstatusfield
parentstatusfield

...