Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
bgColor#F4F5F7

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.

Submit a support request

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
addMapping
addMapping

Follow the steps below to create new Approval Mappings per selected Project and Issue Type

  1. Click Add Approval Mapping to create new Approval Mappings

image-20240402-154159.png

  1. Fill the field Project and click Next

image-20240402-154441.png

  1. Fill the field Issue Type and click Next

image-20240402-154610.png

  1. Select a workflow transition and click Next

image-20240402-154659.png

  1. 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
panelIconIdatlassian-warning
panelIcon:warning:
bgColor#FFFFFF

Having more than 6 approvals can potentially cause delays in loading the issue panel.

Screenshot 2024-07-02 1556.png

  1. Check that the approval mapping configuration is correct in the summary, and click Save if all is correct

Screenshot 2024-07-02 161202.png

Advanced Settings
Anchor
advancedSettings
advancedSettings

Automatic Workflow transition
Anchor
automaticWorkflowTransitionC
automaticWorkflowTransitionC

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)

image-20240402-155139.png

Automatic Approval Request Notification via email
Anchor
automaticApprovalRequestNotificationViaEmailC
automaticApprovalRequestNotificationViaEmailC

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.

image-20240402-155339.png

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.

image-20240729-221806.pngImage Added

Require Approval Comment
Anchor
requireApprovalCommentC
requireApprovalCommentC

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.

image-20240402-160004.png

Sequential approval
Anchor
sequentialApprovalC
sequentialApprovalC

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.

image-20240402-160211.png

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).

image-20240402-160355.png

Optional approvals
Anchor
optionalApprovalsC
optionalApprovalsC

Select Optional Approvals in order to choose the Optional Approvals.

image-20240402-160506.png

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).

(info) 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
conditionApprovalMappingC
conditionApprovalMappingC

Select Condition enabling/disabling the approvals in order to enable the approvals when the Conditional Rule, evaluated on the issue, returns true.

image-20240402-160609.png

Abstain
Anchor
abstainApprovalMappingC
abstainApprovalMappingC

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.

image-20240402-161013.png

Super Approvers
Anchor
superApproversC
superApproversC

Select Super Approvers in order to Setup expressions identifying the Super Approvers.

image-20240402-161216.png

Transition on rejecting
Anchor
transitionRejectingC
transitionRejectingC

Select Transition on rejecting in order to select the transition to perform on rejecting.

image-20240402-161503.png

⚠ 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
eMailTemplatesC
eMailTemplatesC

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.

image-20240402-161712.png

Approval Reply Notification Scheme
Anchor
approvalReplyNotificationSchemeC
approvalReplyNotificationSchemeC

Select the Approval Reply Notification Scheme option in order to choose the Approval Reply Notification Schema to apply when notifying the Approval Reply emails.

image-20240402-161804.png

Minimum Required approbations/rejections
Anchor
minimumRequiredAMC
minimumRequiredAMC

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
upsateIssueAssigneeC
upsateIssueAssigneeC

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.

image-20240402-161933.png

Approval Status shows on Customer Portal
Anchor
approvalStatusShowsCP
approvalStatusShowsCP

This setting allows to enable the approval status view on the Customer Portal.

image-20240402-162148.png

Example

image-20240402-162650.png

If there are no active approval mappings on the issue or if this feature is disabled, the following message is displayed on the portal.

image-20240729-222237.pngImage Added

Approval Buttons show on Customer Portal
Anchor
approvalButtonsShowCP
approvalButtonsShowCP

This setting allows to enable the approval buttons on the Customer Portal++

image-20240402-162843.png

Example

image-20240402-163047.png

Select approval groups based on conditional rules
Anchor
approvalGrouosBasedonCR
approvalGrouosBasedonCR

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.

image-20240402-163552.png

Notify approval via comment
Anchor
Notify-approval-via-comment
Notify-approval-via-comment

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.

image-20240402-163751.png

Example

image-20240119-215941.pngimage-20240119-220029.png