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 the 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



UI Expand
titleFilter


UI Text Box
typeinfo

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

UI Expand
titleFilter project

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

  • Any project
  • Current project
  • Any but current project
UI Expand
titleFilter by issue link type

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

UI Text Box
typenote

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

The following options are available:

  • 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 Expand
titleFilter 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.

UI Expand
titleFilter 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.

You can try your expression by clicking the play button on the top right of the JQL expression box
UI Expand
titleFilter by field value

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

UI Text Box
typetip

.





UI Expand
titleAdditional options


OptionDescription

Include sub-tasks matching the specified filter criteria

Choose this option, if you want to also or only copy the values from sub-tasks.

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

This option only makes sense when the current issue itself is not a

subtask
  • Read also sibling subtasks fulfilling condition on issue type, status, and project - Sibling subtasks are understood as subtasks with the same parent as the current issue. This option only makes sense when the current issue is itself a subtask
  • Read linked issues and subtasks recursively - Issues and subtasks 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
  • sub-task.

    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
    Update issue immediately - A specific entry will be created in issue history for this field writing




    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