JEMH Extension Points
You'll need intermediate to advanced levels of Java development experience and knowledge of the Jira API. The support provided by us for JEMH does not cover extension development.
Extension Points
id-provider – provides a way to provide a mapped, correct or looked-up user details for a given sender email address (e.g. LDAP)
message-filter – provides a way to add further filters on incoming mail, at this time no changes to mail content can be made, only decisions to process, forward, drop etc.
custom-field-adapter – provides a way for 3rd party custom fields that don't follow the convention of the JIRA custom fields to be populated as part of email processing.
field-processor – provides a way to inject custom processing behaviour into the JEMH processing chain, such processing can 'claim' emails so even per-email targeted processing is possible.
pre-proc-task – provides a way to add additional pre-processing tasks that can alter email content found in headers, allowing processing outcomes to change
transport – add additional event notification transports that can provide alternative channels of outbound communication
Example extensions
There are some rough examples available to get you on the right track: https://bitbucket.org/pluginpeople-public/jemh-example-extensions/
Maven repository
Our public Maven repository can be found here: JEMH Nexus Repository.
Java API
Documentation can be found here: JEMH API Javadoc. Please note that the API's are subject to change, so occasional maintenance may be necessary.
Building the examples
Right now, the JEMH jemh-api & jemh-ao jar will need to be installed into your local maven repository. Download JEMH from the Marketplace, open the archive, extracting the two jars from META-INF/lib. Install each using mvn install as follows (the examples pom.xml should be updated to reflect this version):
mvn install:install-file -Dfile=jemh-api.2.4.1.jar -DgroupId=com.javahollic.jira.jemh -DartifactId=jemh-api -Dversion=2.4.1 -Dpackaging=jar
Once installed, the example project can be checked out with:
git clone https://bitbucket.org/pluginpeople-public/jemh-example-extensions/
Building with mvn is as easy as:
cd jemh-example-extensions
mvn clean install
Example plugin JAR's will be in each modules target folder, and can be installed manually by uploading through the JIRA plugin screen.