Page Comparison

Description

The 'Update Issue Custom Field' post-function updates a custom field to a specified value, after a transition has been completed.

Since version 1.4.10, you may optionally append that value to the field its existing contents, or if the field is allowing multiple values, like a multiple selection field, the option matching the value will be set, without unsetting other options. The same is true for label or version picker custom fields.

Configuration

You must specify the custom field and the desired value. For example:
Image Modified
If you use
%%CURRENT_USER%%
as the custom field value (exactly this, nothing more), the user who triggered the post function will be set as value.

If you use
%%CURRENT_DATETIME%%
as the custom field value (exactly this, nothing more), the current date and time will be set as value.

If you use
%%ADD_CURRENT_USER%%
as the custom field value (exactly this, nothing more), the user who triggered the post function will be appended to the existing field content. Obsolete since 1.4.10, please use append option instead and CURRENT_USER macro.

Additionally for Cascading Select fields, you may either use the value of the option you would like to set, or it's id. In either case, no need to specify the parent option. For example:

• Vehicles
  • Car
  • Train
  • Bus
• Buildings
  • House
  • Skyscraper

Using Vehicles as the parameter for Custom Field Value would set the custom field content to that very option. Same if you would choose Train. Or, assuming 10701 is the ID of House, then the option House will be set.

For information on how to configure a post-function in JIRA, see the JIRA documentation.

Example

A workflow is configured so that the 'Start Progress' transition has the 'Update Issue Custom Field' post-function. The function is configured to set the 'Location Select' field to 'Sydney,Australia'. If a user starts progress on an issue on this workflow, the value of the 'Location Select' field will be set to 'Sydney,Australia'.