Page History

Versions Compared

Key

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

UI Text Box

size	medium
type	info

This validator can block a transition based on the state and the number of an issue's sub-tasks.

The validator only makes sense when used in a workflow used by standard issue types.

You can specify multiple filter criteria that will be "and concatenated". Per default, all sub-tasks must match the combination of all criteria.

Configuration

UI Expand

title	Filter by issue type

If you select specific issue types, all sub-tasks must be of any of the selected issue types. If subtasks sub-tasks with other issue types are found, the validator will fail.

The additional filters can be used to further restrict the state of the selected issue typesissues to be analyzed.

UI Text Box

type	info

If you leave this filter blank, e.g. if the issue type is irrelevant, you must check the additional option Allow unselected issue types. → Ignore issue Skip issue type filter / issues in unselected issue types.

If you select specific issue types and also check the additional option Allow Skip issue type filter / issues in unselected issue types, the additional criteria (status, resolution, field value) will only be applied to the selected issue types.

UI Expand

title	Filter by status

If you select specific statuses, all sub-tasks must be in any of the selected statuses. If subtasks sub-tasks with other statuses are found, the validator will fail.

The additional filters can be used toto further restrict the state of the issues in the selected statusesissues to be analyzed.

UI Text Box

type	info

If you leave this filter blank, e.g. if the status is irrelevant, you must check the additional option Allow unselected statuses. → Ignore Skip status filter / issues in unselected statuses.

If you select specific statuses and also check the additional option Allow Skip status filter / issues in unselected statuses, the additional criteria (issue type, resolution, field value) will only be applied to the issues in the selected statuses.

UI Expand

title	Filter by resolution

If you select specific resolutions, all sub-tasks must have any of the selected resolutions. If subtasks sub-tasks with other resolutions are found, the validator will fail.

The additional filters can be used toto further restrict the state of the issues with the selected resolutionsissues to be analyzed.

UI Text Box

type	info

If you leave this filter blank, e.g. if the resolution is irrelevant, you must check the additional option Allow unselected statuses. → Ignore Skip resolution filter / issues with unselected resolutions.

If you select specific resolutions and also check the additional option Allow unselected resolutionsSkip status filter / issues in unselected statuses, the additional criteria (issue type, resolution, field value) will only be applied to the issues with the selected resolutions.

UI Expand

title	Filter by field value

Optionally limit the sub-tasks to be counted or analyzed by their field values. To achieve this you must enter an expression in Logical mode. The expression must return true or false.

UI Text Box

Examples:

Expression

Description

Code Block

language	bash
linenumbers	true

%{seed.issue.assignee} != null

All sub-tasks must be assigned to a user. If unassigned sub-tasks are found, the validator will fail.

UI Text Box

type	info

Values in sub-tasks have to be referenced by their seed field codes.

Code Block

language	bash
linenumbers	true

%{issue.dueDate} <= %{seed.issue.dueDate}

All sub-tasks must have a due date of equal to or later than the current issue's due date..

UI Text Box

type	info

Values in sub-tasks have to be referenced by their seed field codes.

UI Text Box

type	info

If you specify an expression and also check the additional option Allow unsatisfied condition on Skip issues with unmatched field values, the additional criteria (issue type, resolution, field value) will only be applied to the issues that match the expression.

UI Expand

title	Minimum number of sub-tasks

Specify the minimum number of the sub-tasks that need to satisfy the specified filter criteria. The default value is 0 to ensure the validator passes if the current issue does not have any sub-tasks.

UI Text Box

type	tip

If you set this number to 1, the validator will fail if the issue does not have any sub-tasks or if the existing sub-tasks don't match the specified filter criteria.

UI Expand

title	Maximum number of sub-tasks

Specify the maximum number of the counted sub-tasks that need to satisfy the specified filter criteria. The default is 1000.

UI Text Box

type	tip

If you set this number to 1, the validator will fail as soon as more than one sub-task satisfies the specified filter criteria.

Check this option in the two cases:

You have left the issue type filter blank: In this case you want to ignore the issue type filter and basically make sure that the other criteria you specify must be met in order for the validator to pass, regardless of the issue type.

UI Expand

title	Additional options

The following options can be used to refine the number of issues you want to analyze in this validator.

Per default all filters are mandatory, filters are "and concatenated" and you cannot save your configuration unless you have specified values. Any sub-task being analyzed by the validator must match all criteria.

UI Text Box

type	note

If you leave a filter blank you must check the additional option to skip the filter. Otherwise you cannot save your configuration.

The additional options allow you to override the default behavior.

Optionally select one or multiple filters or issues not matching the defined filter criteria that should be ignored.

Option

Description

Ignore issue type filter / issues in unselected issue types

Filter	Additional option	Description
No value selected	Not checked	Not possible. If you want to skip the filter you have to uncheck the corresponding additional option.
No value selected	Checked	Skip this filter completely.

An equivalent would be to select all available options, e.g. all issue types

in the filter

are allowed.

You have selected specific issue types in the issue type filter: In this case,

One or multiple values selected	Not checked	Enforce that all sub-tasks which are analyzed must have the selected values, e.g. only selected issue types are allowed.
One or multiple values selected	Checked	Issues not matching the specified value areallowed and will be ignored when evaluating whether the validator passes.

UI Text Box

type	tip

By default, whenever a value is selected in a filter it will be combined with all other filter criteria and all sub-tasks must match the filter combination.

If you only want to analyze specific issue types (e.g. "Test cases"), select "Test case" in the issue type filter and check the corresponding additional option. This way, other sub-tasks (which are not "Test cases") can exist and will not be considered.

Examples

The table below lists a few example configurations and their JQL equivalent.

Configuration

JQL

Issue type: Sub-task
Status: Closed
Resolution: blank
Additional options:
- Skip resolution filter

Code Block
type = Sub-task AND status = Closed

Issue type: Sub-task
Status: Closed
Resolution: blank
Additional options:
- Skip issue type filter
- Skip resolution filter

Code Block
(type = Sub-task AND status = Closed) OR type != Sub-task

Issue type: Sub-task
Status: Closed
Resolution: Done
Additional options:
- Skip issue type filter
- Skip resolution filter

Code Block
(type = Sub-task AND status = Closed AND and resolution = Done) OR type != Sub-task OR resolution != Closed

issue type is different to the ones selected in the filter, will be completely ignored by this validator.

Option	Description
Skip issue type filter / issues in unselected issue types	The issue type is irrelevant for this validator or sub-tasks in non-selected issue types will be ignored when evaluating whether the validator passes.
Skip status filter / issues in unselected statuses	The status is irrelevant for this validator or sub-tasks in non-selected statuses will be ignored when evaluating whether the validator passes.
Skip resolution filter / issues with unselected resolutions	The resolution is irrelevant for this validator or sub-tasks with non-selected resolutions will be ignored when evaluating whether the validator passes.
Skip issues with unmatched field values	Field values are irrelevant for this validator or sub-tasks with unmatched field values will be ignored when evaluating whether the validator passes.
Ignore status filter / issues in unselected statuses	Check this option in the two cases: You have left the status filter blank: In this case you want to ignore the status filter and basically make sure that the other criteria you specify must be met in order for the validator to pass, regardless of the status. An equivalent would be to select all available statuses in the filter. You have selected specific statuses in the status filter: In this case, sub-tasks in statuses is different to the ones selected in the filter, will be completely ignored by this validator.
Ignore resolution filter / issues with unselected resolutions	Check this option in the two cases: You have left the resolution filter blank: In this case you want to ignore the resolution filter and basically make sure that the other criteria you specify must be met in order for the validator to pass, regardless of the resolution. An equivalent would be to select all available resolutions in the filter. You have selected specific resolutions in the resolution filter: In this case, sub-tasks with resolutions different to the ones selected in the filter, will be completely ignored by this validator.
Ignore unsatisfied validator on field values	Check this option in the two cases: You have left the field value blank: In this case you want to ignore the field value filter and basically make sure that the other criteria you specify must be met in order for the validator to pass, regardless of the field values. You have specified field values in the field value filter: In this case, sub-tasks with field values different to the ones selected in the filter, will be completely ignored by this validator.

UI Expand

title	Validation options

Include Page

	DECADIS:_snip_skip validation
	DECADIS:_snip_skip validation

UI Expand

title	Error message

Include Page

	DECADIS:_snip_error_message_validator
	DECADIS:_snip_error_message_validator

UI Text Box

type	tip

If you want to use this functionality in a condition instead, have a look at the following condition: Condition on sub-tasks

Use cases and examples

Page properties report

cql	label = "use-case" and space = currentSpace() and parent = "32215662"

Excerpt Include

	DECADIS:Contact support
	DECADIS:Contact support
nopanel	true

Page properties

hidden	true

Status

Tech review

Status

colour	Green
title	done

Style guide

Status

colour	Yellow
title	Ready for review

Status

title	todo

Status

colour	Yellow
title	Ready for review

Status

colour	Green
title	done

Status

colour	Red
title	flagged

Page properties

hidden	true

Short description	Evaluate the current state (type, status, number, etc.) of sub-tasks.
Label

Content

Space Tools

Versions Compared

Old Version 7

New Version 8

Key

Configuration

Examples

Use cases and examples