Versions Compared

Key

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


UI Text Box
sizemedium
typeinfo

This post function automatically creates one or multiple standard issues or sub-tasks in any given project.

The issue(s) that will be created can be entirely customized - from dynamically determining the issue type to presetting or inheriting field values.

JWT offers the Execute remote action post function to execute predefined or custom actions not only locally on the current Jira environment, but also on any other web service using JSON.


Image AddedConfiguration

The post function offers two types of configuration. In the default view you can choose between predefined and directly usable action templates. In the expert mode, actions can be freely defined and configured.

Image RemovedConfiguration


UI Tabs


tabtitle
UI Tab
titleWizzardWizard


ui-
text-box
size
Expert mode
medium
typeinfo
Image Added

The wizard is the default configuration view of the Execute remote post function. It was built to enable an easy and efficient configuration of common use cases. For those use cases, action templates are shipped with the app, which can be configured in a three-step approach.


UI Text Box
typetip
You can switch at any time to the Expert mode, where the configuration so far is taken over, using the Expert mode button on the top. Be aware that once you change something in expert mode, you cannot switch back.



UI Steps

Create remote action

UI Step

Select action

At the very beginning, you need to choose an action template that suits your purpose. You can filter those templates by the target service and search across all provided ones. After selecting one, click next to get to the next step. 


UI Step

Select connection

After selecting an action template, you need to choose the remote service, the action shall get executed against. If you have selected an action template that fits to the target platform, you can select next to your custom connection, the current instance additionally.

If you cannot find a connection that fits, you can easily configure a new one

After selecting one, click next to get to the next step. 


UI Step

Customize your action

In the last step, you can finish your configuration by setting all the required action template parameters using the set value link next to the parameter name. Some templates have optional parameters that can be chosen using the "Add parameter" action.

Each parameter can be set either by selecting a Jira field that contains an according value or by setting a custom value using the "set value manually option" and passing a parser expression (tick)

Besides setting the action parameters, you can also configure fields to be updated after the action has been executed. If provided in the action template, you can set a field using a dedicated part of the remote service's response. In every case, you can store the complete response and the status code of the remote service after executing the action.

After setting the action parameters and optionally storing the service response, you can click "Add" to store the post function in your transition.




Description

Define the description of the issue(s) to be created.

Additional fields

You can optionally set additional field values. After clicking the Add button you can define how to set the values.

UI Tab
titleExpert mode


UI Text Box
sizemedium
typeinfo
Image Added

The expert mode allows you to act as an expert in many other complex directions and possibilities! You can create your own actions, connections and extend the already created actions!

Basic configuration

Here you can define the core parts for setting up the communication with the external service. For this, you need the following:

UI Expand
titleAction

Within the action parameter you can either choose an existing custom action or create a new one. Additionally, you can select and use any action template known from the Wizard configuration.
An action is composed of:

  • Method
  • REST path
  • Parameters
  • Action body


Learn more about how to create a custom action!


UI Expand
titleConnection

Within the connection parameter, you can choose or define, where your action get executed against. You can either use the default connection configured in the selected action or override it with a different one. Learn more about creating new connections.



UI Text Box
typetip

You can use a connection for many actions.

Customize action


UI Expand
titleParameters


UI Text Box
typenote

You can only query parameters


OptionDescription
NameA proper name to describe the parameter
ValueYou can choose between:
  • Get field value from current issue
  • Set field value manually (by passing a parser expression (tick))
UI Expand
titleCustom headers

You can edit the custom headers from the selected connection, as well as remove or add new headers.

The mode parameter defines how many issues you want to create. The following modes are available:

If you want multiple issues to be created at once, you will be given various options to specify
  • how many issues will be created
  • which issue types they will have and
  • where they will be created 

Determining the number of issues is done using a parser expression. The output will depend on the selected parsing mode. The following options are available:

  • Number: The expression must return a number that defines the number of issues to be created. The most obvious way to achieve this is by simply adding a number.
  • JQL: The number of issues returned by the JQL query defines the number of issues to be created.
  • Issue list: The number of list elements defines the number of issues to be created.
  • Text list: The number of list elements defines the number of issues to be created.

Select the issue type of issue(s) to be created. The following options are available:

Select the issue type for the issue to be created. Depending on the selection additional parameter will be available.

In case you choose a standard issue type, the project you want to create the issue in has to be defined. The following options are available:

  • Current project
  • Selected project
  • Seed issue's project (only available if multiple issues were selected and JQL mode or Issue list mode was used to set the value)
  • Set project manually (parser expression)
UI Expand
titleFields


UI Text Box
typenote

Please note that only web services providing JSON are currently supported. To easily navigate in JSON structures, you can use the JMESPath.


OptionDescription
Action template specific Most action templates provide action-specific options to access attributes out of the action body quickly.
Response bodyChoose if you want to get the whole body of the response.
Response statusChoose if you want to get only the status of the response
UI Expand
titleMode
OptionDescription
Single issue

If you select this mode, you will be dynamically guided to ultimately specify what issue type will be created and where it will be created. This may include a multi-layered selection process.

You can either pick the issue type from a list of available issue types or manually define the type using a parser expression.

Depending on each selection, additional parameters will be shown. These parameters depend on the context or your previous selection - for example:

  • a parent issue needs to be chosen, when a sub-task is being created
  • a project needs to be selected, in which the issue will be created

In this mode, only one single issue will be created.

Multiple issues
Include Page
DECADIS:_snip_tryExpressionDECADIS:_snip_tryExpression
UI Expand
titleIssue type
OptionDescription

Selected issue type

UI Text Box
typenote

If you want to dynamically set the project using an expression, make sure it returns a project name or project key.

In case you choose a sub-task, the respective parent has to be selected and the following options are available:

  • Current issue
  • Parent of current issue
  • Seed issue (only available if multiple issues were selected and JQL mode or Issue list mode was used to set the value)
  • Set parent manually (Parser expression)
UI Text Box
typenote

If you want to dynamically set the parent using an expression, make sure it returns a single issue key.

Especially when using the JQL mode or Issue list mode, that return a list of multiple issues.

Parser expression (standard issue type)

If you want to dynamically set the issue type using an expression, make sure it returns an issue type name.

Parser expression (sub-task issue type) If you want to dynamically set the sub-task issue type using an expression, make sure it returns a sub-task issue type name.
UI Expand
titleFields

Summary

Define the summary of the issue(s) to be created.

Include Page
DECADIS:_snip_generic_expression_editorDECADIS:_snip_generic_expression_editor
Include Page
DECADIS:_snip_generic_expression_editorDECADIS:_snip_generic_expression_editor
Include Page
DECADIS:_snip_available_optionsDECADIS:_snip_available_options
OptionDescription
AutomaticThis option is only available for the field Assignee.
Selected valueSelect a specific value from the dropdown list.
Copy field value from current issueCopy the value from a field in the current issue. Select the field you want to copy the value from.
Copy field value from epic issueCopy the value from the related Epic issue. Select the field you want to copy the value from.
Copy field value from seed issue

Copy the value from a seed issue. This option is only available if multiple issues were selected and JQL mode or Issue list mode was used to set the value).

Copy field value from parent of new issueThis option is only available if you create a sub-task under a new parent. Only available if the issue to be created is a sub-task.
Set field value manually (parser expression)

Select the field to copy from using an expression. 

Include Page
DECADIS:_snip_generic_expression_editor
DECADIS:_snip_generic_expression_editor

Copy remaining fields

Set this parameter if you want to optionally copy or clone all (remaining) field values from an issue. 

Include Page
DECADIS:_snip_available_optionsDECADIS:_snip_available_options
OptionDescription
Don't copy fieldsBy default no other field values will be copied.
From current issueAll other field values will be copied from the current issue.
From parent of current issueAll other field values will be copied from the parent of the current issue.
From parent of new issueAll other field values will be copied from the parent of the sub-task to be created. Only available if the issue to be created is a sub-task.
From seed issue

All other field values will be copied from a seed issue. This option is only available if multiple issues were selected and JQL mode or Issue list mode was used to set the value).

From epic issueAll other field values will be copied from the related Epic issue.



Issues to be linked

Optionally define issue links to be created for the new issue(s). You have the option to link the issue that you are currently creating to various other issues. 

Condition

You can optionally define a condition which must be met for the link to be created. The expression can be set using the Logical mode.

UI Expand
titleAdditional options
  • Send email notification: Notification will be sent according to the associated notification scheme.
  • Update issues immediately: Choose if you want Jira to fire a separate "Issue updated" event for any field change.  This will also result in a dedicated issue history entry.
UI Text Box
typeinfo

By default, all the additional options are disabled.

UI Expand
titleIssue links
Include Page
DECADIS:_snip_available_optionsDECADIS:_snip_available_options
OptionDescription
Current issueLink the issue(s) to be created to the current issue.
Parent of current issueLink the issue(s) to be created to the parent of the current issue.
Parent of new issueLink the issue(s) to be created to the parent of the sub-task to be created. Only available if the issue to be created is a sub-task.
Epic of current issueLink the issue(s) to be created to the related Epic of the current issue.
Seed issue

Link the issue(s) to be created to a seed issue. This option is only available if multiple issues were selected and JQL mode or Issue list mode was used to set the value)

Select issues manually (parser expression)
Include Page
DECADIS:_snip_issue_selection_expression_editorDECADIS:_snip_issue_selection_expression_editor
UI Expand
titleAdditional options

The only available additional option is Store issue keys.

If this option is checked, all issue keys from the issue(s) to be created will be stored in the field temporary text 3 as a comma separated list. 



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





Use cases and examples

Page properties report
firstcolumnUse case
headingsJWT feature, Workflow function, Parser functions, Label
sortByTitle
cqllabel = "useremote-case-workflowaction" and parent space = currentContentcurrentSpace()


Excerpt Include
DECADIS:Contact support
DECADIS:Contact support
nopaneltrue


staff pick

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 descriptionCreate one or multiple issues or sub-tasks.
Label
Status
colourRed
title