Get started

Use case library

JWT expression editor

JWT expression parser functions

JWT workflow functions

JWT remote actions

JWT automation rules

JWT calculated fields

JWT calendars

JWT properties

JWT JQL functions

Cloud migration hub

Additional product info

Versions Compared

Old Version 9

changes.mady.by.user Iheb Kharab

Saved on

compared with

New Version Current

changes.mady.by.user Christian Czaia

Saved on

Key

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


Panel

On this page

Table of Contents
exclude(On this page|Filter by field value).*
stylecircle
typeflat
separatorpipe

UI Text Box
sizemedium
typeinfo

When copying numeric fields it calculates the sum of field values in linked issues or subtasks.

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


Image AddedConfiguration

UI Expand
titleTarget fields

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

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.

Target field*

Add a field to configure

Value*

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.

Filter

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


    UI Text Box
    typenote

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

    info

    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:

    • 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

    Filter by field value

    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 types, all 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.

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

    UI Text Box
    type
    		tip
    info

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

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

    .





    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




    Enter a condition (Logical / boolean condition) using the JWT expression parser functions 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
    UI Text Box
    typenote

    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 able 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 description Copy the field values from one or multiple linked issues or sub-tasks. Values can also be aggregated.
    Label

    Status
    colourRed
    titlestaff pick