Versions Compared

Key

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

JEMH provides Enterprise message handling features for your

JIRA

Jira, including auditing, flexible message routing and more.

Name

Image Added

All of your email needs in Jira

The Enterprise Message Handler for

JIRA

Jira (JEMH)

JIRA Compatibility

From 5.0 onwards see Marketplace for current JIRA releases

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 Cloud

Div

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

Page Tree
searchBoxtrue

Overview

The Enterprise Message Handler for JIRA (JEMH) provides key business enabling functionality for your JIRA.  It currently supports several communication channels including Email, HipChat, SMS and soon XMPP.  Examples of some of this functionality are shown below:

JIRA Mail handling v.s JEMH enhanced handling

JIRA Mail Handler

JEMH Mail HandlerCapability to pull mail into JIRA

provides a wide array of business enabling functionality, unmatched by any other handler. It allows full configuration, which can later be exported or imported for easy migration between environments. It currently supports several communication channels including Email, Slack and SMS.

Manipulate issues via email

Directives allow users/automation solutions to modify issues directly through email. With several Directive formats to choose from, JEMH can be the email integration glue required to join disparate systems to Jira.

Powerful Field Processor system

JEMH can extract 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.

Multi-channel notification capabilities

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 plain text content is possible.  The following Transports are built in:

Control the routing of Email to projects

Standard Jira mail handlers are not scaleable. With project, issue and user numbers rising, mail servers are put under increased load and Jira issue creation slows down. JEMH solves this with Project Mappings, allowing you to route email to projects based on definable criteria. This criteria could be as simple as sender/recipient address, group membership or email content. All the while, allowing control over the attributes of created issues.

Improve help desk efficiency

Using Jira as a help desk 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 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 Jira-users (and remote non jira-users) cause Issue Events to be fired, to which a JEMH Issue Event Listener reacts, making use of JEMH Template Sets, can notify remote users of these changes.

Info

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 instances.

Filter out spam from your Jira

Often you may find Jira getting bombarded by various automated responses, for example when a user is Out of Office. This problem can be a distracting annoyance. At worst, it could cause email loops or prevent legitimate emails from being processed. JEMH has advanced Blocklisting features that can stop this from ever happening.

First-class support

Open a support request or contact us via email. We are always happy to help!

Comparison with the standard mail handler

Jira mail handler

Enterprise Message Handler for Jira

  • Capability to pull mail into Jira, 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 HandlerJIRA email handlers don't scale

email

  • 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
    • Blocklist/

whitelisting
    • allowlisting 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 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
    • Full 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
    • , including image inlining

    • Blocklisting of emails by subject out of the box, based on

    regexp
    • Regular Expressions.

    Blacklisting
    • Blocklisting 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
    • allowing 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

    Postfunctions

    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

    Outbound emails

    Its powerful event-based notification system can react to issue

    events as well as

    and 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 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 5.x and newer.  Generally for each minor version of JIRA released, there will be a corresponding minor version of JEMH (e.g. JEMH 1.8 for JIRA 7, JEMH 1.9 for JIRA 7.1).  Always check the Marketplace for compatibility details!  For more information, see the Upgrading JEMH page.

    Transports

    A relatively new feature is support of pluggable transport layers, which extend JEMH's notification capabilities beyond email.  Each Transport hooks into the Event Listener, can have per-event enablement, and customized template content in text or html.  From JEMH 2.0 onwards, the following are available free of charge:

    • HipChat - Supports Text and HTML including images
    • SMS - Supports notifications via popular SMS providers
    • XMPP (coming soon)

    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.

    Image Removed

    Route your mail

    Default mail handler implementations are not scalable, with project numbers rising, you will be seeing you mail server beginning to creak under the poll load, and JIRA issue creation slow down. JEMH solves this with Project Mappings, allowing arbitrary configurations based on addressee or sender email address, even sender group membership, in order to route to a target project. Created issues can be tailored as appropriate:

    GliffynameJEMH Inbound Mail Routingversion6

    JEMH enabling JIRA as a Helpdesk

    Using 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 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 JIRA-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 licensing is based on the number of interactive application users.  This refers to users that own a user account capable of logging into JIRA instances.

    GliffynameJEMH enabling JIRA for Helpdesk useversion6

    JEMH reducing Spam in your JIRA

    So often JIRA'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.

    GliffynameJEMH Reducing Spam in your JIRAversion5

    JEMH 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 JIRA.

    GliffynameJEMH Directive Processingversion3

    JEMH Field Processors

    JEMH has several Field Processors, each tailored to processing emails in a particular format. There are many generic formats available for inbound issue creation. Some system-specific custom integrations are also available, and will be expanded in future.

    GliffynameJEMH Field Processor integration optionsversion2

    • Control which projects JEMH monitors, and what specific events it should create notifications for

    • Separate Jira user notifications from non-Jira user notifications

    • Custom notification templates can be made for all events if desired. You can preview custom template edits while editing them.

    • Its also possible to change or ignore a received event based on a user defined script, allowing further control over notification behaviour

    License

    Commercial, get a free evaluation license via the installed JEMH app 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 Cloud

    Useful Links

    -
      • 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