{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"3"}},"macroMetadata":{"macroId":{"value":"3e04949b3d679525ee2a457384f8375f"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"efa468c3-611c-4fb6-8cc4-f5812e315e9b"}},{"type":"paragraph","content":[{"text":"Send customized email notifications to recipients directly from the Jira issue view. Recipients can be specified from custom fields, issue participants or manually defined instead. Email contents can be pre-built using templates to allow quick use.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Granting users access to Ad hoc notifications","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Enable feature","type":"text"}]},{"type":"paragraph","content":[{"text":"By default, the feature is disabled. To enable its use, enable through ","type":"text"},{"text":"JEMHC → Notifications → Global Configuration →","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"text":"Settings.","type":"text","marks":[{"type":"em"}]},{"text":" Once enabled, you need to grant the ","type":"text"},{"text":"Send JEMHC ad hoc Emails ","type":"text","marks":[{"type":"strong"}]},{"text":"permission via the project’s permission scheme for users who should have access.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1438,"alt":"image-20240524-084327.png","id":"d97e9022-20d2-43f3-b7cf-b7cb84d35110","collection":"contentId-53739642","type":"file","height":485}}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Grant users permission to use feature","type":"text"}]},{"type":"paragraph","content":[{"text":"To give access to your users, go to Jira Administration → Issue → Permission Schemes and edit the Permissions on your project's scheme. ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":100.0},"content":[{"type":"media","attrs":{"width":1156,"id":"f993c6f8-b256-4ea4-a539-bcbeb99b76c2","collection":"contentId-53739642","type":"file","height":589}}]},{"type":"paragraph","content":[{"text":"Once in permissions, click on the Grant permission button. Select the ","type":"text"},{"text":"Send JEMHC ad hoc Emails","type":"text","marks":[{"type":"strong"}]},{"text":" permission and the roles/groups/users etc. that you want to give access to the feature.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":588,"id":"62071f4d-0a6d-4b33-a62f-645b0243476f","collection":"contentId-53739642","type":"file","height":417}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Accessing the Ad hoc Notification window","type":"text"}]},{"type":"paragraph","content":[{"text":"As an authorized user for ad hoc notifications (its an App permission that needs granting through the Permission Scheme), a new ","type":"text"},{"text":"Send Email ","type":"text","marks":[{"type":"strong"}]},{"text":"action will appear in the issue view:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":65.0},"content":[{"type":"media","attrs":{"width":370,"id":"ffc90434-0bbb-424f-857a-c1aecc89d5b3","collection":"contentId-53739642","type":"file","height":210}}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Don't see the action?","type":"text"}]},{"type":"paragraph","content":[{"text":"It's possible that the logged user doesn't have the right permission. Use Jira’s permission helper tool to ensure that the user has the ","type":"text"},{"text":"Send JEMHC ad hoc Emails","type":"text","marks":[{"type":"strong"}]},{"text":" permission.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Creating an Ad Hoc notification","type":"text"}]},{"type":"paragraph","content":[{"text":"Each of the sections of the pop-up will be described, later we'll show how these settings can be saved as defaults for the project, making subsequent use much more straight forward.","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Generating an Ad Hoc preview context","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"In order to be able to generate a preview context, Ad Hoc Simple Mode behaviour must be disabled. ","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Generating a preview context for an Ad Hoc notification will provide a snapshot of the current Jira issue state at the time of creation. This allows you to edit custom Ad Hoc template sets against example issue data during edit time.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ensure Ad Hoc Settings > Simple Mode is disabled.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":736,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1252,"alt":"image-20250123-095208.png","id":"cac6044f-b60d-4678-b214-1a68484cdb79","collection":"contentId-53739642","type":"file","height":536}}]},{"type":"orderedList","attrs":{"order":2},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to Ad Hoc > Admin only. A new ‘Generate preview context’ option will be available.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1256,"alt":"image-20250123-095339.png","id":"1648f061-067a-4d5b-b05a-8cc2bf135ce7","collection":"contentId-53739642","type":"file","height":576}}]},{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://thepluginpeople.atlassian.net/wiki/spaces/JEMHC/pages/53739642/Ad+hoc+notifications#Create-Preview-Context"}}]},{"type":"orderedList","attrs":{"order":3},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"After generating, you can view the preview context from JEMHC > Notifications > Preview Contexts.","type":"text"}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you do not see the Ad Hoc preview context, please ensure the ‘Event Group’ filter is set to ‘Ad Hoc Notifications’ or ‘All’.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1818,"alt":"image-20250123-095608.png","id":"9b1c842f-6db7-47d1-9654-557ac392e0ff","collection":"contentId-53739642","type":"file","height":548}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Content","type":"text"}]},{"type":"paragraph","content":[{"text":"JEMHC has several Themes that include different per project type AdHoc Templates.","type":"text"}]},{"type":"paragraph","content":[{"text":"Here, users enter their unique message content, the message format (text/html), and the related 'theme' that combines CSS styling and macros used by templates. For more information on customizing pre-made templates, see ","type":"text"},{"text":"create custom Theme and Template Sets","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Generic (System) Theme Adhoc content Template","type":"text"}]},{"type":"codeBlock","content":[{"text":"#@issueNotification()\n

\n##YOUR_MESSAGE_WILL_BE_HERE\n

\n\n \n #jemhIncludeSupportActionHeader()\n \n \n \n

\n \n #jemhIncludeIssueHeader()\n #jemhIncludeBody()\n #jemhIncludeDirectiveSetLinks()\n #jemhIncludeAddComment()\n #jemhIncludeFooter()\n

\n##YOUR_MESSAGE_WILL_BE_HERE\n

\n\n \n #jemhIncludeStandardActionHeader()\n \n \n \n

\n \n #jemhIncludeIssueHeader()\n #jemhIncludeIssueAndChangeLogDetails($serviceJiraFields)\n #jemhIncludeBody()\n #jemhIncludeDirectiveSetLinks()\n #jemhIncludeAddComment()\n #jemhIncludeFooter()\n

\n#end\n#inhibitSendingConditions()","type":"text"}]},{"type":"paragraph","content":[{"text":"The header row of the AdHoc template is added through the macro: ","type":"text"},{"text":"#jemhIncludeStandardActionHeader()","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Service Desk 2 (System) Theme AdHoc content Template","type":"text"}]},{"type":"codeBlock","content":[{"text":"#jsdBodyDelimeter()\n#jsdReplyMarkerHint()\n\n##YOUR_MESSAGE_WILL_BE_HERE\n\n#jsdIssueLinkAndDisableNotifications()\n#renderParticipants()\n#renderServiceDeskSignature()\n#inhibitSendingConditions()","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"How Adhoc editor content gets used","type":"text"}]},{"type":"paragraph","content":[{"text":"Notice in all the above theme templates there is:","type":"text"}]},{"type":"codeBlock","content":[{"text":"##YOUR_MESSAGE_WILL_BE_HERE","type":"text"}]},{"type":"paragraph","content":[{"text":"That content is replaced with the rendered content entered through the Issue View Adhoc editor. For a minimalist payload you could simply replace the custom theme with the above.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Headers","type":"text"}]},{"type":"paragraph","content":[{"text":"The header block is included in the adhoc templates through macro calls to","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JSM: ","type":"text"},{"text":"#jemhIncludeSupportActionHeader","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Software: ","type":"text"},{"text":"#jemhIncludeStandardActionHeader()","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"The macro content can be modified within a writeable (non-system) Theme (i.e. you'd copy the system Theme you want to modify!), that macro looks like:","type":"text"}]},{"type":"codeBlock","content":[{"text":"#macro ( jemhIncludeAdHocSupportActionHeader )\n \n\t \n\t\t \n \t \n \t\t#if ($context.user) \n \t \n \n #else\n\t\t\t \n \t \n #end\n \n

\n #if ($jemhUtils.isCreatedByEmailUser()) \n $$messageUtils.getMessage(\"velocity.macro.action.header.emailUser\")$ \n #else\n $$messageUtils.getMessage(\"velocity.macro.action.header.support\")$ \n #end\n

\n #if ($jemhUtils.isCreatedByEmailUser())\n \t\t$messageUtils.getMessage('velocity.macro.action.header.emailUser')\n #else\n \t\t$messageUtils.getMessage('velocity.macro.action.header.support')\n #end\n

\n $$messageUtils.getMessage(\"velocity.macro.action.header.anonymous\")$ \n

\n \t $messageUtils.getMessage('velocity.macro.action.header.anonymous') \n $messageUtils.getMessage(\"velocity.macro.action.header.$jemhUtils.webhookEvent\") $messageUtils.getMessage('velocity.macro.action.header.anIssue')\n \t\t

\n \n\n#end","type":"text"}]},{"type":"paragraph","content":[{"text":" When previewing the message before sending it's also possible to use a JEMHC Translation configuration (that could apply to a remote sender, by their domain - as defined ","type":"text"},{"text":"in","type":"text","marks":[{"type":"em"}]},{"text":" the Translation configuration).","type":"text"}]},{"type":"paragraph","content":[{"text":"The expandable ","type":"text"},{"text":"Context","type":"text","marks":[{"type":"strong"}]},{"text":" section shows the representation of the event data involved:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":40.0},"content":[{"type":"media","attrs":{"width":637,"id":"b410ced5-5d08-401f-9a47-2acb1fe1579a","collection":"contentId-53739642","type":"file","height":501}}]},{"type":"paragraph","content":[{"text":"Accessing this data is relatively straight forward. For example, the following will 'extract' the current issue key:","type":"text"}]},{"type":"codeBlock","content":[{"text":"$context.issue.key.asText()","type":"text"}]},{"type":"paragraph","content":[{"text":"Here is some further reading:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Customize Email Content","type":"text","marks":[{"type":"link","attrs":{"href":"https://thepluginpeople.atlassian.net/wiki/spaces/JEMHC/pages/40304866"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Manipulate Webhook data in a Template","type":"text","marks":[{"type":"link","attrs":{"href":"https://thepluginpeople.atlassian.net/wiki/spaces/JEMHC/pages/40861735"}}]},{"text":" (this is specific to webhooks that are specific to event-driven notifications, but may be a further useful reference to accessing values)","type":"text"}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Previewing the message","type":"text"}]},{"type":"paragraph","content":[{"text":"The preview icon switches between a rendered version of the content and the edit-time mark-up (and back), enabling expected outcome to be validated.","type":"text"}]},{"type":"paragraph","content":[{"text":"Subject","type":"text","marks":[{"type":"strong"}]}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"40180d13-7382-4650-b576-167b43a3c77a"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Edit Time","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"paragraph","content":[{"text":"Preview","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":45.0},"content":[{"type":"media","attrs":{"width":598,"id":"dcb356fa-e207-4986-be3e-8b0ca649a34b","collection":"contentId-53739642","type":"file","height":158}}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[380.0]},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":35.0},"content":[{"type":"media","attrs":{"width":546,"id":"df21ba5a-8ac4-4bcd-b88a-1319c71624bf","collection":"contentId-53739642","type":"file","height":277}}]}]}]}]},{"type":"paragraph","content":[{"text":"Content","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The same is available for content, but, with HTML content, its also possible to see the raw mark-up involved:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"ca746bd5-ce13-4887-928f-11b16ef81543"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"Edit Time","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"Preview (as HTML)","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"Preview (as TEXT)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":35.0},"content":[{"type":"media","attrs":{"width":843,"id":"ca93d758-2149-4a60-b461-d3c7e19e4885","collection":"contentId-53739642","type":"file","height":435}}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":30.0},"content":[{"type":"media","attrs":{"width":586,"id":"b7a09803-7870-4211-827e-d1c9e012f5ed","collection":"contentId-53739642","type":"file","height":346}}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":35.0},"content":[{"type":"media","attrs":{"width":719,"id":"28a0008d-ce15-464b-a12c-48f6ffb468fd","collection":"contentId-53739642","type":"file","height":378}}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Help","type":"text"}]},{"type":"paragraph","content":[{"text":"The help icon opens up ","type":"text"},{"text":"Manipulate Webhook data in a Template","type":"text","marks":[{"type":"link","attrs":{"href":"https://thepluginpeople.atlassian.net/wiki/spaces/JEMHC/pages/40861735"}}]},{"text":":","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":45.0},"content":[{"type":"media","attrs":{"width":585,"id":"7b069bc4-fbd5-4c1a-91d6-ce9272a1c3cd","collection":"contentId-53739642","type":"file","height":161}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"To, CC and BCC","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Email address privacy","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"Sending a JEMHC ad hoc notification results in one email being sent with all recipient email addresses present. If email addresses are to be private, they should be set in BCC only.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"The addressee tabs allow entry of addressee recipients to be defied as To/CC and BCC. Recipients can be defined in several ways:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"manually entered email addresses in CSV format, e.g. ","type":"text"},{"text":"adam@example.com,sara@example.com","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"selected “text” custom fields containing email addresses in CSV format","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"selected individual users/groups","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"selected issue participant users, e.g. Watchers, Reporter, Assignee","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"selected user and group custom fields present on the issue","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Additional Recipients","type":"text"}]},{"type":"paragraph","content":[{"text":"See ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://thepluginpeople.atlassian.net/wiki/spaces/JEMHC/pages/66355211"}},{"text":" for more.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"From","type":"text"}]},{"type":"paragraph","content":[{"text":"Optionally the sender address (","type":"text"},{"text":"From","type":"text","marks":[{"type":"code"}]},{"text":") can be manipulated and customized, allowing per-project email addresses and 'sender' personal part, for example ","type":"text"},{"text":"\"Personal Part\" ","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Attachments","type":"text"}]},{"type":"paragraph","content":[{"text":"Attachments may be selected for inclusion in the ad hoc notification:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Issue attachments","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Uploaded files","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Static Resources","type":"text","marks":[{"type":"link","attrs":{"href":"https://thepluginpeople.atlassian.net/wiki/spaces/JEMHC/pages/162699681"}}]},{"text":" ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Issue Update","type":"text"}]},{"type":"paragraph","content":[{"text":"To track what ad hoc notifications have been sent, it's possible to add the message content as a comment on the issue, with restricted visibility. Setting restricted visibility ensures that JEMHC doesn't broadcast the Ad Hoc message to all issue participants:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":903,"id":"de67736d-a07b-4b16-bbb9-265132ac64c0","collection":"contentId-53739642","type":"file","height":431}}]},{"type":"paragraph","content":[{"text":"Comments that are successfully created are then shown, for example:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":70.0},"content":[{"type":"media","attrs":{"width":940,"id":"319cc5e2-5822-4eb8-9f0f-4a7db9d4565d","collection":"contentId-53739642","type":"file","height":164}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Settings","type":"text"}]},{"type":"paragraph","content":[{"text":"In this tab, the following settings are available:","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"KISS Mode","type":"text"}]},{"type":"paragraph","content":[{"text":"The Ad-Hoc pop-up has two modes; ","type":"text"},{"text":"Simple","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"Full","type":"text","marks":[{"type":"strong"}]},{"text":". Simple mode removes some of the more advanced tabs and settings in order to streamline the experience for end-users. Full mode displays all available settings, which can be useful for power users who want more control.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":50.0},"content":[{"type":"media","attrs":{"width":642,"id":"2605a566-8e15-4780-ac35-5e58910ce110","collection":"contentId-53739642","type":"file","height":158}}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"81dd070d-848c-4703-bf75-4771a5277996"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[402.0]},"content":[{"type":"paragraph","content":[{"text":"Example view of Simple mode","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"paragraph","content":[{"text":"Example view of Full mode","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[402.0]},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":35.0},"content":[{"type":"media","attrs":{"width":642,"id":"86983996-e4d2-439a-9629-9ef8a07bd49c","collection":"contentId-53739642","type":"file","height":520}}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.0]},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":35.0},"content":[{"type":"media","attrs":{"width":642,"id":"5a3cdcf0-1e9b-4fd5-9f8b-9a4261ffc71d","collection":"contentId-53739642","type":"file","height":520}}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Message Outbound","type":"text"}]},{"type":"paragraph","content":[{"text":"Select a configured outbound mail server to be used for the sending of the Ad Hoc notification.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Remember Me","type":"text"}]},{"type":"paragraph","content":[{"text":"Allows saving of the Ad Hoc configuration on submission. Options are ","type":"text"},{"text":"Global","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"Project","type":"text","marks":[{"type":"strong"}]},{"text":" or ","type":"text"},{"text":"None","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the current user is a system administrator, they can save as ","type":"text"},{"text":"Global","type":"text","marks":[{"type":"strong"}]},{"text":" for all ad hoc notifications.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the current user is a project administrator, they can save as the default for this ","type":"text"},{"text":"Project","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"It's possible to reload a previously defined Project or Global configuration which will update the current window session.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Use Next","type":"text"}]},{"type":"paragraph","content":[{"text":"Determines what configuration should be used for future sessions (Project or Global).","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Create Preview Context","type":"text"}]},{"type":"paragraph","content":[{"text":"A Preview Context contains the current 'ad hoc' notification context (data) which can then be used when editing Ad Hoc Template Sets, enabling them to be previewed with real issue data.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":65.0},"content":[{"type":"media","attrs":{"width":999,"id":"b637a2ad-d84a-460f-803a-65b45f4d8fc5","collection":"contentId-53739642","type":"file","height":442}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Result","type":"text"}]},{"type":"paragraph","content":[{"text":"The Result shows the outcome of the messages delivery:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"c7197424-4712-4489-88e3-ac076faaff74"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[260.0]},"content":[{"type":"paragraph","content":[{"text":"Before sending","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[264.0]},"content":[{"type":"paragraph","content":[{"text":"During Sending","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[236.0]},"content":[{"type":"paragraph","content":[{"text":"After Sending","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[260.0]},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":30.0},"content":[{"type":"media","attrs":{"width":768,"id":"3b315602-1261-4b74-8a2d-7e76932527d7","collection":"contentId-53739642","type":"file","height":287}}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[264.0]},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":20.0},"content":[{"type":"media","attrs":{"width":612,"id":"26253146-ede1-47ff-b971-8fecab08b5ce","collection":"contentId-53739642","type":"file","height":287}}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[236.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Sending the Message","type":"text"}]},{"type":"paragraph","content":[{"text":"When Send Message is clicked:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":25.0},"content":[{"type":"media","attrs":{"width":200,"id":"9e9edfbc-d5dd-4d57-b968-a02731265cda","collection":"contentId-53739642","type":"file","height":47}}]},{"type":"paragraph","content":[{"text":"A confirmation window will appear, hit OK to proceed:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":50.0},"content":[{"type":"media","attrs":{"width":595,"id":"780d9568-d1e6-47bf-b147-06e01e92dafb","collection":"contentId-53739642","type":"file","height":327}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Admin Only","type":"text"}]},{"type":"paragraph","content":[{"text":"In this tab, the following settings are available: ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":654,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1109,"alt":"image-20240628-110336.png","id":"610ad83a-a0ae-46c6-9dbd-9643e538178e","collection":"contentId-53739642","type":"file","height":604},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Save as","type":"text"}]},{"type":"paragraph","content":[{"text":"Allows you to save the currently selected configuration as the default for the project, or as a global default.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In order to save a ","type":"text"},{"text":"project","type":"text","marks":[{"type":"strong"}]},{"text":" config; you will need to have the project administrator role. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In order to save the ","type":"text"},{"text":"global","type":"text","marks":[{"type":"strong"}]},{"text":" config you will need to be a Jira administrator.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Use Global Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"Changes the configuration that is currently being used from project to global.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Create Preview Context","type":"text"}]},{"type":"paragraph","content":[{"text":"This creates an adhoc preview context, using the current issue as the context. This allows it to be selected when configuring adhoc templates.","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Troubleshooting","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Adding a visibility restricted comment","type":"text"}]},{"type":"paragraph","content":[{"text":"Where the user has selected an Issue Update comment visibility level that the JEMHCloud add-on user (under which all issue updates occurs) is not part of, which means it cannot be done (in such cases, the comment wouldn't be added to the issue).","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":85.0},"content":[{"type":"media","attrs":{"width":1275,"id":"2158a58e-e52d-42ec-b5d4-228f13017fc5","collection":"contentId-53739642","type":"file","height":282}}]},{"type":"paragraph","content":[{"text":"In this case, add the ","type":"text"},{"text":"JEMHCloud Add-On","type":"text","marks":[{"type":"em"}]},{"text":" user to the project role “Developers”.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Adding JEMHCloud addon user to Role","type":"text"}]},{"type":"paragraph","content":[{"text":"To add the JEMHCloud addon user to a role, you will need to:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"Jira Admin > System > Security > ","type":"text","marks":[{"type":"em"}]},{"text":"Project Roles","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Press ","type":"text"},{"text":"Manage Default Members","type":"text","marks":[{"type":"strong"}]},{"text":" on the relevant Role ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":736,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1437,"alt":"Screenshot from 2024-05-16 16-07-08.png","id":"5a4f580a-c3e0-438f-a4ee-23a835a1aba1","collection":"contentId-53739642","type":"file","height":586},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Press ","type":"text"},{"text":"Edit","type":"text","marks":[{"type":"strong"}]},{"text":" within the Default Users column ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":736,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1433,"alt":"Screenshot from 2024-05-16 16-08-58.png","id":"564a8c68-ed70-4702-a302-228ea4ebdb7c","collection":"contentId-53739642","type":"file","height":268},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Then Add ","type":"text"},{"text":"Enterprise Email Handler for Jira (JEMH)","type":"text","marks":[{"type":"strong"}]},{"text":" and press ","type":"text"},{"text":"Add ","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":736,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1423,"alt":"Screenshot from 2024-05-16 16-10-13.png","id":"d3bf1636-75b6-4c1b-a0df-1c9148798122","collection":"contentId-53739642","type":"file","height":293},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]},{"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":"adhoc notification email"},"cql":{"value":"label in ( \"email\" , \"adhoc\" , \"notification\" ) and type = \"page\" and space = \"JEMHC\""}},"macroMetadata":{"macroId":{"value":"d8cbec03-3ab5-4b86-9dc2-ded612345ae2"},"schemaVersion":{"value":"4"},"title":"Filter by label (Content by label)"}},"localId":"e0838d47-464d-41c5-80b8-de29d2d85a44"}},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"details","parameters":{"macroParams":{"hidden":{"value":"true"}},"macroMetadata":{"macroId":{"value":"553bd6fd-0efa-4d66-a52c-e044125ea9a4"},"schemaVersion":{"value":"1"},"title":"Page Properties"}},"localId":"e0b7051d-be7a-4a6e-a4cc-68c3ff570030"},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"table","attrs":{"layout":"default","localId":"e10f1fd9-61c3-4d1e-af97-d427c472a425"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[455.0]},"content":[{"type":"paragraph","content":[{"text":"Related issues","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[271.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported