Condition - Checklist condition

available since 6.2.0

The Checklist condition verifies whether checklist items match certain criteria.

In summary, here is how the Checklist condition is processed for an issue:

  1. Obtain a list of all items from all of the selected checklist fields.

  2. Filter the items based on the item filters.

  3. Match the condition to the filtered items.

On this page:

Configuration

The following table describes the Checklist condition’s fields:

Field

Description

Field

Description

Checklists

The checklists that the items are obtained from. These items are then filtered and matched to the condition.

Condition

The condition applied to the filtered items. If the issue has no items in the selected checklist(s), or if the items are all filtered out, the condition will not pass.

Item filters

A set of filters applied to the items obtained from the Checklists field for the current issue. This is useful for cases where you only want to match a condition to a subset of items.

Conditions

The following table describes the possible conditions:

Condition

Description

Condition

Description

All items are checked

All of the filtered items must be checked.

All items are unchecked

All of the filtered items must be unchecked.

All items have statuses

All of the filtered items must have a status.

No items have statuses

None of the filtered items must have a status.

All items are assigned

All of the filtered items must be assigned.

All items are unassigned

None of the filtered items must be assigned.

Minimum checked count

When selected, an extra field will appear in which you can enter the minimum number of filtered items that must be checked.

The value of the extra field must be greater than 0.

Minimum percentage checked

When selected, an extra field will appear in which you can enter the minimum percentage of filtered items that must be checked.

The value of the extra field must be greater than 0 and less than or equal to 100.

Item filters

You can use item filters to target a subset of items to match to a condition. You can apply multiple filters to further narrow down a subset of items.

All item filters are combined and applied at the same time to the items obtained from the issue.

Adding an Item Type filter for Global items and a Checked state filter that is enabled will result in the condition only matching the items that are Global and checked.

The following table describes the possible item filters:

Item filter

Value

Item filter

Value

Item type

  • Global items: Local items will be filtered out.

  • Mandatory items: Optional items will be filtered out.

  • Optional items: Mandatory items will be filtered out.

Checked state

  • Enabled: Unchecked items will be filtered out.

  • Disabled: Checked items will be filtered out.

Status

Items whose status ID does not exactly match the entered value will be filtered out.

See https://okapya.atlassian.net/wiki/spaces/CHKDOC5/pages/1966080093 for more information on statuses and where to find their ID.

Item name

Items whose name, excluding the description but including the Markdown, does not match the entered regular expression will be filtered out.

For help with regular expressions, see Java Regular Expressions from w3schools.


SERVER documentation (On Cloud? Go here.)
Have questions? Contact our Service Desk for help anytime.