{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"c9631177-6c86-4719-867a-8da78a956607"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"30ca24b6-2747-469a-8383-b5e2082a2844"}},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Jira sends a JSON webhook payload to JEMHC for each issue event that occurs. JEMHC uses the event content to generate notifications. This guide shows how to extract custom data from an event and render it in your Notification Templates. Notification Template use Velocity markup for logic and variables, see the ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://velocity.apache.org/engine/1.7/user-guide.html"}},{"text":" for general syntax guidance.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Preview contexts","type":"text"}]},{"type":"paragraph","content":[{"text":"A Preview Context contains webhook event data for a previously processed event. This context allows previews of notification Templates at edit time. In this example, we'll add custom content for the resolution of an issue. By default there are only Created, Updated and Deleted event templates, so this will be a modification to the Updated event template.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Convert a received webhooks from ","type":"text"},{"text":"JEMHC > Auditing > Events","type":"text","marks":[{"type":"em"}]},{"text":", into a ","type":"text"},{"text":"Preview Context","type":"text","marks":[{"type":"em"}]},{"text":" that can be used with Template Sets.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create Custom Macro to provide detection logic and rendering of required content","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"You will access this context using ","type":"text"},{"text":"Velocity","type":"text","marks":[{"type":"em"}]},{"text":" through $context, which represents ‘all’ the data, see below for more.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Creating Preview Contexts","type":"text"}]},{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"Auditing > Events","type":"text","marks":[{"type":"em"}]},{"text":" and locate an issue event that has been processed.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1222,"id":"b7e019af-37a1-4741-86d8-0388144a94bb","collection":"contentId-40861735","type":"file","height":235}}]},{"type":"paragraph","content":[{"text":"An event entry will look something like this:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1015,"id":"b837aeb3-38ad-4dc6-922b-079b9008996b","collection":"contentId-40861735","type":"file","height":91}}]},{"type":"paragraph","content":[{"text":"Press (…) > View Event Data to show the Webhook data:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":1107,"id":"95325776-cdf5-4281-8c95-130c92f3fd62","collection":"contentId-40861735","type":"file","height":594}}]},{"type":"paragraph","content":[{"text":"Clicking the ","type":"text"},{"text":"+ Create Preview Context","type":"text","marks":[{"type":"strong"}]},{"text":" icon converts that data into a Preview Context: ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":581,"id":"78073dec-504c-48f3-b116-0a6102c591e1","collection":"contentId-40861735","type":"file","height":280}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Using Preview Contexts","type":"text"}]},{"type":"paragraph","content":[{"text":"Simplified, the webhook structure can be seen below. Full details on the webhook data structure can be found in ","type":"text"},{"text":"this Atlassian documentation","type":"text","marks":[{"type":"link","attrs":{"href":"https://developer.atlassian.com/cloud/jira/platform/modules/webhook/"}}]},{"text":".","type":"text"}]},{"type":"codeBlock","content":[{"text":" {\n \"timestamp\",\n \"webhookEvent\",\n \"issue_event_type_name\",\n \"user\": {\n --> See User shape in linked documentation\n },\n \"issue\": {\n --> See Issue shape in linked documentation\n },\n \"changelog\" : {\n --> See Changelog shape in linked documentation\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"$context","type":"text","marks":[{"type":"code"}]},{"text":" reference used in all templates represents this webhook data structure. It important to know that it is a reference to an object of type ","type":"text"},{"text":"ObjectNode","type":"text","marks":[{"type":"link","attrs":{"href":"http://fasterxml.github.io/jackson-databind/javadoc/2.3.0/com/fasterxml/jackson/databind/node/ObjectNode.html"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Post function preview contexts","type":"text"}]},{"type":"paragraph","content":[{"text":"Please see ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://thepluginpeople.atlassian.net/wiki/spaces/JEMHC/pages/3764518915"}},{"text":" for more information regarding post function event preview context behaviour.","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Working with Preview Context values","type":"text"}]},{"type":"paragraph","content":[{"text":"The values in all nodes like ","type":"text"},{"text":"$context.issue.id","type":"text","marks":[{"type":"code"}]},{"text":" result in the value shown in the webhook data. For example ","type":"text"},{"text":"\"40301\"","type":"text","marks":[{"type":"code"}]},{"text":". The quotes normally need removing, and this can be done with ","type":"text"},{"text":"$context.issue.id.asText()","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"All ‘asText()’ values are effectively a java ","type":"text"},{"text":"String","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.oracle.com/javase/8/docs/api/java/lang/String.html"}}]},{"text":" object, so all related methods can then be used, eg ","type":"text"},{"text":".toLowerCase()","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Most properties lie under the ","type":"text"},{"text":"$context.issue.fields","type":"text","marks":[{"type":"code"}]},{"text":" prefix, as shown:","type":"text"}]},{"type":"table","attrs":{"layout":"wide","width":960.0,"localId":"6f597199-94ac-446e-bf12-12705aa58bf2"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[288.0]},"content":[{"type":"paragraph","content":[{"text":"Field","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"paragraph","content":[{"text":"Expression","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[288.0]},"content":[{"type":"paragraph","content":[{"text":"Issue Key","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"paragraph","content":[{"text":"$context.issue.key.asText()","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[288.0]},"content":[{"type":"paragraph","content":[{"text":"Project Key","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"paragraph","content":[{"text":"$context.issue.fields.project.key.asText()","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[288.0]},"content":[{"type":"paragraph","content":[{"text":"Description (as Text)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"paragraph","content":[{"text":"$fields.description.asText()","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[288.0]},"content":[{"type":"paragraph","content":[{"text":"Description (as HTML)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"paragraph","content":[{"text":"$jemhUtils.wikiToHtml($fields.description.asText())","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[288.0]},"content":[{"type":"paragraph","content":[{"text":"Custom Field Value (Text)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"paragraph","content":[{"text":"$context.issue.fields.customfield_10610.asText()","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[288.0]},"content":[{"type":"paragraph","content":[{"text":"Custom Field Value (Single Choice)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"paragraph","content":[{"text":"$context.issue.fields.customfield_13900.value.asText()","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[288.0]},"content":[{"type":"paragraph","content":[{"text":"Custom Field Value (Multiple Choice)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"codeBlock","content":[{"text":"#foreach ($item in $context.issue.fields.customfield_13600)\n $item.value.asText()\n#end","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[288.0]},"content":[{"type":"paragraph","content":[{"text":"Reporter Display Name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"paragraph","content":[{"text":"$context.issue.fields.reporter.displayName.asText()","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[288.0]},"content":[{"type":"paragraph","content":[{"text":"Most recent comment","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"codeBlock","content":[{"text":"#set ($aComment = $fields.comment.comments[0] )\n$jemhUtils.wikiToHtml($aComment.body.asText())","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[288.0]},"content":[{"type":"paragraph","content":[{"text":"All Comments (if present)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"codeBlock","content":[{"text":"

Prior Comments

Issue $context.issue.key.asText() has $fields.comment.total comments

\n#foreach( $comment in $fields.comment.comments )\n

Comment created $comment.created.asText()

Comments, most recent first ($context.comments.total)

\n#if ($context.comments)\n

Comments:

\n#set ($commentCount=1)\n#foreach ($aComment in $context.comments)\n#set ($commentCount=$commentCount+1)\n #if ($commentCount<10)\n

Created: $aComment.created.asText()

\n $jemhUtils.wikiToHtml($aComment.body.asText())\n

\n #end\n#end\n#else\n

no comments found

\n#end","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[288.0]},"content":[{"type":"paragraph","content":[{"text":"Access individual comments ","type":"text"},{"text":"from All comments","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"codeBlock","content":[{"text":"

STATIC comment extract

\n1) $fields.comment.comments[0].id -- $fields.comment.comments[0].created -- $fields.comment.comments[0].body.asText()
\n2) $fields.comment.comments[1].id -- $fields.comment.comments[1].created -- $fields.comment.comments[1].body.asText()
\n3) $fields.comment.comments[2].id -- $fields.comment.comments[2].created -- $fields.comment.comments[2].body.asText()
\n

","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[288.0]},"content":[{"type":"paragraph","content":[{"text":"Display comments , most recent first ","type":"text"},{"text":"from All comments","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"codeBlock","content":[{"text":"

Comments, most recent first

\n#if ($fields.comment.total >0)\n #foreach($i in [0..$fields.comment.total-1])\n #set ($comment = $fields.comment.comments[$i])\n

Comment created $comment.created.asText()

\n$jemhUtils.wikiToHtml($comment.body.asText())\n

Comments, most recent last

\n#if ($fields.comment.total >0)\n#foreach($i in [1..$fields.comment.total])\n#set ($actualIdx = $fields.comment.total - $i)\n#set ($comment = $fields.comment.comments[$actualIdx.intValue()])\n

Comment created $comment.created.asText()

\n$jemhUtils.wikiToHtml($comment.body.asText())\n

\n#end\n#else\nno comments yet\n#end","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[288.0]},"content":[{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"filterComments"},"legacyAnchorId":{"value":"Manipulatewebhookdatainnotificationtemplates-filterComments"}},"macroMetadata":{"macroId":{"value":"2d234e06fcc9fb423da76ed3ffeeb0aa6fec3183bd037da80134b1c482b8722e"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"aad7b94f-ad8a-4419-b812-9a2d0d8ef434"}},{"text":"Display comments added during the notification generation (with security restrictions) ","type":"text"},{"text":"default behaviour","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" ","type":"text"},{"text":"in email system themes/templates","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"codeBlock","content":[{"text":"

New comments added

\n#set($restrictedComments=$jemhUtils.filterRestrictedComments($context.comments))\n

Added $restrictedComments.size() comments to Issue $context.issue.key.asText()

\n#foreach( $comment in $restrictedComments )\n

Comment created $comment.created.asText()

All comments

\n#set($commentsFromIssue = $context.issue.comment.comments)\n

Added $commentsFromIssue.size() comments to Issue $context.issue.key.asText()

\n#foreach( $comment in $commentsFromIssue )\n

Comment created $comment.created.asText()

All comments recipient has access to

\n#set($restrictedCommentsFromIssue = $jemhUtils.filterRestrictedComments($context.issue.comment.comments))\n

Added $restrictedCommentsFromIssue.size() comments to Issue $context.issue.key.asText()

\n#foreach( $comment in $restrictedCommentsFromIssue )\n

Comment created $comment.created.asText()

New comments added

Added $context.comments.size() comments to Issue $context.issue.key.asText()

\n#foreach( $comment in $context.comments )\n

Comment created $comment.created.asText()

\n$jemhUtils.wikiToHtml($comment.body.asText())\n#end","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[288.0]},"content":[{"type":"paragraph","content":[{"text":"Get latest issue comment (","type":"text"},{"text":"Exposes comments that are internal or contain group/role visibility restrictions","type":"text","marks":[{"type":"strong"}]},{"text":").","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"codeBlock","content":[{"text":"#set($commentsFromIssue = $context.issue.comment.comments)\n$commentsFromIssue[0].body.asText()\nor\n$jemhUtils.wikiToHtml($commentsFromIssue[0].body.asText())","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[288.0]},"content":[{"type":"paragraph","content":[{"text":"Get latest public comment (Ignores JSM internal and Software comment visibility restrictions)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"codeBlock","content":[{"text":"#set($commentsFromIssue = $jemhUtils.filterRestrictedComments($context.issue.comment.comments))\n$commentsFromIssue[0].body.asText()\nor\n$jemhUtils.wikiToHtml($commentsFromIssue[0].body.asText())","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[288.0]},"content":[{"type":"paragraph","content":[{"text":"Labels","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"paragraph","content":[{"text":"#foreach ($aLabel in $context.issue.fields.labels) $aLabel #end","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[288.0]},"content":[{"type":"paragraph","content":[{"text":"Changelog items","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"paragraph","content":[{"text":"Example webhook content:","type":"text"}]},{"type":"codeBlock","content":[{"text":" \"changelogs\": {\n \"id\": \"351426\",\n \"items\": [\n {\n \"field\": \"assignee\",\n \"fieldtype\": \"jira\",\n \"fieldId\": \"assignee\",\n \"tmpFromAccountId\": \"12345678:b74e9574-1a83-4485-bbaf-123123d8d34fe\",\n \"tmpToAccountId\": \"12316969a56780463c40ad\"\n }\n ],","type":"text"}]},{"type":"paragraph","content":[{"text":"Example, detect if “assignee” changed","type":"text"}]},{"type":"codeBlock","content":[{"text":"#foreach ($changeItem in $context.changelogs.items)\n #if ($changeItem.field.asText()==\"assignee\")\n assignee changed\n #else\n assignee didnt change\n #end\n#end","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[288.0]},"content":[{"type":"paragraph","content":[{"text":"Check for changelog item author (and inhibit, unless other users comment also)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[672.0]},"content":[{"type":"paragraph","content":[{"text":"Example changelogs","type":"text"}]},{"type":"codeBlock","content":[{"text":" \"changelogs\": [\n {\n \"id\": \"355783\",\n \"items\": [\n {\n \"field\": \"status\",\n \"fieldtype\": \"jira\",\n \"fieldId\": \"status\",\n \"from\": \"10006\",\n \"fromString\": \"Action Needed\",\n \"to\": \"6\",\n \"toString\": \"Closed\"\n }\n ],\n \"author\": {\n \"self\": \"https://thepluginpeople.atlassian.net/rest/api/2/user?accountId=557058%3Ab74e9574-1a83-4485-bbaf-96910d8d34fe\",\n \"accountId\": \"557058:b74e9574-1a83-4485-bbaf-96910d8d34fe\",\n \"avatarUrls\": {\n \"48x48\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/AP-4.png\",\n \"24x24\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/AP-4.png\",\n \"16x16\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/AP-4.png\",\n \"32x32\": \"https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/initials/AP-4.png\"\n },\n \"displayName\": \"Andy Brook [Plugin People]\",\n \"active\": true,\n \"timeZone\": \"Europe/Dublin\",\n \"accountType\": \"atlassian\"\n },\n \"timestamp\": 1731680190007\n }\n ]","type":"text"}]},{"type":"paragraph","content":[{"text":"Example, detect if changelogs are all for the same user, and if so, drop","type":"text"}]},{"type":"codeBlock","content":[{"text":"#set ($targetAcct=\"557058:b74e9574-1a83-4485-bbaf-96910d8d34fe\")\n#set ($targetAcctChanges = 0)\n#set ($totalChanges = 0)\n#foreach ($changeItem in $context.changelogs)\n #if ($changeItem.author.accountId.asText()==$targetAcct)\n #set ($targetAcctChanges = $targetAcctChanges + 1)\n #end\n #set ($totalChanges = $totalChanges + 1)\n#end\n\nThere were $targetAcctChanges target account changes, of $totalChanges total changes.\n#if ($targetAcctChanges == $totalChanges)\nmessage will be inhibited\n$jemhUtils.setInhibitSending(true) \n#end","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"atlassian-info","text":":info:","shortName":":info:"}},{"text":" Filtering JSM private comments is covered on ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://thepluginpeople.atlassian.net/wiki/spaces/JEMHC/pages/74743975"}},{"text":" ","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Working with dates","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"1493f427-e2dc-4073-9567-a018950d370f"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[217.0]},"content":[{"type":"paragraph","content":[{"text":"Date timestamps","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"codeBlock","content":[{"text":"#set( $createdStr = $comment.created.asText() )\n#set( $timeStr = $createdStr.substring($createdStr.indexOf('T')+1) )\n#set( $timeSplit = $timeStr.split(\":\"))\n

Comment created date: $createdStr.substring(0,$createdStr.indexOf('T')) at $timeSplit[0]:$timeSplit[1]

","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[217.0]},"content":[{"type":"paragraph","content":[{"text":"Date (translate ISO dates)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"codeBlock","content":[{"text":"#set ($dateObj = $dateFormatter.getDate($comment.created.asText()))\n$dateFormatter.format($dateObj, \"dd/MMM/yy h:mm a\")","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[217.0]},"content":[{"type":"paragraph","content":[{"text":"Issue Created (create event only)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.0]},"content":[{"type":"codeBlock","content":[{"text":"#set ($dateObj = $dateFormatter.getDate($context.timestamp.asText()))\n$dateFormatter.format($dateObj, \"dd/MMM/yy h:mm a\")","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Working with AdHoc notifications","type":"text"}]},{"type":"paragraph","content":[{"text":"AdHoc notifications do not generate auditing events, so preview context data cannot be retrieved from JEMHC auditing. Instead, you can generate a preview context for AdHoc notifications from the AdHoc admin screen.","type":"text"}]},{"type":"paragraph","content":[{"text":"Please see ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://thepluginpeople.atlassian.net/wiki/spaces/JEMHC/pages/53739642/Use+Ad+hoc+notifications#Generating-an-Ad-Hoc-preview-context"}},{"text":" for more information.","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"After generating a preview context for AdHoc, this can be used to test custom Template Set content for AdHoc notification types.","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Create a custom macro","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"System Macros","type":"text","marks":[{"type":"em"}]},{"text":" show macros defined within JEMHC and inherited by all instances:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1224,"id":"7158fede-df65-4fa2-b4c4-eb6ba3e46f07","collection":"contentId-40861735","type":"file","height":467}}]},{"type":"paragraph","content":[{"text":"Here is a “hello world” macro which takes two parameters, ","type":"text"},{"text":"$param1","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"$param2","type":"text","marks":[{"type":"code"}]},{"text":" which can then be used inside the macro body.","type":"text"}]},{"type":"paragraph","content":[{"text":"You can define references inside macros that are then available afterwards to the caller. This is useful for flagging specific situations, which is what we will do with the issue resolved status.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"#macro ( helloworld $param1 $param2)\nHello $param1 -- $param2 \n#end","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Custom Macros","type":"text","marks":[{"type":"em"}]},{"text":" are user editable, the following text contains the ","type":"text"},{"text":"render","type":"text","marks":[{"type":"em"}]},{"text":" method that will be called from our template, as well as the workflow transition detector 'helper' method.","type":"text"}]},{"type":"codeBlock","content":[{"text":"#macro ( renderIssueResolved $context)\n ISSUE WAS RESOLVED!\n#end\n\n#macro ( setWorkflowTransition $context)\n #foreach ($changeItem in $context.changelog.items)\n #set ($theField = $changeItem.field )\n #set ($theTo = $changeItem.to)\n #set ($theToString = $changeItem.toString)\n #if ($theField.asText() == \"status\")\n #set ($workflowTransition = $theTo.asText())\n #end\n #end\n#end","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Testing","type":"text"}]},{"type":"paragraph","content":[{"text":"Below the Edit area, the Preview Context captured earlier can be selected. This means that data will be available via the ","type":"text"},{"text":"$context","type":"text","marks":[{"type":"code"}]},{"text":" Velocity reference in templates. The ","type":"text"},{"text":"Scratchpad","type":"text","marks":[{"type":"em"}]},{"text":" allows you to enter template content and execute it in the Preview Context defined with the edited Macro. It won’t be saved and is just for validating expressions accessing data from the preview context:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1100,"id":"90efd0d0-68b9-4e16-b5bb-7c2d7e5b7708","collection":"contentId-40861735","type":"file","height":1116}}]},{"type":"paragraph","content":[{"text":"This means that the preview icon ","type":"text"},{"text":"(Eye Icon)","type":"text","marks":[{"type":"strong"}]},{"text":" will dynamically do the rendering and show the result, demonstrating (a) The changelog data contained an issue status change matching what was expected, and (b) The content was rendered via macro invocation:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":309,"id":"fc59973a-e7cf-4a01-a415-6791464c4fa3","collection":"contentId-40861735","type":"file","height":248}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Create and modify a notification template","type":"text"}]},{"type":"paragraph","content":[{"text":"Create a template:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1103,"id":"33951a53-c27a-462f-9650-97e553f0b6e8","collection":"contentId-40861735","type":"file","height":406}}]},{"type":"paragraph","content":[{"text":"Then set a name, make the type Issue Updated (as issue resolutions will be 'in' the Issue Updated event), and pick a theme, e.g. Jira System):","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":65.0},"content":[{"type":"media","attrs":{"width":773,"id":"abe28096-fc68-41ec-8e86-bad3fde31059","collection":"contentId-40861735","type":"file","height":491}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Use the Preview Context to understand how to access data","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":982,"id":"4690a5f0-bab1-4e6d-afe6-e7d51b67d7f5","collection":"contentId-40861735","type":"file","height":615}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Expanded view","type":"text"}]},{"type":"paragraph","content":[{"text":"For example, when working over ","type":"text"},{"text":"$fields.comment.comments","type":"text","marks":[{"type":"code"}]},{"text":" in a loop, each comments data can then be accessed as ","type":"text"},{"text":"$currentComment.author.displayName.asText()","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":30.0},"content":[{"type":"media","attrs":{"width":176,"id":"5c45da3d-e9c0-4fed-99ec-a8f8a3aeed1f","collection":"contentId-40861735","type":"file","height":614}}]},{"type":"paragraph","content":[{"text":"Here is an example template:","type":"text"}]},{"type":"codeBlock","content":[{"text":"#setWorkflowTransition($context)\n \n#if ($!workflowTransition)\n ## custom workflow occurred\n #if ($workflowTransition == 6)\n #renderIssueResolved($context)\n #end\n#else\n ## do the default\n#jemhBodyDelimiter()\n#set ($fields = $context.issue.fields)\n#if ($context.user) $context.user.displayName.asText()#else Anonymous#end updated an issue: $context.issue.fields.project.name.asText() / $context.issue.key.asText() #jemhIncludeUserRole()\nIssue Updated - $fields.summary.asText()\n$jemhUtils.setNotify()\nIssue Type: $fields.issuetype.name.asText()\nStatus: $fields.status.name.asText()\nAssignee: $fields.assignee.displayName.asText()\nCreated: $fields.created.asText()\nPriority: $fields.priority.name.asText()\nReporter: $fields.reporter.displayName.asText()\n#if ($!fields.security())\nSecurity Level: $fields.security.name.asText()\n#end\n#foreach( $comment in $context.comments )\n#set ($dateObj = $dateFormatter.getDate($comment.created.asText()))\n[created by $comment.author.displayName.asText() on $dateFormatter.format($dateObj, \"dd/MMM/yy h:mm a\")]\n--\n$comment.body.asText())\n--\n#end\n \n#end","type":"text"}]},{"type":"paragraph","content":[{"text":"Using the text preview again, we get to see what the rendered output for issue resolution looks like.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":922,"id":"d4596ad8-1dc4-4b7e-b164-33bb629e3d40","collection":"contentId-40861735","type":"file","height":505}}]},{"type":"paragraph","content":[{"text":"To further test the template, change the Preview Context to be an event that is ","type":"text"},{"text":"not","type":"text","marks":[{"type":"strong"}]},{"text":" an issue resolution. Doing so will automatically re-render the content, and you'll find it isn't on the Resolved screen any more.","type":"text"}]},{"type":"paragraph","content":[{"text":"With the Preview Context and Template rendering features you can validate correct behaviour up front, saving time!","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Example templates","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Identifying recent attachments","type":"text"}]},{"type":"paragraph","content":[{"text":"Adding all attachments from an issue to a template could be problematic if a large quantity of attachments are present. The following script can be used to identify if attachments were recently added to the issue.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Template","type":"text"}]},{"type":"codeBlock","content":[{"text":"$context.issue.key.asText()\n$jemhUtils.setCommentRendered()\n#set($attachments = $context.issue.fields.attachment)\n##If there are attachments present on the issue ...\n#if($attachments)\n ##record current time\n #set($timeNow = $jemhDateUtils.nowDate().getTime())\n ##for each attachment....\n #foreach($attachment in $attachments)\n ##retrieve the time the attachment was added to the issue\n #set($created = $attachment.created)\n ##if not null\n #if($created.asText())\n ##get the number of milliseconds between now and the attachment being added\n #set($timeSinceAdded = $timeNow - $jemhDateUtils.getDate($created).getTime())\n ##set time frame to 5 minuets in milliseconds\n #set($timeFrame = (60 * 1000) * 5)\n ##if time since the attachment was added is less than or equal to the time frame ...\n #if($timeSinceAdded <= $timeFrame)\n

$attachment.filename.asText()

$attachment.content.asText()

\n #end\n #end\n #end\n#end","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"How it looks","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":811,"id":"284c5a69-3057-4699-961f-9e97ce2a7ece","collection":"contentId-40861735","type":"file","height":391}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Related articles","type":"text"}]},{"type":"paragraph","content":[{"type":"placeholder","attrs":{"text":"Related articles appear here based on the labels you select. Click to edit the macro and add or change labels."}}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"contentbylabel","parameters":{"macroParams":{"showLabels":{"value":"false"},"max":{"value":"5"},"spaces":{"value":"JEMHC"},"showSpace":{"value":"false"},"sort":{"value":"modified"},"type":{"value":"page"},"reverse":{"value":"true"},"labels":{"value":"template webhook velocity"},"cql":{"value":"label in ( \"velocity\" , \"template\" , \"webhook\" ) and type = \"page\" and space = \"JEMHC\""}},"macroMetadata":{"macroId":{"value":"fa68c44b-6e2e-4f80-b10b-52d0a8fe26aa"},"schemaVersion":{"value":"4"},"title":"Filter by label (Content by label)"}},"localId":"e0ae8dfa-2e01-4800-a772-dc2bce304177"}},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"details","parameters":{"macroParams":{"hidden":{"value":"true"}},"macroMetadata":{"macroId":{"value":"192c8026-84bd-4c1f-a14b-23b08b51e891"},"schemaVersion":{"value":"1"},"title":"Page Properties"}},"localId":"59c0a6b5-1dd7-4dca-80f6-66d5a5aec396"},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"table","attrs":{"layout":"default","localId":"1ad987ff-146e-41c9-83b9-ed87271b08d4"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[495.0]},"content":[{"type":"paragraph","content":[{"text":"Related issues","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported