Number of related issues validator

Introduction


Complex element

This workflow element is complex and maybe a little confusing for beginners. If you have any further questions, please contact us via our Customer Portal.


It's a validator that checks if the number of related issues (based on JQL or simple subtasks/links) meets your expectations. It allows you e.g. to block a transition if there are some unresolved linked issues or the number of issues created last week is bigger than "X".

 

Element summary
StatusCURRENT
Version campatibility6.0.1 - Latest
SupportedYes
Introduced in version1.0.0

Validator parameters

  • Related Issues - as described below.
  • Operator - a math operator to compare related issues counted with a given number.
  • Target value - the expected number of issues to pass the validation.
  • Failed validation message - a message is sent to the user if the validation fails.
  • Evaluate value on - a method of validation.
    • Original issue - an issue without changes made by the user (on the transition screen).
    • Issue after transition - an issue after the changes made on the transition screen (but it doesn't reflect changes made by post functions)

Working with related issues

Related issues can be selected by using two inputs:

Issue Relation - where you can choose a relation with the current (transitioned) issue;

JQL - you can put your JQL text to filter some issues from the results. If you leave the JQL Field empty, all issues in a given relation are taken into account.

In the example above you wanted to execute a workflow function on subtasks of the current issue and take additionally only the ones with the "Sub-task" and priority="High" type.

Tags

In the JQL field you can put some text tags to be replaced with actual values of the current (transitioned) issue:

TagDescription

$$CURRENT_DATETIME$$

The current date and time.
 $$CURRENT_USER$$The name (login) of the current user.
$$ISSUEKEY$$The key of the current issue.
 $$ISSUEID$$ID of the current issue.
 $$REPORTER$$The current issue reporter's name.

$$ASSIGNEE$$

The current issue assignee's name
$$PROJECTKEY$$The project key.
$$CURRENT_STATUS$$The current issue status.
$$ISSUETYPE$$The issue type.
$$CREATED_DATE$$The date when the issue was created.

$$CURRENT_STATUS_CATEGORY$$

A status category of the current issue (To Do, In Progress or Done).
$$TRANSITION_NAME$$The name of an actual transition (doesn't work in Conditions)
$$TRANSITION_ID$$ID of an actual transition (doesn't work in Conditions).
$$TRANSITION_COMMENT$$The content of a transition comment (doesn't work in Conditions).

The JQL field has a built-in validation feature. If your query is incorrect, you will see a red sign next to the JQL field and an error description as shown below:

Example of use