Administration
There are 2 steps involved in setting up approvals using Easy Approval For Jira:
1. Setting up a rule
Please follow the steps mentioned below to configure a rule in Easy Approval For Jira for the project in which you wish to use the application:
Visit the Project where you want to configure Easy Approval for Jira.
Go to the “Project Settings“.
In the left hand side panel, scroll down to the Apps section.
Click on click on Easy Approval for Jira. You may see the following screen asking you to allow the app to access Atlassian products on your behalf
Click on Allow access.
You will be presented with the following screen:
Click on Add New Rule to configure a rule. You will be presented with following screen where you need to provide the details for your rule:
Rule Name: Enter a name for your rule.
Select issue type for Rule: Select the issue type for which you want to apply this rule.
Select from status: Select the status from which your transition is originating.
Select to status: Select the destination status of your transition.
Select reject status: Select the destination status of your transition on rejection of approval.
Approval classifier: Select who can approve the transition. Here there are 2 options:
Project Role: Select this if you want all the users who are assigned a selected role to be able to approve.
User Picker Field: Select this if you want to select user(s) from a User Picker Field to be able to approve the transition.
Project role: Select the project role which you want to be able to approve the transition.
All users or Any user:
Select “All users“ if you want the approval to be done only if all the users from the selected role/ user picker field have given the approval
Select “Any user“ if you want the approval to be done if any of the users from the selected role/ user picker field have given the approval.
A sample completed form is presented below:
Allow auto transition of issue: Select if you want the issue to be automatically transitioned on successful approval.
Clear existing approvals on rejection: Select if you want to clear the existing approvals if an approval is rejected.
Logging Text Field: Select the custom field you want to use to record approver logs. Please make sure that this custom field is available in the appropriate screens and screen schemes.
Error Message: Enter the error message which should be displayed when a rule fails.
Click on Save.
2. Adding Validator to the transition.
Once a rule has been setup, a validator needs to be added in the corresponding transition (for which the rule has been configured).
In order to add the validator,
edit the corresponding workflow
go the transition for which the rule has been configured
Add a Validator - Select “Easy Approval for Jira Validator“
Save/ publish the workflow.
If you want to reset the approval when reverse transition is done, you can add the validator “Easy Approval for Jira Reset“