Panel | ||
---|---|---|
| ||
All administrative functions of Herzum Approval require you to be a user with the Jira Cloud System Administrators global permission. |
Info |
---|
Need support? We would love to help. |
Info |
---|
This configuration is for company-managed projects. If you want to configure conditional rules for team-managed projects, check out this documentation instead. |
In this section
Table of Contents |
---|
Add Mapping
Anchor | ||||
---|---|---|---|---|
|
Follow the steps below to create new Approval Mappings per selected Project and Issue Type
Click Add Approval Mapping to create new Approval Mappings
Fill the field Project and click Next
Fill the field Issue Type and click Next
Select a workflow transition and click Next
Select the Available Approvals and click Next.
Approval mappings are limited to 20 approvals to maintain optimal loading speed and application performance. It is crucial to understand that setting up various approvals using both "Group picker all" and "User picker all" properties within the same mapping is not supported.
Panel | ||||||
---|---|---|---|---|---|---|
| ||||||
Having more than 6 approvals can potentially cause delays in loading the issue panel. |
Check that the approval mapping configuration is correct in the summary, and click Save if all is correct
Advanced Settings
Anchor | ||||
---|---|---|---|---|
|
Automatic Workflow transition
Anchor | ||||
---|---|---|---|---|
|
The Setup Automatic workflow transition allows you to enable:
the Automatic transitioning of the issue based on received approbations (by default All approbations)
the Automatic transitioning of the issue based on received rejections (by default All rejections)
Automatic Approval Request Notification via email
Anchor | ||||
---|---|---|---|---|
|
The Setup Automatic Approval Request notification screen allows to notify approvers automatically via email of a new pending approval request.
The notification is sent once when the issue moves in the selected Source Workflow Status.
Info |
---|
If the approval mapping includes the sequential approval option, email notifications will be triggered for each approval when the approval buttons are enabled. |
For JSM projects, automatic approval request notifications can be triggered from the customer portal when the Approval Status shows on Customer Portal option is enabled in the approval mapping and the ticket is opened.
Require Approval Comment
Anchor | ||||
---|---|---|---|---|
|
The Setup Require Approval Comment screen allows to require that the approver inserts an approval comment to justify the approval decision.
This setting is effective for approval responses provided via email and via issue web panel.
Sequential approval
Anchor | ||||
---|---|---|---|---|
|
Select Sequential Approval in order to enable the sequential approval.
It causes that the approval decision must be submitted in the order established on the requested approvals column.
You can choose to submit for approval the subsequent approval independently by the response gets on the preceding approval or only case of it gets an approbation (Default).
Optional approvals
Anchor | ||||
---|---|---|---|---|
|
Select Optional Approvals in order to choose the Optional Approvals.
The Optional Approvals consist of particular Approvals that case of they don't get the vote, the Approval is not considered but if they get the vote, their vote is considered same than other to evaluate the result of the approval stage.
By Default All approvals are considered Mandatory.
If an issue requires at least one Optional Approval, the app behaves as described below:
When no ‘minimum required approbations/rejection (conditioned and unconditioned)’ exists
the app allows the transition only when All Requested Approvals (with the exclusion of Optional Approvals replies) have been approved/rejected
When any ‘minimum required approbations/rejection (conditioned and unconditioned)’ exists, the app evaluates the available settings as follows:
All,the app allows the transition only when All Approvals (with the exclusion of Optional Approvals that have not gotten any reply) have been approved/rejected
Fixed Number, the app allows the transition only when the number of approvals has been reached (it includes either the optional and the mandatory approvals)
Percentage, the app allows the transition only when the percentage of approbations allowing to transition has been reached ( the percentage is evaluated counting the mandatory approvals and the optional approvals having replied).
E.g. Case of it's requested the 50% of approbations to transition, If the evaluation of the formula Count(approbations)/[Count(Requested Approvals)- Count (Optional Approvals) + Count (Replied Optional Approvals)] is >= 50%, the transition is unlocked.
Condition enabling/disabling the approvals
Anchor | ||||
---|---|---|---|---|
|
Select Condition enabling/disabling the approvals in order to enable the approvals when the Conditional Rule, evaluated on the issue, returns true.
Abstain
Anchor | ||||
---|---|---|---|---|
|
Select Abstain in order to enable or disable the Abstain option for the specific Mapping.
On enabling this option you allow to approvers to abstain from taking the approval decision.
An abstention is evaluated as an agreement to the decision taken by the votes of all the other approvers.
This setting overrides the Abstain Global setting.
Super Approvers
Anchor | ||||
---|---|---|---|---|
|
Select Super Approvers in order to Setup expressions identifying the Super Approvers.
Transition on rejecting
Anchor | ||||
---|---|---|---|---|
|
Select Transition on rejecting in order to select the transition to perform on rejecting.
⚠ In order to transition the issue on the selected Transition on Rejecting you must enable the Automatic Workflow Transition on rejection.
E-Mail Templates
Anchor | ||||
---|---|---|---|---|
|
Select the E-Mail Templates option in order to choose the email templates to apply when notifying the Approval Request and an Approval Reply emails.
Approval Reply Notification Scheme
Anchor | ||||
---|---|---|---|---|
|
Select the Approval Reply Notification Scheme option in order to choose the Approval Reply Notification Schema to apply when notifying the Approval Reply emails.
Minimum Required approbations/rejections
Anchor | ||||
---|---|---|---|---|
|
You can setup the Minimum Required approbations and rejections conditioned or unconditioned rules to specify if the approval step can be considered approved or rejected based on subset of stakeholders reply.
Navigate on Minimum Required approbations and rejections page for further information and examples regarding this setting.
Update Issue Assignee
Anchor | ||||
---|---|---|---|---|
|
This option allows you to update the issue assignee when the approval mapping configured has only one approval and the selected approval property is a userpicker.
Approval Status shows on Customer Portal
Anchor | ||||
---|---|---|---|---|
|
This setting allows to enable the approval status view on the Customer Portal.
Example
If there are no active approval mappings on the issue or if this feature is disabled, the following message is displayed on the portal.
Approval Buttons show on Customer Portal
Anchor | ||||
---|---|---|---|---|
|
This setting allows to enable the approval buttons on the Customer Portal++
Example
Select approval groups based on conditional rules
Anchor | ||||
---|---|---|---|---|
|
This configuration allows you to group approvals based on conditional rules, for example, if you have approvals A, B and C, and you have conditional rules 1 and 2, if you select conditional rule 1 and configure approvals A and B within it, approvals A and B will be displayed only when rule 1 is fulfilled. In the case of conditional rule 2, it will only show the approval C when the conditional rule is fulfilled. In case you do not configure any approval within a conditional rule it will be shown normally. The maximum number of conditional rules allowed per approval mapping is 20.
Notify approval via comment
Anchor | ||||
---|---|---|---|---|
|
The Setup Notify approval via comment screen allows to enable the approval reply via comment, so that the app processes added comments in order to trigger the approval action, when the comment is a valid response.
Example