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

Post functions can be used to automate tasks and ensure consistent data quality by eliminating or at least minimizing human error.


Image Added


Jira ships with built-in post functions but those are limited. JWT for Jira Cloud extends that list by offering custom post functions. 

All post functions, as opposed to conditions and validators, use the power of the expression parser to to get you the data you need, when you need it.



Image AddedAvailable post functions

Jump right in and configure any of the available post functions listed below. Each post function comes with built-in examples.

If you need more help on how to construct expressions check out the documentation on the expression parser, and available field codes and operators or check out the use cases and examples below.

Children Display




Panel
borderColor#006275

Image AddedGet started in no time!

To help you getting started, JWT for Jira Cloud comes with a predefined set of example configurations that you can apply with a single click.

Image Added


Image AddedUse cases and examples

Page properties report
firstcolumnUse case
headingsJWT feature, Workflow function, Parser functions, Use case description, Complexity
sortByFunction
cqllabel = "use-case" and label = "post-function" and space = currentSpace()


Excerpt Include
DECADIS:Contact support
DECADIS:Contact support
nopaneltrue

Julian Riedinger

  1. Same texts as in https://www.decadis.net/confluence/display/JWTC/Post-functions/GUI? Or like the texts in automation? (e.g. "Add a comment..." vs "Adds a new comment...") I prefer the same notation as in the GUI
  2. What about usage examples? There are none in the automation doc.
  3. The screenshots contain data like those in the automation doc - is that ok or shall they remain empty?
  4. Update issue: " (system or custom fields)" in this version no support (e.g. select fields) for custom fileds is given in the GUI - shall we delete this part for this version?

Below the postfunction provided by Jira Workflow Toolbox Cloud are described shortly. A screenshot with example data is shown and the respective configuration is decribed (default values are shown in bold).

Add comment

Add a comment to a target issue.

...

styleborder-left:3px solid #7db246;padding-left:15px;margin-bottom:40px;

...

directionhorizontal

...

idadd-comment-screen
titleScreenshot

Image Removed

...

idadd-comment-config
titleConfiguration

...

The issue the comment will be added to. The following options are available:

  • Current issue 
  • Parent issue
  • Parser expression

...

Select the author for the comment. It can be chosen from one of the following options:

  • Current user 
  • Selected user
  • Assignee
  • Reporter
  • Creator
  • Project lead
  • Parent's assignee
  • Parent's reporter
  • Parent's creator

...

Set the visibility of the comment with the following options:

  • Unresticted (all users)
  • Restricted to Project Role
  • Restricted to Group

...

idadd-comment-examples
titleUsage examples

???? The Action has been used in the following examples:

...

typespage
spacesAUTOMATION
labelsadd-comment

...

Create issue

Create an issue or a sub-task.

...

styleborder-left:3px solid #7db246;padding-left:15px;margin-bottom:40px;

...

directionhorizontal

...

idcreate-issue-screen
titleScreenshot

Image Removed

...

idcreate-issue-config
titleConfiguration

...

The issue type of the issue to be created. The following options are available:

  • Selected issue type
  • Pareser expression (standard issue type)
  • Parser expression (sub-task issue type)

In case a sub-task is chosen, the respective parent has to selecetd.

...

The parent issue in case a sub-task is chosen as issue type. The following options are available:

  • Current issue
  • Selected issue
  • Parser expression

The parent issue is only shown when a sub-task is selecetd as issue type.

...

 The project the issue will be created in. It comes with the following options:

  • Current project
  • Selected project
  • Parser expression

Please note that the project selection does not show up when the issue type is a sub-task

...

In the selection box of the Add-Button you can select 

  • Current issue (and selecting a field then)
  • Parser expression

...

 Select the user that will be used to execute this post function. It can be chosen from one of the following options:

  • Current user 
  • Selected user
  • Assignee
  • Reporter
  • Creator
  • Project lead
  • Parent's assignee
  • Parent's reporter
  • Parent's creator

...

idcreate-issue-examples
titleUsage examples

???? The Action has been used in the following examples:

...

typespage
spacesJWT
labelscreate-issue

...

Transition issue

Execute a transition on a target issue. 

...

styleborder-left:3px solid #7db246;padding-left:15px;margin-bottom:40px;

...

directionhorizontal
Tabs Page
idtransition-issue-screen
titleScreenshot

tbd after react implementation

...

idtransition-issue-config
titleConfiguration

...

Target issue

...

The issue to be transitioned. The following options are available:

  • Current issue 
  • Parent issue
  • Parser expression

...

Select the transition to be executed or the status to be transitioned to. You can choose between to options:

  • Execute transition
    Pick either a transition which is shown by name and ordered by workflows or a parser expression
  • Transition to status
    Pick either a status which is shown by name or a parser expression

...

 Select the user that will be used to execute this post function. It can be chosen from one of the following options:

  • Current user 
  • Selected user
  • Assignee
  • Reporter
  • Creator
  • Project lead
  • Parent's assignee
  • Parent's reporter
  • Parent's creator

...

idtransition-issue-examples
titleUsage examples

???? The Action has been used in the following examples:

...

typespage
spacesJWT
labelstransition-issue

...

Update fields

Update one or multiple issue fields (system or custom fields) on a target issue. 

...

styleborder-left:3px solid #7db246;padding-left:15px;margin-bottom:40px;

...

directionhorizontal
Tabs Page
idupdate-fields-screen
titleScreenshot

Image Removed

...

idupdate-fields-config
titleConfiguration

...

Target issue

...

The issue to be updated. The following options are available:

  • Current issue 
  • Parent issue
  • Parser expression

...

Set or clear values for specific fields. In the selection box of the Add-Button you can select 

  • Current issue (and selecting a field then)
  • Clear field value
  • Parser expression

...

 Select the user that will be used to execute this post function. It can be chosen from one of the following options:

  • Current user 
  • Selected user
  • Assignee
  • Reporter
  • Creator
  • Project lead
  • Parent's assignee
  • Parent's reporter
  • Parent's creator

...

idupdate-fields-examples
titleUsage examples

???? The Action has been used in the following examples:

...