Versions Compared

Key

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

...

In this tutorial we will:

  • Refer to how non-jira users details are stored by JEMH

  • Create a JIRA Custom Event

  • Refer to the JIRA Custom Event in a JEMH Profile

  • Create a JEMH TemplateSet for the JIRA Custom Event and add content

  • Create a JEMH Event Listener project mapping and tie the JIRA Custom Event to the JEMH TemplateSet

  • Execute a JEHM Test Case

  • Review results

Refer to how non-jira users details are stored by JEMH

...

Via the JIRA System screen, go to the Events section:
Image Removed Image Added

Add a Custom Event:Image Removed

...

AferAfter:
Image Removed

...

Refer to the JIRA Custom Event in a JEMH Profile

The Custom Event needs to be selected in the JEMH Profile > Config > Notifications section:Image Removed

...

Edit the Notifications section and select the Custom Event:Image Removed

...

Save it:Image Removed

...

Create a JEMH TemplateSet for the JIRA Custom Event and add content

...

NOTE: To determine whether a remote user receives HTML or TEXT is defined within the JEMH Config > Email > Templates > Non Jira User notification formatImage Removed

...

Edit the TemplateSet as needed, the Subject and payload can be anything you like, the context will have access to the $issue, as shown below. Text or HTML can be provided, the selection of which is made in the listener, this just shows Text:Image Removed

...

Create a JEMH Event Listener project mapping

JEMH Event Listener needs to have a mapping created that is used to filter incoming events to only specific projects, each project JEMH needs to support with the Event Listener has its own mapping. Create a new one one:Image Removed

...

When creating the project mapping in the Event Listener, several fields need to be provided:

  1. Notification Format, value Text to match template content above.

  2. Project Key, value TEST (matching my local project)

  3. CSV email Custom Field, value Non JIRA Participants containing non-jira email addresses as configured in the Profile.

  4. JEMH Acknowledgement event, has the related event TemplateSet Simple acknowledgement selected

...

Execute a JEHM Test Case

Rather than waiting around for a real email, or even having JIRA hooked up, we can test everything works by creating a Test Case:Image Removed

...

The example Profile has a default project TEST and a default reporter 'admin', so the test case will create an issue there, execute the test case to get details, this can either be done during a re-edit or from the TestCase screen:

NOTE: The Test Case is assocaited with a Profile, so the correct configuration is applied.

During editing

After saving

Image Removed
Image Added

Image Removed
Image Added

Running the Test Case shows the result screen, indicating the issue created:Image Removed

...

Quickly switching to the JIRA Administration screen

Image Removed

The outbound queued message should be visible, check its subject v.s. the TemplateSet subject created earlier:Image Removed

...

The received email, as text in this case will then be delivered:Image Removed

...

Further steps

Now that simple acknowledgements are being sent back to the user, its also possible to create further Event mappings, e.g. ISSUE_COMMENTED to allow some degree of chatter back to the remote user.

Filter by label (Content by label)
showLabelsfalse
max5
spacesJEMH
sortmodified
showSpacefalse

...

reversetrue
typepage
cqllabel in ( "notifcations" , "notification" , "event" , "listener" ) and space = "JEMH"
labelsevent listener jemh issue notification
Page Properties
hiddentrue


Related issues