HAPI Examples

1. From ScriptRunner go to Listeners > Create Listener. 
2. Select Custom listener. 
3. Add an optional note to describe the listener. In this example, we enter Automatically add users as watchers.
4. Select the project/s the listener should trigger for. In this example, we choose Global (All projects).
5. Select IssueLinkCreatedEvent under Events.

6. Enter the following script into the script editor:
   

   final LINK_TYPE = "Problem/Incident"
   
   def link = event.getIssueLink()
   def outwardIssue = link.destinationObject
   def inwardIssue = link.sourceObject
   
   if (link.issueLinkType.name == LINK_TYPE) {
       def requestParticipants = outwardIssue.requestParticipants
       def usersToAdd = requestParticipants ? [*requestParticipants, outwardIssue.reporter] : [outwardIssue.reporter]
       usersToAdd.each { user ->
           inwardIssue.addWatcher(user)
       }
   }

   Copy

7. Select Add. 

Test

You can now test this example by linking one issue to another using causes or is caused by link type. The reporter, and if applicable, request participants, are added as watchers to the issue that causes the linked issue.

1. From ScriptRunner go to Fields > Create Script Field. 
2. Select Custom Script Field. 

3. Enter the name for the custom script field. In this case we name the custom field Impact.

   If you already have a custom field with the name Impact, we recommend you choose a different name to avoid conflict.

4. Enter the description for the custom script field. In this case we enter Issue Impact calculated from the number of linked support cases.
5. Optional: Add an note to the Field Note field.
6. Select the Text Field(multi-line) template.

7. Enter the following script into the script editor:

   import com.atlassian.jira.project.type.ProjectTypeKeys
   
   def countOfLinkedSupportCases = issue.outwardLinks.count {
       it.issueLinkType.outward == "causes" && it.destinationObject.projectObject.projectTypeKey == ProjectTypeKeys.SERVICE_DESK
   }
   
   switch (countOfLinkedSupportCases) {
       case { it >= 25 } -> "Critical Impact"
       case { it >= 12 } -> "High Impact"
       case { it >= 6 } -> "Moderate Impact"
       case { it >= 3 } -> "Low Impact"
       default -> "Minimal Impact"
   }

   Copy
8. Optional: Enter an issue key for preview.
9. Optional: Select Preview to preview the custom field. 
10. Select Add.

11. Configure the context and the screens by following the links provided in the popup that appears after you have created the new field.
    

    You can also configure the context and the screens for script field from the Actions ellipses menu on the Script Fields page.

Test

You can check this example works by going to a given issue that this custom field is configured to. 

You can also easily find all issues with a given impact using the following JQL search:

text
Impact ~ "Critical Impact"

1. From ScriptRunner go to Workflows > Create Workflow Function. 
2. Select an approval workflow for the workflow function to be added to.
3. Select a suitable Create transition. In this example we select Create issue (Initial → Waiting for approval).
4. Select the Post function workflow function type.
5. Select Create.
   
6. Select Custom script post-function.
7. Add an optional note to describe the listener. In this case we add Automatically add reviewers based on the issue request type.

8. Enter the following script into the script editor:

   If you're using the exact example below, make sure you replace the users with usernames that exist in your instance. 

   /*This is a map of request-Type -> Request Reviewers*/
   def requestTypeToApprovers = [
       "Purchase over \$100": ["financeTeamUser", "lineManagerUser"],
       "Travel request"     : ["travelTeamUser", "lineManagerUser"]
   ]
   
   if (issue.issueType.name == "Service Request with Approvals") {
       def requiredApproverNames = requestTypeToApprovers[issue.requestType?.name]
   
       if (requiredApproverNames) {
   
           issue.set {
               setCustomFieldValue('Approvers') {
                   requiredApproverNames.each {
                       add(it)
                   }
               }
           }
       }
   }

   Copy

9. Select Add. 
   You are taken to the workflow page for the transition you are adding this function to. 
10. Check you are happy with the changes to the transition and select Publish.
    

Test

You can check this example works by raising a request a checking that the approvals have been added.