Email (Project Mapping)

Owned by Ryan Clifton
Last updated: Sept 18, 2024 by Euan Wynne (Deactivated)
4 min read

Summary

Here you define what should happen to emails that contains specific headers.

Message Filter Actions

This defines what should happen when a email contains the following headers.

  1. Precedence: Bulk

  2. Precedence: Junk

  3. Precedence: List

  4. X-SPAM-Flag

  5. X-JIRA-Fingerprint

The current options are:

  1. Drop (exit group) - Drops the email and stops any further processing and does not check any other Profiles (Only applies to Profile Groups)

  2. Drop - Drops the email and stops any further processing

  3. Allow - Allows emails with the header to create/comment on issues.

  4. Forward - Stops processing and will send a Forward notification to the Forward Users defined within Profile > Notifications.

 

Comment Limit Actions - SINCE 4.1.35

image-20240216-085019.png

Comment count limit

This is the maximum number of comments that is allowed on a issue before the limit is exceeded. Addresses looping problems. Default value is 50, set to 0 for unlimited, set to -1 to inherit from the project mapping or the default mapping.

Comment count limit exceeded action

This is the action that should occur when the Comment Count limit has been exceeded. The current options are:

  • Forward

  • Reject

  • Allow

Description/Comment char length limit

The maximum character limit for Issue Description fields and Comments. Set to 0 to use the Jira defined text limit, Set to -1 to inherit from the Project Mapping or the Default mapping. This value cannot be greater than the Jira System value set within Jira Administration > System > General Configuration > Advanced Settings > jira.text.field.character.limit.

Comment char length limit exceeded action

This is the action that will be performed if the Comment char length limit is exceeded. The current options are:

  • Forward

  • Reject

  • Truncate - This will extract the remaining content and will place this as an attachment on the issue so that no information is lost.

Comment Rate Limit Actions - SINCE 4.2.4

Comment Rate limit

This is the maximum amount of comments that can be made on a single issue within the specified Comment Rate Limit Period. Set the limit to 0 for unlimited, set to -1 to inherit from the project mapping or the default mapping.

Comment Rate Limit Period (hours)

The comment rate limit period defines the time period for this comment rate limit. For example, if comment rate limit is set to 10 and comment rate limit period is set to 1 hour, you can make up to 10 comments in any given hour.

Comment Rate Limit Exceeded Action

This is the action that will be performed if the Comment char length limit is exceeded. The current options are:

  • Forward

  • Drop

Custom Message Filter Actions - Since 4.1.21

You may need to enable Profile > Message Filters > Custom message filter to be able to use this feature. For more info see: Message Filters | Custom filter since 4.1.21

Allows you to specify Custom Headers and Header Values that can be matched to stop emails from processing further. These are Comma Separated Values which means that multiple headers and values can be defined for each outcome.

Matching header with a specific value.

To match a header with a specific value you would need to specify the header and the value using the following format. If this header is found with that value then the email will be Dropped or Forwarded

Header2: headerValue2

Example Email:

MIME-Version: 1.0 Date: Sun, 19 Jun 2011 17:42:26 +1200 Message-ID: <BANLkTinB1mfSh+GwOXGNWoL4SyDvOpdBoQ@mail.gmail.com> Subject: This is a starting email template, update as required From: "Andy Brook" <andy@localhost> To: changeme@thiswontwork.com Header2: headerValue2 Content-Type: text/plain; charset=UTF-8 some text

Configuration options

Custom: Forward

If one of the defined headers is found in the email then it will result in a forward notification being sent to the forward users and there will be no further processing of the email.

Custom: Drop

If one of the defined headers is found in the email then it will result in a Drop outcome and no further processing will occur and no notification will be sent to forward users.

If using Profile Group then it will mean that the next Profile will be checked for processing.

Custom: Drop (exit group)

If one of the defined headers is found in the email then it will result in a Drop (exit group) outcome, which means no further processing will occur (even if using a Profile group) and no notification will be sent.

Archived issue handling

This is where you configure how JEMH will handle commenting on an issue that has been archived. The current options are:

  1. Forward - Sends a Forward notification to the Forward Users defined within Profile > Notifications.

  2. Reject - Rejects the email and will send a Reject notification to the sender if Hint notifications are enabled.

Related Pages