Versions Compared

Key

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

...

...

...

...

...

...

...

...

...

...

Div
idProductTOC

On this page

Table of Contents
maxLevel2
excludeOn this page
typeflat
separatorpipe

Description

Create Issue and Create Sub-task post functions can be configured to create the issue only if certain conditions have been met by the issue which is in transition.

Conditions

Define the conditions under which to create the new issue(s) or sub-task(s). If these conditions are not met, then no issues or sub-tasks are created. If you do not define any conditions, then your issues and sub-tasks are always created when the associated workflow transition occurs. There are two types of conditioning, they are:

  • Sub-task conditioning - prevents the creation of sub-tasks if the original issue is a sub-task and the configuration indicates not to create a sub-task. It has the optional capability to create a sub-task which is a sibling of the original issue.

  • Pattern matching conditioning - takes advantage of the find/replace capabilities to provide a very flexible way to condition issue creation based on matching issue information with a regex pattern. Although this is a more complex configuration, it is highly powerful in that it covers a great number of use cases. (info) How to use pattern matching conditioning

     includes

     includes additional details.

Table plus
sortColumn1

Field

Create Issue
(Available)

Create Sub-task
(Available) 

Default

Description

Create if original issue is a sub-task

(error)

(tick)


Only create the issue if the original issue is a sub-task.

Sub-task default handling 

(error)

(tick)


Recommend

to 

to not

 select

 select this option unless needed. Select to have Jira default sub-task create handling applied. Selecting this may override settings provided in the create configuration like setting fix versions. Defaulting behavior is similar to how sub-tasks are created from the UI. Since 5.0.

Example scenarios where you may need this:

  • You need a create listener to access the issue parent

  • You have a post function on the create issue transition that needs access to the parent

Condition 1

(tick)

(tick)


Using substitution variables, you can specify a value or exact match.

Condition 2

(tick)

(tick)


Using substitution variables, you can specify a value or exact match.  if both Condition 1 and Condition 2 are specified then both conditions must match in order for the issues to be created. The conditions are ANDed together.

Regular expression pattern

(tick)

(tick)


Specify a regex pattern for conditional matching. The pattern is applied to the Condition field to the left (e.g., Condition 1, or Condition 2).

Exact, Literal, Negative

(tick)

(tick)


Specify how the regex pattern should be evaluated. 

  • Exact - The pattern must be an exact match.

  • Literal - Treat any special characters in the pattern as literal characters.

  • Negative - Reverse the condition so that the condition is true if the match is false and vice versa.

Configuration

Define additional configurations for the issues or sub-tasks being created.

Table plus
sortColumn1

Field

Create Issue
(Available)

Create Sub-task
(Available) 

Default

Description

Acting user

(tick)

(tick)

The user logged in who is transitioning the workflow

Set a user who would have the same permissions as

the Assignee 

the Assignee for issue being created. This provides the flexibility to the specified user to perform the workflow transition.

Info

When you select None for this field, Acting user is defaulted to the user transitioning the workflow.

JQL query 

(tick)

(tick)


Define a JQL query that can be used to populate substitution substitution variables that can be used within individual fields or conditions and regular expressions. The substitution variables include:

  • %jql_result_count%

  • %jql_result_list%

  • %jql_result_1%

Create multiple issues

(tick)

(tick)


Using substitution variables, you can specify a value or exact match to create multiple issues. See: How to create multiple issues.

Regular expression pattern

(tick)

(tick)


Specify a regex pattern for conditional matching. The pattern is applied to the Condition field to the left (e.g., Condition 1, or Condition 2).

Exact, Literal Negative

(tick)

(tick)


Specify how the regex pattern should be evaluated. 

  • Exact - The pattern must be an exact match.

  • Literal - Treat any special characters in the pattern as literal characters.

  • Negative - Reverse the condition so that the condition is true if the match is false and vice versa.

Image Removed

...