Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Reverted from v. 7

...

Additional validators and conditions enable you to perform checks in Jira based on a certain criteria:

Table of Contents
maxLevel3
minLevel2

Workflow validators

Workflow functionDescriptionParameters

Regex Validator

...

Checks that input value to a custom field

...

satisfies the Regex expression.

Configuration:

...

You must specify the custom field and Regex. The custom field values will be matched by the Regex. Optionally

...

, you can also specify a custom error message.

...

You can check that

...

story points are integer

...

.

Image Added

Unique Field Value Validator

...

Checks how many different values exist for a

...

certain field in the ticket.

Configuration

...

You must specify

...

  • JQL in which the result field values of issues will be compared

...

  • Field the values for which will be compared

...

  • Maximum allowed non-unique values of the field in a JQL result

...

  • Alternative error message.

Image Added

JQL Validator

...

Checks the count of

...

issues in a JQL result.

...

Configuration

...

  • JQL – use %THIS% to point to a current issue

...

  • key
  • Number of issues which should be the same as a number in a result JQL

...

  • You can also set an alternative error message if a comment is not provided.
  • JQL - use %SUMMARY% to point to the current issue summary.

...

  • For example:
    project = "TEST" and Summary ~ "%SUMMARY%"

You can check that

...

there is already an issue with the same summary.

  • Singular Status Validator. This validator checks that there are no issues in a status.
  • Links Validator. This validator checks that there are no linked issues in

...

  • setted statuses.

Image Added

Comment Validator

...

This validator requires a transition comment for all users except

...

those specified in the exception group(s).

Configuration

  • You can specify the user groups that can skip providing a comment. 
  • You can also set an alternative error message if a comment is not provided. See example below

Image Added

Example for a Comment Validator

Let's see how using this validator you can require all users except of the 'jira-developers' group to comment on a ticket when they transition it

Workflow Conditions

...

  1. Go to Jira Administration > Issues > Workflows.
  2. Click Edit for a project where you want to add a validator.

    Image Added


  3. Select the Diagram view

    Image Added


  4. Select the transition where you want to add a validator, the configuration panel appears. 
  5. Select the Validators tab and click Add validator.

    Image Added

  6. Select the Comment Validator option and click Add

    Image Added

  7. Define validator parameters:
    • (Optionally) Select group(s) that should be able to skip the comment while transitioning tickets
    • Specify an alternative message to show to the users in order to prompt them to comment on a ticket during a transition.
    Click Update.

    Image Added

  8. To save changes, click Publish Draft.
  9. In the dialog that appears, select whether you'd like to backup project copy, and click Publish.

    Image Added


  10. That's it. (smile) Now, while making a ticket transition if you are not in 'jira-developers' you are required to comment every time that you are transitioning a ticket.

    Image Added


Workflow conditions

To set up the condition perform the same steps as setting up any validator or post-function.

Select the Condition option you need and click Add

Image Added


Workflow conditionDescriptionExamples

Limit By Status Condition 

Limits the maximal number of issues with a specified status for a single user.


Configuration

You must specify the maximum number of issues with a specified status for a single user.

Image Added

Has Attachments AM Condition

...

Checks whether an issue has attachments.

Image Added

Has Links AM Condition

...

Checks whether an issue has links.

Image Added