Versions Compared

Key

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


Panel

On this page

Table of Contents
exclude(On this page).*
stylecircle
typeflat
separatorpipe

UI Text Box
sizemedium
typeinfo

Copy field value This post function allows you to copy field values from one or multiple issues which are returned by an issue list or a JQL query.

Field values can also be aggregated or calculated. Make sure to familiarize yourself with the JQL mode and the Issue list mode which are used to define the target list of issues to copy values from.


Image AddedConfiguration

ui-text-boxexpand
typetitlenote

In this documentation and the post function configuration you will notice the symbol ( * ) next to some parameters, it means that this field is mandatory and shall not be left empty. Fields without the symbol are optional.

Basic configuration*

Below you will find a detailed description of each parameter of the basic configuration of the function.

Issues to copy from*

Target field

Select the target fields that will be set and the source values for each of them. The following options are available:

OptionDescription
Copy field from selected issues

The value(s) found in the issues specified in the next parameter "Issues to copy from" will be copied to the target field as a comma separated list.

Since you are copying the values of potentially multiple issues returned by a JQL query or an issue list JWT can aggregate values, and offers additional options depending on the type of source field

Info
iconfalse
Enter a JQL and optionally use field codes to insert field values

.

UI Text Box
type
tip

You can try your expression by clicking on the play button on the top right of the JQL expression box.

Target field*

Add a field to configure.

Value*

info

Calculated values

For date and date-time fields you can additionally choose to only return the:

  • Earliest date value among those being returned.
  • Latest date value among those being returned.

For numeric fields you can automatically return the following aggregated values:

  • Sum of values: sum of all the values being returned.
  • Lowest value: minimum value among those being returned.
  • Highest value: maximum value among those being returned.
  • Average value: arithmetic mean of values being returned.

When updating the Priority field you can additionally choose to only return the:

  • Highest priority value among those being returned.
  • Lowest priority value among those being returned.


Set field value manually (parser expression)

Set the value of the target field using an expression and optionally use field codes. The Parsing modes differ depending on the data type of the target field. 

You can either choose from the Advanced text mode or the Numeric mode.

Clear field valueChoose this option to clear the value of the target field. This option is not available for the Summary field.

Include Page
DECADIS:_snip_write_protection
DECADIS:_snip_write_protection



UI Expand
titleIssues to copy from

Enter a JQL query or an issue list and optionally use field codes to define the target list of issues the values will be copied from.

UI Text Box
typetip

Make sure to familiarize yourself with the JQL mode and the Issue list mode

Info
iconfalse

Select how to set the field value. The following options are available:

UI Steps
UI Step

Copy field value from current issue

Then you can choose the Field* the copy from.

UI Step

Set field value manually (parser expression)

Then enter the Expression*

And as an additional option, you can choose Write protection to not overwrite existing values.



UI Expand
titleAdditional options

Include Page
DECADIS:_snip_update_immediately
DECADIS:_snip_update_immediately
You have the option to Update issues immediately (each field update results in a dedicated "Issue Updated" event and issue history entry).


Enter a condition (Logical / boolean condition) using the JWT expression parser - full feature list syntax.

You can even logically link and gather conditions in expressions as you like in order to map more complex conditions.

UI Expand
iconfalse
titleConditional execution
Note

The post function will only be executed if the condition is met (returns true).

Include Page
DECADIS:_snip_condExecution_Server
DECADIS:_snip_condExecution_Server


Choose which user* will be used to execute this post function. By default it is set to the Current user.
UI Expand
iconfalse
titleRun as

Include Page
DECADIS:_snip_runAs_Server_postFunction
DECADIS:_snip_runAs_Server_postFunction



Image AddedUse cases and examples

Page properties report
firstcolumnUse case
headingsJWT feature, Workflow function, Parser functions, Label
cqllabel = "use-case-workflow" and parent = 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 descriptionCopy the field values from one or multiple issues returned by a JQL query or an issue list. Values can also be aggregated.
Label