Workflow Post Functions

Created by Adam Labus
Last updated: Jan 11, 2022
6 min read

Update Custom Fields

The Update Custom Fields gives you ability to update custom fields values.

You can:

  • change fields value to new value

  • add new values to existing values (multi select fields)

  • remove values from existing values (multi select fields)

Custom field type

Expected values and format when setting the field

Examples

Custom field type

Expected values and format when setting the field

Examples

Text Field (single line)
Text Field (multi line)
Text Field (read only)

Text value (any other type will be cast to text)

This is example text with line brake
New line is here

Number Field

Number

1
1.23
12345

Date Picker

Date format:
yyyy-MM-dd
yyyy/MM/dd

2000-01-01
2000/01/01

Date Time Picker

Date with time format:
yyyy-MM-dd hh:mm:ss
yyyy/MM/dd hh:mm:ss

2000-01-01 01:01:01
2010/01/01 23:05:12

Labels

Admits + and - prefixes to add and remove single items.
All items must by in new line.
Item without + and - replace actual values.

newlabel
+ roadmap
- question

Checkboxes

Name of the choice to be selected.
Admits + and - prefixes to add and remove single items.
All items must by in new line.
Item without + and - replace actual values.

New option
+ Yes, i do
- No

URL Field

WWW url with protocol

http://www.mysite.com
https://www.mysite.com

Select list (single choise)

Name of the choice to be selected.

Option
Another option

Select list (multiple choise)

Name of the choice to be selected.
Admits + and - prefixes to add and remove single items.
All items must by in new line.
Item without + and - replace actual values.

New option
+ Yes, i do
- No

Select list (cascading)

Name of the choice to be selected.
Values separated sign "::". Value without sign "::" define only first level.

Only first level set
First level set :: Secound level set

Group Picker (single group)

Name of a group.

jira-administrators

Group Picker (multiple groups)

Name of a group.
Admits + and - prefixes to add and remove single items.
All items must by in new line.
Item without + and - replace actual values.

jira-administrators
+ jira-users
- jira-product-owners

User Picker (single user)

Name of a user name (not full name).

john

User Picker (multiple users)

Name of a user name (not full name).
All items must by in new line.
Admits + and - prefixes to add and remove single items.
Item without + and - replace actual values.

john
+ arnold
- stefan

Project picker (single project)

Project key or project id.

SDESK
10001

 

Clear Fields Value

The Clear Fields Value gives you ability to clear multiple fields at once

 

Set Issue Security Level

The Set Issue Security Level gives you ability to change Security Level. You can set default level for project Security Scheme, or set specific Security Level, or you can clear actual chosen Security Level

 

Reindex Issue

The Set Issue Security Level gives you ability re-index issue to keep indexes in sync with the database. This operation is always run by JIRA at the end of every transition, but thanks to this post-function you can also do reindex earlier if you need (reindex called by JIRA will still be executed)

 

Reset Fields Value

The Reset Fields Value gives you ability to reset fields value to value before current transition. If you need to modify fields values ​​in post-function, now you can restore them to values before transition.

 

Mathematical

Save the math expression into selected field (post function check math syntax)

 

Add Notes

How many times do you create the post function and after some time you did not remember why you configured it that way?.

From now you can add notes to the conditions in which you can write an additional comment for yourself or for your team explaining the configuration.

Notes in the post functions don't change issue

 

Get User Property

Copies the value of a user property to a field

 

Set/Update User Property

Set or update the value of a user property as a string

 

Run Post Function Template

Run and reuse predefined templates with one or more functions

 

Manage User Groups In Custom Fields

You can manage user groups in custom fields. Perfect solution for acceptance process.

  • Copy all Current User groups from 'Source field' to 'Destination field'

  • Add all Current User groups to 'Source field'

  • Remove all Current User groups from 'Source field'

 

Display Message to User

Since v. 2.11.*

  • Added ability to change flag width

  • Added Wiki Markups support

Display a message as a "flag" to the current user after transition in the top right corner of the page.

Example message body
1 2 3 4 5 6 <b>Hello</b> This is example color <font color=red>red</font> <ul> <li>Option 1</li> <li>Option 2</li> </ul>

 

Add/Remove Users To/From Groups

Add/remove users from custom fields to/from selected groups or groups in custom fields.

It is perfect for delegating group management to Jira users.

 

Availability

Available since v. 1.24.*

  • Update Custom Fields (supports change value, add or remove value)

  • Clear Fields Value

  • Reset Fields Value

  • Set Issue Security Level

  • Reindex Issue

  • Add Notes

Available since v. 1.26.*

  • Mathematical

Available since v. 1.37.*

  • Get User Property

  • Set/Update User Property

Available since v. 1.41.*

  • Run Post Function Template

Available since v. 1.46.*

  • Manage User Groups In Custom Fields

Available since v. 1.50.*

  • Display Message to User

Available since v. 2.1.0

  • Add/Remove Users To/From Groups