Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
UI Text Box
sizemedium
typeinfo

This very powerful post function can be used to update a single issue field according to a set of rules.

You can use this function to construct multiple "if → then" rules.

Once you have defined the source field, a rule and a value you have constructed the entire if clause.

The next step is to define, which value the target field will be updated to, if the values match. This is the then part of your rule.

UI Text Box
typenote

If used in the create transition, they need to be placed after the “Create issue initially” post function

Configuration

UI Expand
titleSource field

Select the field that will be analyzed by the defined rules. The combination of this source field and the source value, as specified in each rule, builds the if part.

UI Text Box
typeinfo

Even though this parameter is mandatory, the selection is irrelevant if you choose to base your rule on a Logical expression.

UI Expand
titleTarget field

Select the field to be updated according to the rules.

The rules will be processed in order. The first rule matching the given expression will update the target field.

UI Expand
titleRules

Define the rules for updating the target field and the corresponding target field values

UI Text Box
typeinfo

Once a rule is matched, its associated value will be parsed or calculated and copied to selected target field, and the rest of the rules will not be processed.

If the selected target field is of type number, date, date and time, the associated value should be a number or a mathematical/time formula. Learn more about Numbers and working with Dates, times and time zones.

Other data types like users, issue status, issue priority and issue resolution require values of corresponding suitable types.


You can choose between the following options:

OptionDescription
Text comparison

Choose this option if you want to compare the value of the specified source field with another text value. 

Logical expressionChoose this option if you want to construct a logical rule using the Logical mode. Once set up, you have to define, which value the target field will be updated to if the expression returns true.
Regular expressionEnter a valid regular expression and optionally use field codes to to specify your rule. This expression will then be evaluated against the selected source field.


Examples:

IFTHENOutput
Source fieldModeSource field valueTarget fieldTarget field valueDescription
PriorityText comparisonHighAssigneea.agrantIf the issue priority is High, the issue will be assigned to a.grant.
PriorityText comparisonLowAssigneed.jonesIf the issue priority is Low, the issue will be assigned to d.jones.
UI Text Box
typetip

Logical expressions are not analyzing the source field. Whereas text comparison and regular expression rules are checked against the source field value, logical expressions are independent of the source field value. Instead you will have to provide a logical expression using the Logical mode.

Alternatively you could use the Update or copy field values post function and set values using multiple conditional operators.

UI Expand
titleAdditional options
OptionDescription

Write protection

Include Page
DECADIS:_snip_write_protection
DECADIS:_snip_write_protection

Evaluate all rules

Per default, JWT will stop evaluating the rules when the first rule matches (e.g. a source field value was identified according to a rule).

If you check this option, JWT will evaluate all rules, potentially executing a different rule. The order in which the rules are specified matters in this case as JWT will go through each rule from top to bottom.

UI Text Box
typenote

Only applicable for multi-valued or temporary target fields.

Update issue immediately

Include Page
DECADIS:_snip_update_immediately
DECADIS:_snip_update_immediately

UI Expand
iconfalse
titleConditional execution

Include Page
DECADIS:_snip_condExecution_Server
DECADIS:_snip_condExecution_Server

UI Expand
iconfalse
titleRun as

Include Page
DECADIS:_snip_runAs_Server_postFunction
DECADIS:_snip_runAs_Server_postFunction


Use case and examples

Page properties report
firstcolumnUse case
headingsJWT feature, Workflow function, Parser functions, Label
cqllabel = "use-case-workflow" and ancestor = currentContent()


Excerpt Include
DECADIS:Contact support
DECADIS:Contact support
nopaneltrue

Page properties
hiddentrue
Tech review

Status
colourGreen
titledone

Style guide

Status
colourGreen
titledone

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged

Page properties
hiddentrue
Short descriptionUpdate a single issue field according to a set of rules.
Label

Status
colourRed
titlestaff pick