{"type":"doc","content":[{"type":"paragraph","content":[{"text":"This guide describes how to receive a SOAP message in iHub and process that message as a issue.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Step 1.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on Incoming Webhooks on the left side menu.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":736,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1402,"alt":"image-20250317-093252.png","id":"7690db8b-2ee4-40ec-9cb9-acf071fd4504","collection":"contentId-1400012801","type":"file","height":871}}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" In the end of the table click on Create","type":"text"},{"type":"hardBreak"},{"text":"The rule will map what action to to run","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":736,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1159,"alt":"image-20250317-093457.png","id":"a1639d52-bdcb-419f-bfec-b730a0528965","collection":"contentId-1400012801","type":"file","height":685}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Name the rule anything related to the incoming system, in our example SOAP incoming message","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For now leave the Rule HTTP response as “No Response” ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"We will add a THEN action to this rule at step 3.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click Save","type":"text"}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 2","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on Integrations","type":"text"},{"type":"hardBreak"},{"text":"Since we are going to create an issue in our Jira instance we will use an integration that performs this action.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click New button","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":584,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":584,"alt":"image-20250317-094142.png","id":"fcb1b660-b533-43ce-bf63-8adbc24ea559","collection":"contentId-1400012801","type":"file","height":584}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add a Name, e.g. SOAP to Issue","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select Action","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select a parent if you want to place this in a Group (e.g a folder), our folder is called SOAP.","type":"text"},{"type":"hardBreak"},{"text":"Note the Group needs to be created before the action is created.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select Template; Jira Core Server","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select Request Template; Create Issue","type":"text"},{"type":"hardBreak"},{"text":"This is to get a template for an issue creation","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click Create","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Now select an Authentication, for sending to Jira select a Basic auth. Our is called KG and was created before this tutorial. See ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://rixter.atlassian.net/wiki/spaces/RIFJ/pages/1310687233"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the body we paste in this code.","type":"text"},{"type":"hardBreak"},{"text":"Use tripple mustache to remove any HTML character on line 7, 8 and 10 when using the variables.","type":"text"},{"type":"hardBreak"},{"text":"Variables will be defined in Step 4.","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"{\n \"fields\": {\n \"project\":\n {\n \"id\": \"12000\"\n },\n \"summary\": \"{{{soap.example:Summary}}}\",\n \"description\": \"{{{soap.example:Description}}}\",\n \"priority\": {\n \"name\": \"{{{soap.example:Priority}}}\"\n },\n \"issuetype\": {\n \"id\": \"10004\"\n }\n }\n}","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click Save","type":"text"}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 3. Modify the Incoming Webhook rule","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click the Webhook Rules again","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click three dots, then Edit on the Rule created in Step 1.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the SOAP to Issue action in the THEN box","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":736,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1154,"alt":"image-20250317-094312.png","id":"f75dc0f1-9164-4cf1-b901-1c7393097760","collection":"contentId-1400012801","type":"file","height":481}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click Save.","type":"text"},{"type":"hardBreak"},{"text":"Note that IF condition can be added to make sure the right action is triggered. In this tutorial we only have one, but as your integration grows you can add more rules and filter by URL, DATA or User.","type":"text"}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"This concludes the incoming webhook part of receiving a SOAP message an passing it into an action that will create the issue. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Next up is the steps on how to parse the SOAP message to become variables used in the Action body as mustache variables. eg. {{summary}}, {{description}} and {{priority}}","type":"text"}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 4. Parse the SOAP message","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on Variables on the left menu","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click Groovy tab","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click Add Variable","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter the name, in our example call it soap.","type":"text"},{"type":"hardBreak"},{"text":"The variable will be accessed using {{soap.summary}}.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select “Enabled for these action(s)” in the drop down, we will select the","type":"text"},{"text":" SOAP to issue action ","type":"text","marks":[{"type":"strong"}]},{"text":"created in step 2.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Script paste the following code","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"import org.json.JSONObject\nimport org.json.XML\nimport com.fasterxml.jackson.databind.ObjectMapper\n\nint textIndent = 2\nJSONObject xmlJSONObj = XML.toJSONObject(response)\ndef jsonObject = xmlJSONObj[\"soap:Envelope\"][\"soap:Body\"][\"example:CreateIssue\"]\nObjectMapper objectMapper = new ObjectMapper()\ndef parsedObject = objectMapper.readValue(jsonObject.toString(), Map.class)","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This will parse any incoming xml as JSON and return it as a variable to use in the mustache of the Action. Note that we have pointed out the node in line 7, that might look different in other soap messages.","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"example this SOAP message","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n \n \n Fix critical bug\n This is a critical bug that needs immediate attention.\n High\n \n \n","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Will look like this, after the conversion.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n \"example:Summary\": \"Fix critical bug\",\n \"example:Description\": \"This is a critical bug that needs immediate attention.\",\n \"example:Priority\": \"High\" \n}","type":"text"}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"These are the steps to setup the integration, it should now be fully functional for getting any SOAP message.","type":"text"}]}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Note that the groovy script will try to parse the result into a JSON object, if the information in that you need is a string then remove the mapper part and it will look like this;","type":"text"},{"type":"hardBreak"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"codeBlock","attrs":{"language":"groovy"},"content":[{"text":"import org.json.JSONObject\nimport org.json.XML\n\nJSONObject xmlJSONObj = XML.toJSONObject(response)\ndef jsonObject = xmlJSONObj[\"soap:Envelope\"][\"soap:Body\"][\"someStringElement\"]","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 5. Testing","type":"text"}]},{"type":"paragraph","content":[{"text":"Testing can be done from any tool or SOAP system. We use iHub to test this integration.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create an Integration","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Name it ","type":"text"},{"text":"SOAP test incoming","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select a Basic authentication","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add this to the Body","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n Fix critical bug\n This is a critical bug that needs immediate attention.\n High\n \n \n","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Press Test button","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Result should be a new Issue created with the summary “Fix critical bug”, description “This is a critical bug that needs immediate attention.” and Priority “High”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"paragraph"}],"version":1}

Browser not supported