Merge pull request #56 from puzzle/rocket-send

add rocketSend function

README.md

@@ -38,6 +38,10 @@ Requests OpenShift to start build from the specified build config and waits for
 
 Runs the OWASP dependency-check tool.
 
+### rocketSend
+
+Sends message to the specified WebHook.
+
 ## Groovy source files
 
 ### DockerHub

vars/rocketSend.groovy

@@ -0,0 +1,22 @@
+def void call(String webHook, String message, String avatar = null, Boolean rawMessage = true) {
+    Map data = [:] as Map
+    data['text'] = message
+    data['rawMessage'] = rawMessage
+
+    if (avatar != null) {
+        data['avatar'] = avatar
+    }
+
+    def curlCommand = 'curl ' +
+            '     -X POST "' + webHook + '" ' +
+            '     -H "Content-Type: application/json" ' +
+            '     --data \'' + groovy.json.JsonOutput.toJson(data) + '\' '
+
+    def returnCode = sh(script: curlCommand, returnStatus: true)
+
+    if (returnCode != 0) {
+        error("RocketChat notification failed!")
+    } else {
+        echo "RocketChat notification sent successfully"
+    }
+}

vars/rocketSend.txt

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<p>
+    Part of <code>@Library('jenkins-pipeline-shared-libraries')</code>
+</p>
+<dl>
+    <dt>
+        <code id="rocketSend">rocketSend(webHook:String, message:String, avatar:String=null, rawMessage:Boolean=true):void</code>
+    </dt>
+    <dd>
+        <p>
+            Publish message at chat.puzzle.ch. The channel destination is disabled for the integration. Therefore you need to create the Webhook first.
+            <br />
+            Example call:
+            <br>
+            <code>rocketSend("https://chat.puzzle.ch/hooks/../..", "Build Successful", "https://chat.puzzle.ch/emoji-custom/success.png", true)</code>
+        </p>
+        <ul>
+            <li>
+                <b>webHook</b> - WebHook Url
+            </li>
+            <li>
+                <b>message</b> - Content of the Rocket Chat message
+            </li>
+            <li>
+                <b>avatar</b> - Avatar image used in Rocket Chat
+            </li>
+            <li>
+                <b>rawMessage</b> - Message should be sent as raw text
+            </li>
+        </ul>
+    </dd>
+</dl>
+<!-- vim: set ft=html : -->
+<!-- code: set language=html : -->