Page Comparison

...

Default format is: dd/MMM/yy h:mm a . The default format will be used if this setting is left empty.

Issue Association

TODO

Message Rejection

TODO

...

Issue association allows incoming emails to be matched against an existing Jira issue, allowing comments and other issue update events to be performed against the issue.

...

Issue association strategies are run in the following order:

1. Issue key Directive. For example, @issueKey=ABC_123

2. Issue key/custom field comparison Directive. For example, @issueKey=someCustomField=EXT_ABC

3. JQL issue key Directive. For example, @issueKey=JQLStatement

4. Foreign key association via regexp match, or first capture group. For example, ([A-Z]{12})

5. Issue key in subject. For example, Re: ABC-123

6. Original Message ID to issue association. For example, References: ORIGINAL_MESSAGE_ID

7. Threading values in headers. For example, In-Reply-To/References: <JEMHCloud.ENV.ISSUE_KEY@HOST_URL>

Issue Keys In Subject

When enabled, JEMH Cloud will look for valid issue keys found in the incoming email subject.

Subject Issue Key Regex

The regex provided will be used when searching for issue keys in the incoming email subject. Only applicable if ‘Issue Keys In Subject’ is enabled.

Email Threading

When enabled, JEMH Cloud will check the selected email header value(s) for a reference to an existing issue. The found issue (if applicable) will be used as the associated issue when processing the incoming email.

Use References Header

When enabled, email threading will be attempted by checking the References header of the incoming email. Only applicable if Email Threading is enabled.

Use In-Reply-To Header

When enabled, email threading will be attempted by checking the In-Reply-To header of the incoming email. Only applicable if Email Threading is enabled.

Associate Issue by foreign key

Issues can also be associated by a foreign key value. When enabled, any matching foreign keys in the incoming email will be used to find a matching issue.

Sender Regexes

The provided values are used to enable foreign key associations. If one of the comma separated values (E.g. sender1@company.com, sender2@company.com) matches against the sender of an incoming email, JEMH Cloud will attempt foreign key association.

Foreign Key Source

The location used to search for foreign keys in the incoming emails. Available options are:

• Subject - Looks for foreign keys in the email Subject.

• Body - Looks for foreign keys in the email Body.

Foreign Key Regex

The regular expression used to locate a foreign key from the incoming email. (E.g. (ABC+[0-9]+) to extract the value ‘ABC123’)

Issue Status

The selected statuses will be used to filter searched issues that match a found foreign key.

If left blank, any non-resolved issues will be searched.

If ‘Any status’ is enabled, all issues will be searched for matching foreign keys.

Foreign Key Field

The field selected will be the chosen field JEMH Cloud looks at when finding matching foreign keys on existing issues.

Message Rejection

Message rejection configuration allows incoming emails to be rejected when attempting to comment on existing issues matching the following criteria.

Reject Comment On Status

Any statuses selected will be checked against the associated issue. If the issue matches one of the statuses provided, the comment from the incoming email will be rejected.

Reject comment on JQL Match

The JQL value provided will be used to check against associated issues. If the JQL provided matches the associated issue, the comment from the incoming email will be rejected.

When empty, comments will be allowed on associated issues regardless. See JQL for further information on configuring your custom JQL.

Reject Comments When Issue Resolved For More Than Days

The numeric value entered will be used to reject comments from incoming emails if the associated issue has been resolved for more than the specific amount of days. If the value is left blank, comments will be allowed on issues that have been resolved regardless of the resolution date.

Notify Sender When Issue Cannot Be Created

When enabled, notify the sender of an incoming email when issue creation fails. For example, if a required Jira field or Custom Field has no value set as default, the issue creation will fail due to not providing a value for the required field.

Notify Sender On Comment Limit Exceeded

When enabled, notify the sender when an incoming email attempts to add a comment to an issue that has reached the allowed comment limit. (If disabled, the sender will not be notified, but the comment will still fail due to comment limit being exceeded).

Notify Sender When An Issue Creation Is Rejected Due To 'Comment Only' Mode

When enabled, Notify the sender when it tries to create an issue from an incoming email when the operating mode is 'Comment Only'. (See https://thepluginpeople.atlassian.net/wiki/spaces/JEMHC/pages/3707109395/Issue+configuration#Operating-Mode ).

Notify Sender When Cannot Comment Due To Not Being Involved

When enabled, notify the incoming email sender when either:

• The sender is a Jira user without permission to comment on the associated Issue.

• The sender is an email only user but is not included in the email only custom fields.