Linked Work Items Validator | Dependency Governance Documentation

Linked Work Items Validator documentation.

The Linked Work Items validator is a Jira workflow rule that checks work item links when a transition is performed.

If the work item does not meet the configured conditions, the transition is blocked and the user sees an error message.

Image{.img-center .img-medium}

Purpose

The validator is designed to:


Where It Is Available

The validator is available in the Jira workflow editor:

  1. Open the workflow and select a transition
  2. Add a rule and choose Validate details → Linked Work Items Validator
  3. Configure the Validation mode and save the workflow

Each transition can use its own validator configuration.
ㅤ


Validation Modes

The validator supports two modes:

Mode What it checks
Links allowed by link scheme All links of the work item comply with the configured Link Schemes
Number of matching links The number of links matching selected criteria is within a required range
ㅤ

Mode: Links Allowed by Link Scheme

Checks all links of the work item against the link rules configured in Dependency Governance.

Behavior

Typical Use

Image{.img-center .img-large}

→ See: Control Work Item Links


Mode: Number of Matching Links

Counts the links that match the selected criteria and checks whether the number is within the required range.

Settings

Link type

Link direction

Linked work type

Required number of links

How Links Are Counted

Behavior

Examples

Goal Configuration
Require at least one blocking Bug Link type: Blocks, Direction: Both, Work type: Bug, Minimum: 1
Allow at most 3 links of any type Link type: Any, Work type: Any, Maximum: 3
Forbid any Blocks links to Bugs Link type: Blocks, Work type: Bug, Maximum: 0
Require exactly 2 linked work items of any kind Link type: Any, Work type: Any, Minimum: 2, Maximum: 2

Image{.img-center .img-large}


Summary View

After configuration, the Summary tab shows a short description of what the validator checks, for example:

Below the description, a table lists all configured settings.


Error Message

When the validator blocks a transition, an error message appears on the transition screen or, if the transition is attempted elsewhere (for example, on a board or in a list), as a toast notification. The message depends on the validation mode:

To proceed, the user must:

The Dependencies Panel highlights invalid links, which makes them easy to find and fix.


Notes


Permissions

Configuring the validator requires:


Related Pages