Overview

Anchor
overviewRc overviewRc

The Conditional Rules Administration screen let you able to create Conditions that you can apply on: 

• Approval Mappings and Single Issue Approval configurations, in order to

  • Require

• • the approvals, only if the condition returns true

  • Let transition the issue if the condition returns true depending by the number of approbations or rejections

Notice that you can reuse a Conditional Rule across different Approval Mappings

, Single Issue Approval

Preliminary Settings

Anchor
preliminarySettingsRc preliminarySettingsRc

A conditional rule needs that you setup the user that the app uses to evaluate if the configured JQL returns true or false.

In order to evaluate a Jql properly, the used user must have Browsing permission on the concerned project.

You are able to setup a Superuser to use on any Conditional rule configuration by navigating on  Manage apps → Herzum Approval → Global Configuration → Approval Superusers → Conditional Rule Superuser:

Image Added

Conditional Rules Administration screen

Anchor
conditionalRulesAdministration conditionalRulesAdministration

The Conditional Rules Administration screen allows you to add, edit, delete and review your  Conditional Rule configurations.

Image Added

Furthermore, when moving the mouse upon the data under the Assigned Mapping columns , a window, detailing when the Conditional Rule is applied, shows up.

How to create a Conditional Rule

Anchor
createConditionalRule createConditionalRule

You are able to create a conditional rule by following the steps below:

1. Navigate on the Conditional Rules Administration screen and click Add Conditional Rule

2. Fill the fields  showing up on the Conditional Rule Configuration screen

1. • Rule Name (Required)

   • Conditional Rule (Required), the field expects a valid query using the Jira Query Language (JQL) 

   • User used to evaluate the conditional rule, you have to choose the user that the app will use to evaluate the jql; available options are

     • Super User, the Conditional Rule is evaluated via the credential of the user selected on the Global Configuration → Approval Superusers → Conditional Rule Superuser

     • Current User, the Conditional Rule is evaluated via the logged user

     • Reporter, the Conditional Rule is evaluated via the issue's reporter

     • Assignee, the Conditional Rule is evaluated via the issue's assignee

     • Project Lead, the Conditional Rule is evaluated via the project lead

     • Select user, the Conditional Rule is evaluated via the selected user

2. Click Save. 

Editing a Conditional Rule

Anchor
editingConditionalRule editingConditionalRule

You are able to update an existing Conditional Rule.

Deleting a Conditional Rule

Anchor
deletingConditionalRule deletingConditionalRule

When deleting a Conditional Rule, the application asks to confirm:

Image Added

Invalid Conditional Rule

Anchor
invalidConditionalRule invalidConditionalRule

Conditional Rule validity  is based on the following variables:

• Validity of the User used to evaluate the conditional rule

• Validity of the Conditional Rule JQL.

When a conditional rule is invalid the Approvals panel on the issue shows the following message:

You don't have any approval mapping to this issue type in this status

In order to understand the reason why a conditional rule is invalid or for provisioning its result for a specific issue, you are able to Run test.

Examples

Image Added

Image AddedImage AddedImage AddedImage Added