| Table of Contents | ||||
|---|---|---|---|---|
|
Summary
When JEMH processes emails, if things don't quite work as expected, for example, security constraints stop an 'edit' operation, rather than swallow that, these kinds of things are collated and sent via formatted email back to the sender. The intention is to help users figure out what they did wrong.
Configuration
JEMH Hint Notifications configuration is accessible through the ‘Notifications’ section of the JEMH Profile at:
JEMH > Profile > Notifications
...
Hint Notifications/Hint-O-Grams have been present in JEMH since version 1.0.0. This page covers the use of Hint Notifications in our current release series (3.x and 4.x).
Configuration
...
Configuration | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Hint-O-Gram enabled? | Checkbox for enabling Hint Notifications | ||||||||||||
Override Hint-O-Gram email address | Defines a target email address for Hint Notifications to override as the sender, allowing a specified address to receive Hint Notifications rather than the email sender | ||||||||||||
Notify Sender of Forward
| Allows Hint Notifications to be send for ‘Forward' issue creation outcome. Please note, this will increase outbound traffic. |
When are Hint Notifications sent?
...
A script manually sets the processing Outcome
The email sender is Blacklisted, and the blacklist outcome is set to Reject
The Sender has no Jira account and JEMH has not been configured for email only support, see here for more info:
On Comment
If the sender is not already involved on the issue and the ‘Non JIRA account holder Security Check filter’ is enabled
A script manually sets the processing Outcome
The email sender is Blacklisted, and the blacklist outcome is set to Reject
Notify of Forward
| Status | ||||
|---|---|---|---|---|
|
| Status | ||||
|---|---|---|---|---|
|
JEMH can send notifications to the email sender when issue creation results in a Forward status (subject to some restrictions). This can be used to let the sender know their email was handled but no issues were created, and that a member of your team has been notified and will address any issues. This notification hint uses the same template as the Hint Notification.
When is the Sender notified?
The email Sender is notified for all email processing which results in a ‘Forward’ Processing outcome, except when:
The Message is filtered due to an X-Jira-Fingerprint header. This is to prevent mail loops, see here for more details:
When the email does not contain a valid sender address
When Email Processing finds a target issue for commenting, forward hint notifications should only apply on create. For comment based hint notifications see:
Hint Template
| Status | ||||
|---|---|---|---|---|
|
| Status | ||||
|---|---|---|---|---|
|
As part of changes to Hint Notifications, the Default Notification Template provided by JEMH has been updated. This will not affect existing custom Hint Templates. To summarise the changes:
Notification template is split into Reject/ and Forward sections to show different content based on the outcome of email processing
Reject Notifications show a limited version of the JEMH Processing Report. This was done to which includes the following report sections:
Outcome
Hints
Filters
Forward Hint Notifications show no Processing Report content by default
Forward Hint Notifications no-longer provide the Jira Admin’s address as a point of contact by default
HTML Notifications have been updated visually, see:
...
| Filter by label (Content by label) | ||||||
|---|---|---|---|---|---|---|
|