| Info | ||
|---|---|---|
| ||
Please visit our Support Page for more information. |
...
- 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.
- Calculated Text Field (new in 1.5.5): a calculated custom field returning a String. It is a read-only field that returns the result of the evaluation of a formula, such as the concatenation of two other fields.
- Exact Text Searcher (Statistics-compatible) (new in 1.5.6): a custom searcher that allows calculated text fields to be used in statistics gadgets
- Calculated Date/Time Field (new in 1.5.5): a calculated custom field returning a java.util.Date (which represents a date+time). It is a read-only field that returns the result of the evaluation of a formula.
- Transition Date/Time Field (new in 1.2): a calculated custom field returning the date and time of the last execution of a specified workflow transition.
- Transition Caller Field (new in 1.2): a calculated custom field returning the caller of the last execution of a specified workflow transition.
- Transition Count Field (new in 1.5.11): a calculated custom field returning the number of times a specified workflow transition was executed.
- Last Field Value Change Date/Time Field (new in 1.6): a calculated custom field returning the date and time a field was last modified.
- Last Field Value Change Author Field (new in 1.6.5/1.7.2): a calculated custom field returning the author of the last modification made to a field.
- Parent Status Field (new in 1.2.2): a calculated custom field returning the Status of the issue's parent issue.
...
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
| Warning | ||
|---|---|---|
| ||
If you are using complicated (like recursive) formulas in calculate custom fields, and you are running on a large server, you might need to tune JMCF's thread pool as documented in JMCF-173. |
...
- Be able to search issues based on the exact value of the custom field (i.e. use the "=" operator instead of the "~" operator)
- Be able to use the field in one of the statistics reports or dashboard gadgets
...
| Anchor | ||||
|---|---|---|---|---|
|
- Create a new custom field, choosing "Calculated Date/Time Field" for its type.
- During step 2, in the Description field, include the calculation formula using the syntax described below.
- Re-index your data, as JIRA will kindly suggest you to.
Formula syntax
The formula is written using the BeanShell language, and 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). See Calculated Number Field above for details.
Note that you must make sure the formula returns a java.util.Date, or null.
Custom formatting
You can also specify a date/time format for the value of the Calculated Date/Time field. In the Description field, add the name of the date/time format using the following syntax:
| Code Block |
|---|
<!-- @@Format: <format_name> --> |
where <format_name> is one of the constants found here: https://developer.atlassian.com/static/javadoc/jira/reference/com/atlassian/jira/datetime/DateTimeStyle.html
...
| Code Block |
|---|
This field represents the date and time of the Resolution of this issue. <!-- @@Field: summary --> |
| Anchor | ||||
|---|---|---|---|---|
|
Parent Status Field
...
Last Field Value Change Author Field (new in 1.6.5/1.7.2)
A user field that returns the author of the last change made on a field.
- Create a new custom field, choosing "Last Field Value Change Author Field" for its type.
- During step 2, in the Description field, include the field name as described below.
- Re-index your data, as JIRA will kindly suggest you to.
Indicating the field
The field whose last modification author should be returned must be indicated in the field description inside an html comment (so that it remains invisible when showing the field description), preceded by the following keyword: @@Field: (note the colon at the end). For example:
| Code Block |
|---|
<!-- @@Field: <field-name> --> |
The field name (indicated as <field-name> above) should be specified as it appears in the "history" tab, except for system fields for which the name should be as listed here.
You can naturally include the real description of the custom field as well. For example:
| Code Block |
|---|
This field represents the date and time of the Resolution of this issue.
<!-- @@Field: summary -->
|
| Anchor | ||||
|---|---|---|---|---|
|
Parent Status Field
- Create a new custom field, choosing "Parent Status Field" for its type.
- Re-index your data, as JIRA will kindly suggest you to.
...
| Code Block |
|---|
resolution = Unresolved AND project in currentUserPropertyAsList("myProjects")
|
...