Versions Compared

Key

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


UI Text Box
sizemedium
typeinfo

This post function can be used allows you to copy a field value from multiple issues to the current issue. Since potentially multiple values will be returned, the values can be aggregated or calculated.

By default, the field values from linked issues ' fields will be read. If sub-tasks should also be taken into account, the checkbox (see below) corresponding additional option has to be checked.


Image ModifiedConfiguration

UI Expand
titleTarget fieldfields

Select the target fields that will be set and the source values for each of them. Add a field to configure and select a field value. The following options are available:

OptionDescription
Copy field
value from current issueChoose the Field to copy from
from selected issues

The value(s) found in the issues specified through the filters will be copied to the target field as a comma separated list.

Since you are copying the values of potentially multiple linked issues or sub-tasks JWT can aggregate values, and offers additional options depending on the type of source field.

UI Text Box
typeinfo

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)
  1. Enter the Expression

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

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



Filter by issue type

The selected issue types will used to filter the linked issues and sub-tasks, but if you don't select any, it won't be applied any issue type filter. In that case, all issue types are allowed.

Filter by status

Only linked issues and sub-tasks with the specified statuses will be read. If no status is selected, all issue statuses are allowed.

Filter by field value

Enter a parser expression. The expression must return a true or false

UI Expand
titleFilter


UI Text Box
typeinfo

If you choose to further filter the issues the values will be copied from, all filter criteria will be "and concatenated".

Values will only be copied from issues meeting all criteria will be considered.

Filter by project

Optionally specify specific projects, the linked issues or sub-tasks) must or must not belong to. The following options are available:

OptionDescription

Any project

By default, the linked issues or sub-tasks can be in any project.

Current project

Choose this option to make sure that all linked issues or sub-tasks are in the same project as the current issue.

Any but current project

Choose this option to make sure that all linked issues or sub-tasks are not in the same project as the current issue.


Filter by issue link type

If you select specific link typesall linked issues must be linked using the selected types. If issues linked with other link types are found, the condition will fail.

This filter is mandatory. If you only want to copy values from sub-tasks, leave this filter blank and check the additional option "Include sub-tasks matching the specified filter criteria".


Filter by issue type

You can optionally filter the issues to copy the values from by issue types. If you select values all linked issues or sub-tasks must be of any of the selected issue types


Filter by status

You can optionally filter the issues to copy the values from by status. If you select values all linked issues or sub-tasks must be in any of the selected statuses


Filter by field value

Optionally limit the issues you want to copy values from by their field values. To achieve this you must enter an expression in Logical mode. The expression must return  true or false

UI Text Box

Examples: 

ExpressionDescription


Code Block
languagebash
linenumberstrue
%{seed.issue.assignee} != null 


All issues must be assigned to a user. If unassigned sub-tasks are found, the condition will fail.

UI Text Box
typeinfo

Values in linked issues or sub-tasks have to be referenced by their seed field codes.



Code Block
languagebash
linenumberstrue
%{issue.dueDate} <= %{seed.issue.dueDate}


All issues must have a due date of equal to or later than the current issue's due date.

UI Text Box
typeinfo

Values in linked issues or sub-tasks have to be referenced by their seed field codes

Info

Only issues meeting the filter will be used to copy the field value from.

Filter project

Filter your project by choosing from one of the following options:

  • Any project
  • Current project
  • Any but current project

Filter by issue link type

UI Text Box
typenote

Only issues linked to current issue by selected issue link types will be read.

The following options are available:

OptionDescription

is blocked by (Blocks) -inward

blocks (Blocks) -outward

is cloned by (Cloners) -inward

clones (Cloners) -outward

is duplicated by (Duplicate) -inward

duplicates (Duplicate) -outward

relates to (Relates) -inward

relates to (Relates) -outward

UI Text Box
typetip
You can try your expression by clicking the play button on the top right of the JQL expression box

.





UI Expand
titleAdditional options


OptionDescription

Read also sub-tasks fulfilling condition on issue type, status and project

Include sub-tasks matching the specified filter criteria

Choose this option, if you want to also or only copy the values from sub-tasks. This option only makes sense when the current issue itself is not a sub-task

Read also sibling sub-tasks fulfilling condition on issue type, status, and project

Sibling sub-tasks are understood as sub-tasks with the same parent as the current issue. This option only makes sense when the current issue is itself a sub-task

Read linked issues and sub-tasks recursively

Issues and sub-tasks transitively linked will also be read, provided they fulfill stated filtering conditions. Issues are read recursively without depth limit, but each selected issue is read-only once

Read also current issue

Current issue will be included in the issue selection, i.e., current issue's field value will also be read

Update issue immediatelyA specific entry will be created in issue history for this field writing

.

UI Text Box
typeinfo

This option or the next option must be checked, if you leave the link type filter blank.


Include sibling sub-tasks matching the specified filter criteria

Choose this option, if you additionally want to copy the values from siblings of the sub-tasks that match the filter criteria.

UI Text Box
typeinfo

This option or the previous option must be checked, if you leave the link type filter blank.


Include recursively linked issues or sub-tasks matching the specified filter criteria

Recursively linked issues or sub-tasks (e.g. which are linked to a directly linked issue) will also be included independent of the linking depth.

Include current issue

The value of the current issue will be included in the output.

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
Choose which user* will be used to execute this post function. By default, it is set to the Current user.



Image ModifiedUse 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
colourRedGreen
titleflagged
Should be
done
after UI fixes (renaming labels?!) - JI

Style guide

Status
colourYellowGreen
titleReady for reviewdone

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


Page properties
hiddentrue


Short description Copy fields from linked issues or subtasks to the current issue. When copying numeric fields it calculates the sum of field values in from one or multiple linked issues or subtasks sub-tasks. Values can also be aggregated.
Label

Status
colourRed
titlestaff pick