Versions Compared

Key

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


UI Text Box
sizemedium
typeinfo

This post function 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 will be read. If sub-tasks should also be taken into account, the corresponding additional option has to be checkedWhen copying numeric fields it calculates the sum of field values in linked issues or subtasks.


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 issue
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
Then you can choose the Field the copy from
  • .


Set field value manually (parser expression)
  1. Then 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


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

  • Any project
  • Current project
    ui-expand
    titleFilter project
    -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

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


    title

    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
    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
    UI Text Box
    typenote

    Selected issue types will be read, but if you don't select any, it won't be applied any filter by issue type. In that case, all the issue types will be read.

    The following options are available:

    • Task
    • Sub-task
    UI Expand
    titleFilter by status
    UI Text Box
    typetip

    Leave blank for all issue statuses.

    The following options are available:

    • In progress
    • To do
    • Done
    UI Expand
    titleFilter by field value
    Enter a parser expression. The expression must return a true or false

    UI Text Box
    type
    tipYou can try your expression by clicking the play button on the top right of the JQL expression box
    info

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





    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 able 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
    colourGreen
    titletododone

    Style guide

    Status
    colourGreen
    titletododone

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