Table of Contents |
---|
Notification Mappings
JEMHC JEMH Cloud offers the ability to send issue event notifications across the following transport:
Email Notification Mapping
Notifications
Notifications are driven by WebHook events sent by JIRACloud, they are much more limited in terms of 'what' the events are than JIRAServer provides, for issues there are onlyIssue events are sent to JEMH Cloud as webhooks by Jira. They are split into 3 types:
Created
Updated
Deleted
There are also a range of system notifications.
Themes
Notifications in JEMHCloud JEMH Cloud are all themed. There are two internal Themes available, JIRA Jira and Generic.
...
Jira Theme
The JIRA Jira theme mimics the look and feel of JIRA Jira notifications.
Generic Theme
The Generic theme is a reduced version of the JIRA Jira theme, more suitable for simple email based support (primary use case).
Create an Email Notification Mapping
Navigate to the Notifications tab in JEMHCJEMH Cloud, on the left hand side will be a list of available notification mapping types. Select the Email Notification Mapping and then select Create button.
...
The Dialogdialog:
...
NOTES:
In this example, HTML notifications were selected, this also allowed Wiki Rendering to be enabled - this allows wiki markup in
JIRACloudJira Cloud to be rendered in outbound notifications.
The Generic theme was selected
Issue Deleted template was deselected, removing notifications of this event
Projects were changed from 'all' to just the Support project
Further down the dialog:
...
NOTES:
A target audience of Email and
JIRAJira users is set
Custom fields (Sender Email Address and Email User Participants) are set
Attachments (outbound) included but limited to 2MB each, not more than 4MB per message
Sender Personal set to always be
PPL
rather than be set by the display name of the user making the change
The Participant User field above is a diagnostic entry, it allows a given user to be BCC'd on EVERY message generated. When initially setting up this helps to:
validate messages are sent in response to changes
look and feel is appropriate / working as expected
Once happy with the outcome, you'll be pleased to remove yourself from this entry!
Once Saved
A summary of this is listed:
Changing the Sender Email Address between issue types
You might want to have a different sender email address for each type of issue type e.g. bugs would come from bugs-project-one@email.com, and tasks would come from tasks-project-one@email.com. In the following example we're going to utilise the value set by a Custom Field Defaults configuration to change the sender address used in an outbound notification. This presumes that you're familiar with how to configure a Custom Field Configuration (if not, this page will teach you how - Custom Field Defaults).
Preamble
- A custom field exists for all the issues within your project. It will contain the sender email address.
- A Custom Field Default exists for your project. This results in all issues that are created from inbound emails by JEMHC having a value for the custom field.
- The Custom Field Default is different for each issue type, e.g. tasks are tasks-project-one@email.com and bugs-project-one@email.com.
- This can be configured by having multiple rules within your non-default project mapping. See Rule Driven Project Mappings.
How to configure the email Notification Mapping
Once the items in the preamble are out of the way it's really easy to vary the sender email address between issue types. All you have to do is go into your email notification mapping and find the field called 'Sender Email Address Custom Field' under the 'Sender' section. Here's a picture of it configured to look inside a custom field called 'Custom Field'.
...