Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Excerpt
hiddentrue

JEMH provides Enterprise message handling features for your JIRAJira, including auditing, flexible message routing and more.


Name

Enterprise Message Handler for JIRA Jira (JEMH)

JIRA Compatibility

From Jira 5.0 onwards see Marketplace for current JIRA releasesand newer. See Marketplace versions listing for specific details.

Support

Ask a question, raise an issue or email us for support

License

Commercial, get a free evaluation license via the installed JEMH add-on License section

Purchasing

After installation, see the JEMH add-on License section. also, sales@thepluginpeople.com

Marketplace

https://marketplace.atlassian.com/plugins/com.javahollic.jira.jemh-ui/server/overview

Issue Tracking

Issues are tracked on JIRA Jira Cloud


Gliffy
baseUrlhttps://thepluginpeople.atlassian.net/wiki
chromemin
size300
html5false
nameJEMH Functional Overview
alignleft
containerId2850832

Page Tree
searchBoxtrue

Overview

The Enterprise Message Handler for JIRAJira (JEMH) provides key business enabling functionality for your JIRAJira.  It currently supports several communication channels including Email, HipChat, SMS and soon XMPP.

JIRA Mail handling v.s JEMH enhanced handling

JIRA Mail Handler

JEMH Mail Handler

Comparing the standard mail handler with JEMH

Standard Jira mail handlerJEMH mail handler
  • Capability to pull mail into JIRAJira, creating and comment on issues, add attachments etc. It does that by specifying a (singular) target project. The relationship is one handler/project to one mailbox
  • Ability to consume emails from unregistered users (but not the ability to include those users in updates to created issues)
  • Ability to create users from their email address
  • Depending on the 'choice' of mail handler different 'capabilities' can be gained, but they cannot be used together.
  • HTML email has a basic conversion to wiki markup compatible output

Inbound Mail Handler

  • JIRA email handlers don't scale Scalability - with large numbers of inbound mail handlers there are significant resource and maintenance overheads. Using JEMH, you can route many addresses from a common mailbox to many projects, effectively supporting n projects with n mailboxes with one mailbox connection (this is why JEMH was first written).
  • Auditing - JEMH optionally retains history of emails received and what happened in case of failure.  Once the failure has been addressed, it is possible to re-process these emails
  • Round trip support for both JIRA Jira users (via standard JIRA Jira Notification schemes) as well as email users
  • JEMH configurations (Profiles) include all inbound mail handling configuration. A Profile can be referred by one or many JEMH Mail Handlers, reducing complexity. Profiles can be exported and imported, allowing environment migration, and supply for support purposes.
    • Project Mappings within Profiles allow mail to be routed to Projects based on Rules, Sender or JIRA Jira mailbox Recipient, Keyword (body/subject) or sender user group. Each Mapping underlying Rule can be used to route mail and customize how they are created (change assignee, priority, labels etc)
    • Directives are commands that are email supplied key/value pairs allowing issues to be modified (e.g. priority, custom fields, workflow).  These can be applied during create or comment, with blacklist/whitelisting and JIRA Jira user group usage restrictions as needed
    • Field Processors are different 'interpreters' for email supplied content, most enable Directives supplied in a different way. The most versatile of these is the Regexp Field Processor which enables extraction of values from emails via Regular Expressions. Values are mapped to custom fields, but also, with such extracted values, its possible to translate these external values (e.g. priority 'must have' to internal JIRA Jira specific values 'blocker' via JEMH Aliases.
  • Customizable templates (Text, HTML, Subject) for all events. Ability to preview template edits (render the template) at edit time
  • Customizable notifications for email users v.s. JIRA Jira account holders (enable different events)
  • Email compatibility, JEMH has extensive support for fixing defective emails. The world is full of mail sources generating 'broken' emails that are not possible to process with default handlers. JEMH can fix many structural issues 'on the fly'
  • In-line image support for a richer user experience), JEMH can in-line pasted images with wiki markup 'inline', both on the created issue and:
  • Outbound notification supporting inline images, if an issue includes an inline notification, JEMH can mail that out
  • Blacklisting of emails by subject out of the box, based on regexp.
  • Blacklisting of all standard JIRA Jira images when attached, of image attachments based on size (e.g. <5K), of images specifically uploaded (signature image) based on their hash
  • BETA: Status notifications, allow JIRA Jira to notify email-only users of open/recently-closed issues.
  • Auto creation of users, but, integrated with LDAP for user lookup and correct userID usage in JIRA Jira instead of just email address
  • JEMH is designed for extensibility, key feature points are extendible making new implementations for customers specific requirements possible
  • Test Cases are a feature of JEMH that allow simple email scenarios to help validate configuration.  Test email content can be edited on-the-fly. Exporting email content from auditing to Test Cases is common, and also allows problem emails to be provided for support

Ad-hoc notifications

  • Ability for users to mail out template driven content to specified issue participants and email-only users, including selected issue attachments, feature can be secured to Roles on a per-project basis

Post Function notifications

  • Ability to drive notifications from workflow, similar feature set to the Ad-hoc notification, but also including a JEMH Custom Field for transition-specific (notification with) selected attachments.

Event Listener

The Event Listener can react to issue events as well as user events, and generate notifications for them.  Configuration of notifications can be done on a per-project basis, or globally.  Events can be enabled individually, and custom templates if created may be selected over the default JIRA Jira template. Its also possible to script mutation of the event, to 'decide' that because issues have certain properties, that a custom Issue Event needs to be fired (sending a different notification).

Compatibility

JEMH has compatible versions for JIRA Jira 5.x and newer.  In recent times, each minor version of JIRA Jira released has a corresponding minor version of JEMH (JEMH 2.0 for JIRA Jira 7.2, JEMH 2.1 for JIRA Jira 7.3 etc.).  However, this may not always be the case - check the Marketplace for compatibility details!  Learn more about upgrading JEMH.

Transports

Transports extend JEMH's notification capabilities beyond just email.  Each Transport hooks into JEMH's Event Listener system and can be enabled on a per-event basis.  As usual, customization of both HTML and plaintext content is possible.  From JEMH 2.0 onward, the following are available free of charge:

Configure JEMH to your needs

JEMH has a full user interface for real-time customisation of all features.  Configurations can be exported/imported for easy migration between environments.

Control the routing of Email to projects

Default JIRA Jira mail handler implementations are not scalable.  With project, issue and user numbers rising, you will be seeing your mail server beginning to creak under the poll load, and JIRA Jira issue creation slow down.  JEMH solves this with Project Mappings, allowing routing rules based on addressee or sender email address, sender group membership or email content.  All the while, allowing control over the attributes of created issues:

Gliffy
nameJEMH Inbound Mail Routing
version6

Enabling

JIRA

Jira as a Helpdesk

Using JIRA Jira as a Helpdesk out of the box requires creation of users, but if the interaction is fleeting, and with a lot of support traffic, a significant amount of wasted seats will accrue, never mind the JIRA Jira user account 'noise'. JEMH solves this by mapping remote user email addresses to a Custom Field, and uses a "Default Reporter" to nominally create the issue on their behalf. Updates by interactive JIRAJira-users (and remote non jira-users) cause Issue Events to be fired, to which a JEMH Issue Event Listener reacts, making use of JEMH TemplateSets, can notify remote users of these changes.

Info

JIRA Jira licensing is based on the number of interactive application users.  This refers to users that own a user account capable of logging into JIRA Jira instances.

Gliffy
nameJEMH enabling JIRA for Helpdesk use
version6

Reducing Spam in your

JIRA

Jira

So often JIRAJira's around the world get bombarded by various automated responses, e.g. Out of Office. At the least this can be distracting trying to trace an issue, at worst, it may cause email loops (though Precedence: bulk should help identify such traffic). JEMH global subject blacklisting can stop that from ever happening.

Gliffy
nameJEMH Reducing Spam in your JIRA
version5

Manipulate issues with Directives

Directives allow remote users/automation solutions to manipulate issues through email. With several formats to choose from JEMH can be the email integration glue required to join disparate systems to JIRAJira.

Gliffy
nameJEMH Directive Processing
version3

Powerful Field Processor system

JEMH extracts information from emails using Field Processors, each tailored to processing emails in a particular format.  While the Field Processors that come with JEMH should cover most needs, new Field Processors can be created and integrated with JEMH via its API.  This allows near infinite possibilities in terms of what can be processed.

Gliffy
nameJEMH Field Processor integration options
version2

Useful Links

  • How Do I.... - An extensive and ever-growing series of guides for achieving common JEMH set-up goals
  • Common Problems - Encountered a problem or error?  Check this list to see if a solution is provided
  • JEMH Issue Tracker - Can't find what you are looking for on our wiki? Post an issue there, or alternatively email us

Recent updates
max5
themesidebar