{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Below are some sample Webhook Listener use cases and how to implement them. ","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"4f0ae448-1059-4902-9c2a-3678f6290763"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}}}},{"type":"heading","attrs":{"level":3},"content":[{"text":"The Default Listener (POST Webhook)","type":"text"}]},{"type":"paragraph","content":[{"text":"When creating a new Listener, the script will default to the below which simply forwards the payload via a REST Post request. This script emulates an outbound webhook in the truest sense since no payload modification or logic is done. Simply update the ","type":"text"},{"text":"postUrl","type":"text","marks":[{"type":"strong"}]},{"text":" variable with your endpoint and its ready to go.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1914,"id":"93753aed-043e-4a5c-b422-32d7a609c4d4","collection":"contentId-2078605353","type":"file","height":669}}]},{"type":"expand","attrs":{"title":"Example Groovy Code"},"content":[{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"//Carry out any custom action you wish for this event. Check out the documentation for reference or ideas.\n//Optionally filter out events you dont want to execute by returning false on the filter script tab.\ndef listenerName = \"myListener\";\nLOG.info(\"Running listener: ${listenerName}\");\n\ndef postUrl = \"\";\ndef responseCode = REST.forward(postUrl,EVENT);\n\nLOG.setMessage(\"Message forwarded (${responseCode}) to ${postUrl}\");","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"End Release After Snapshot Deploys to Production","type":"text"}]},{"type":"paragraph","content":[{"text":"To take advantage of ending a release after a pipeline execution completes you can create a new listener and select the ","type":"text"},{"text":"Pipeline Stage Completed","type":"text","marks":[{"type":"strong"}]},{"text":". You will then need to check whether the completed stage is the final stage in the pipeline. You can do this in a number of ways. One way is shown below by checking the environment code and comparing it to our final PROD stage.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1920,"id":"5d3bb492-c0fc-4c6f-b23a-0f19ef89d932","collection":"contentId-2078605353","type":"file","height":410}}]},{"type":"paragraph"},{"type":"expand","attrs":{"title":"Example Groovy Code"},"content":[{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"//Carry out any custom action you wish for this event. Check out the documentation for reference or ideas.\n//Optionally filter out events you dont want to execute by returning false on the filter script tab.\ndef listenerName = \"endReleaseListener\";\nLOG.info(\"Running listener: ${listenerName}\");\n \nif(EVENT.payload.environment.environmentCode.equals(\"PROD\")){\n LOG.setMessage(\"Release ${EVENT.payload.release.releaseName} has completed moving through the pipeline. Ending release.\");\n FLEXDEPLOY.endRelease(EVENT.payload.release.releaseId);\n}","type":"text"}]},{"type":"paragraph"}]},{"type":"paragraph","content":[{"text":"Another way to take advantage of this is to use the Webhook Listener’s filter. This filter is also groovy script where you can determine whether the event should be processed by the Listener. In this example, we will filter the events so that only pipeline stage completed events that have completed the Prod stage in the pipeline are allowed through.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Logically, both approaches will accomplish the same task, however, using the Filter will automatically hide it from the Outgoing Webhook Messages display. This will reduce some of the noise and allow you to easily find the messages you care about.","type":"text"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1920,"id":"f0b99013-e2e6-46a6-b827-dea9e9113e2c","collection":"contentId-2078605353","type":"file","height":414}}]},{"type":"expand","attrs":{"title":"Pipeline Stage Completed Filter"},"content":[{"type":"codeBlock","content":[{"text":"if(!EVENT.payload.environment.environmentCode.equals(\"PROD\")){\n return false;\n}else{\n return true;\n}","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Send a Slack Notification After Approval Task Is Created","type":"text"}]},{"type":"paragraph","content":[{"text":"This will send a notification to the specified slack channel when an approval task is created. To implement this you will simply need to set up your Slack Messaging Account and add a short script to your listener. In this example we are filtering for APPROVAL tasks only.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"For a more comprehensive overview of how you can integrate Slack with your FlexDeploy Approval process check out this ","type":"text"},{"text":"blog","type":"text","marks":[{"type":"link","attrs":{"href":"https://flexagon.com/flexdeploy-approvals-with-slack/"}}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1912,"id":"55c039c0-0fd4-4d2c-8388-0e3dd2c9e344","collection":"contentId-2078605353","type":"file","height":515}}]},{"type":"paragraph"},{"type":"expand","attrs":{"title":"TaskCreated Script"},"content":[{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"//Carry out any custom action you wish for this event. Check out the snippets for reference or ideas.\ndef listenerName = \"TaskCreated\";\nLOG.info(\"Running listener: ${listenerName}\");\n\ndef channel = 'testing';\n\n//Slack account code defined in Topology->Integration->Messaging\ndef account = 'SLACK';\n\n//Create and post a FlexDeploy Slack Message object with interactive buttons to approve/reject\ndef message = SLACK.makeTaskCreatedMessage(EVENT.payload,true);\ndef tsId = SLACK.postMessage(account,channel,message);\n\nLOG.setMessage(\"Posted task ${EVENT.payload.taskId} to Slack\");","type":"text"}]}]},{"type":"expand","attrs":{"title":"TaskCreated Filter"},"content":[{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"return EVENT.payload.taskType == \"APPROVAL\";","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Attach Failed Plugin Logs to Jira Issue","type":"text"}]},{"type":"paragraph","content":[{"text":"One of the bigger use cases of the Workflow Completed event is to send the logs to another application. In this particular example we are uploading the logs to the Jira Issue associated to the project. We also have a filter setup to only execute this listener for workflows with a ‘FAILURE’ status and when the Workflow Execution has Jira Issues associated.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"This script uses ","type":"text"},{"text":"FLEXDEPLOY.getIntegrationInstance","type":"text","marks":[{"type":"strong"}]},{"text":" to get a configured Jira instance within FlexDeploy. This is a great alternative to putting a plain text password in the script","type":"text"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1530,"id":"4018664f-7d27-44fa-bfad-a5289cad6309","collection":"contentId-2078605353","type":"file","height":651}}]},{"type":"paragraph"},{"type":"expand","attrs":{"title":"Upload Logs Jira Listener Script"},"content":[{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"import flexagon.ff.common.core.exceptions.FlexCheckedException;\n\n//Carry out any custom action you wish for this event. Check out the snippets for reference or ideas.\ndef listenerName = \"Upload Logs To Jira\";\nLOG.info(\"Running listener: ${listenerName}\");\n\n//Prior to 5.4.0.1 this function only returned a list of input streams. Update accordingly\n//The second argument specifies we only want the error streams returned.\ndef streams = FLEXDEPLOY.getPluginLogInputStreams(EVENT.payload.workflowExecutionId, true);\n\n//upfront validation on streams\nif(!streams || streams.size() == 0) {\n LOG.logMessage(\"Received failure event but couldn't find any plugin log streams\");\n return;\n}\n\n//We should only ever have one errored plugin execution, so grab first entry.\ndef failedPlugin = streams.entrySet().iterator().next();\n\n//create our form data body\ndef body = REST.getClient().createFormDataWithInputStream(['file': failedPlugin.getValue()], \"${failedPlugin.getKey()}.txt\");\n\ndef properties = getJiraProperties('JIRA');\n\nLOG.info(\"${EVENT.payload.issueNumbers}\");\n\nfor(def issue: EVENT.payload.issueNumbers) {\n LOG.info(\"Upload logs to issue: ${issue}\");\n \n //send request\n def client = REST.getClient().url(properties.url).addHeader('X-Atlassian-Token', 'no-check').basicauth(properties.user,properties.password);\n def response = client.path(\"/rest/api/2/issue/${issue}/attachments\").post(body);\n LOG.setMessage(\"Uploaded logs to ${issue}. Response: ${response.getResponseCode()}\");\n}\n\n//helper function to get jira properties from integration instance\ndef getJiraProperties(String code) {\n def instance = FLEXDEPLOY.findIntegrationInstance(code,'ITS');\n def properties = instance.getProperties();\n def url = properties.find { it.getPropertyName() == 'JIRA_URL' }.getPropertyValue();\n def user = properties.find { it.getPropertyName() == 'JIRA_USER_NAME' }.getPropertyValue();\n def password = properties.find { it.getPropertyName() == 'JIRA_PASSWORD' }.getPropertyValue();\n return ['url':url, 'user': user, 'password': password];\n}\n","type":"text"}]}]},{"type":"paragraph","content":[{"text":"The next step is to set up our filter to only process failed workflow completed events with Jira issue numbers. ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1914,"id":"a7a0a929-e87b-46dd-a0cd-2eba7ed77869","collection":"contentId-2078605353","type":"file","height":580}}]},{"type":"paragraph"},{"type":"expand","attrs":{"title":"Workflow Completed Filter"},"content":[{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"return \"FAILURE\".equals(EVENT.payload.executionStatus) && EVENT.payload.issueNumbers.size() > 0;","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Create ServiceNow Incident on Workflow Failure","type":"text"}]},{"type":"paragraph","content":[{"text":"In the below example we make use of the ChangeManagementSystemService to allow us to create an incident through FlexDeploy’s internal ServiceNow integration. The only thing that needs to be configured ahead of time is your ServiceNow instance in ","type":"text"},{"text":"Topology->Integrations->ChangeManagement","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1907,"id":"b9e00885-912c-4aca-9568-49bd293aff2c","collection":"contentId-2078605353","type":"file","height":620}}]},{"type":"expand","attrs":{"title":"Create Incident Script"},"content":[{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"//Carry out any custom action you wish for this event. Check out the documentation for reference or ideas.\n//Optionally filter out events you dont want to execute by returning false on the filter script tab.\ndef listenerName = \"Create Incident\";\nLOG.info(\"Running listener: ${listenerName}\");\n\n//throws FlexNotFoundException if SERVICENOW is not found\ndef cmsService = FLEXDEPLOY.findCMSService(\"SERVICENOW\",null)\n\ndef cmsFields = [:];\ncmsFields.short_description = \"Deployment failed for ${EVENT.payload.project.projectName}\";\ncmsFields.description = \"Deployment failed for ${EVENT.payload.project.projectName}. Environment ${EVENT.payload.environment.environmentName} executionid ${EVENT.payload.workflowExecutionId} requestor ${EVENT.payload.updatedBy}\";\n \nLOG.fine(\"Creating Service Now Incident ${cmsFields}\");\n\ndef cmsObject = cmsService.createIncident(EVENT.payload.workflowRequest.workflowRequestId, cmsFields);\nLOG.setMessage(\"Successfully created Service Now Incident ${cmsObject.getNumber()}\");","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Configured offscreen is a Filter script for only failed workflows. ","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Send Test Results to Teams","type":"text"}]},{"type":"paragraph","content":[{"text":"The Workflow Completed Event includes all of the test execution data for any TEST workflow type. The below example shows how this data can be used by sending a Teams message with the data neatly formatted in an html table.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1903,"id":"7a7e3d3d-a582-4276-a820-f7dd1317b943","collection":"contentId-2078605353","type":"file","height":843}}]},{"type":"expand","attrs":{"title":"Tests Completed Script"},"content":[{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"//Carry out any custom action you wish for this event. Check out the documentation for reference or ideas.\n//Optionally filter out events you dont want to execute by returning false on the filter script tab.\ndef listenerName = \"Tests Completed\";\nLOG.info(\"Running listener: ${listenerName}\");\n\ndef builder = new StringBuilder();\nbuilder.append(\"

Tests ${EVENT.payload.testRun.runStatus} for ${getProjectLink(EVENT.payload.project.projectName, EVENT.payload.project.projectId)} in ${EVENT.payload.environment.environmentName}

\");\n\nbuilder.append(\"\");\n\nEVENT.payload.testRun.testSets.each{ testSet ->\n LOG.fine(\"Processing test set ${testSet.name}\");\n \n testSet.testDefinitions.each{ testDef ->\n LOG.fine(\"Processing test def ${testDef.name}\");\n \n def testDefName = testDef.name;\n def testingTool = testDef.testingTool;\n \n testDef.results.each{ testResult -> \n def testCaseName = testResult.testCaseName;\n def status = testResult.status;\n \n builder.append(\"\");\n }\n }\n}\n\nbuilder.append(\"

Test Def Name	Testing Tool	Test Case Name	Status
${testDefName}	${testingTool}	${testCaseName}	${status}

\");\n\ndef htmlMessage = builder.toString();\n\nLOG.fine(\"Sending test results table to Teams: ${htmlMessage}\");\nMICROSOFTTEAMS.sendTeamsMessage(\"TEAMS\",\"FD Developers\",\"Testing\",htmlMessage,null);\n\nLOG.setMessage(\"Successfully sent test results message to teams for ${EVENT.payload.project.projectName}\");\n\ndef getProjectLink(String pProjectName, Long pProjectId)\n{\n String link = String.format(\"%s/flexdeploy/faces/projects?objecttype=Project&projectid=%s&projectname=%s\", FLEXDEPLOY.getFlexDeployBaseUrl(), pProjectId, pProjectName);\n return String.format(\"%s\", link, pProjectName);\n}\n","type":"text"}]}]},{"type":"expand","attrs":{"title":"Tests Completed Filter"},"content":[{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"return EVENT.payload.workflow.workflowType == 'TEST';","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Naturally you can edit the table/style in any way you wish. The below screen shot is a sample message from the listener:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":50.0},"content":[{"type":"media","attrs":{"width":981,"id":"e58c2edc-ac05-495b-bac7-bdc2c39a846a","collection":"contentId-2078605353","type":"file","height":223}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Build Dependent FlexDeploy Project ","type":"text"}]},{"type":"paragraph","content":[{"text":"This use case can be helpful when you have a FlexDeploy Project that is dependent on some other Project building first. Generally speaking you would try to handle this on the source control side of things but sometimes that just isn't possible. In the below example we are initiating a build on Project with Id 10241 only after a build has successfully completed for the Project with Id 10002.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1910,"id":"b9a516b1-ec59-456e-adff-555d646f0236","collection":"contentId-2078605353","type":"file","height":616}}]},{"type":"expand","attrs":{"title":"Build Dependent Project Script"},"content":[{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"//Carry out any custom action you wish for this event. Check out the documentation for reference or ideas.\n//Optionally filter out events you dont want to execute by returning false on the filter script tab.\ndef listenerName = \"Build Dependent Project\";\nLOG.info(\"Running listener: ${listenerName}\");\n\ndef streamId = FLEXDEPLOY.findStreamId(10241L,'master');\nFLEXDEPLOY.buildProject(streamId,10241L);\n\nLOG.setMessage(\"Successfully initiated a build for 10241\");","type":"text"}]}]},{"type":"expand","attrs":{"title":"Build Dependent Project Filter"},"content":[{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"//the project that should be built first\ndef initiator = 10002;\n\n//only run when we have a successful build of project 10002\nreturn EVENT.payload.executionStatus == \"SUCCESS\" && EVENT.payload.workflow.workflowType == \"BUILD\" && EVENT.payload.project.projectId == initiator;","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Send email with logs on Workflow Failed","type":"text"}]},{"type":"paragraph","content":[{"text":"The example below makes use of the FLEXDEPLOY.getPluginLogInputStreams method to send workflow logs as attachments in an email. The message body simply consists of the json payload for the event. ","type":"text"}]},{"type":"paragraph","content":[{"text":"This function is listening to the ‘Workflow Completed’ Event.","type":"text"}]},{"type":"expand","attrs":{"title":"Email Failed Logs Script"},"content":[{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"import flexagon.ff.adfext.common.model.pojos.communication.EmailAttachment;\nimport groovy.json.JsonOutput;\n\n//Carry out any custom action you wish for this event. Check out the documentation for reference or ideas.\n//Optionally filter out events you dont want to execute by returning false on the filter script tab.\ndef listenerName = \"Email Failed Logs\";\nLOG.info(\"Running listener: ${listenerName}\");\n\n//retrieve plugin log input stream map\ndef logs = FLEXDEPLOY.getPluginLogInputStreams(EVENT.payload.workflowExecutionId);\ndef attachments = [];\n\n//for each entry create and add a new attachment\n//prior to 5.4.0.1 logs would be a list instead of a map\nlogs.each { log -> \n attachments.add(new EmailAttachment(log.value,\"${log.key}.txt\",\"text/plain\"));\n}\n\nLOG.info(\"Sending email with ${attachments.size()} attachments.\");\n\n//send email\ndef subject = \"${EVENT.payload.project.projectName} failed in ${EVENT.payload.environment.environmentName}\";\ndef message = JsonOutput.prettyPrint(JsonOutput.toJson(EVENT.payload));\ndef recipients = [\"my.user@domain.com\"];\n\nEMAIL.sendEmail(subject, message, recipients, attachments);\n\nLOG.setMessage(\"Sent email message to ${recipients}\");","type":"text"}]}]},{"type":"expand","attrs":{"title":"Email Failed Logs Filter"},"content":[{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"return EVENT.payload.executionStatus == 'FAILURE';","type":"text"}]}]},{"type":"paragraph"}],"version":1}

Browser not supported