Versions Compared

Key

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

...

Check that your target Jira project does not have a notification scheme set at project settings level.  This will stop Jira from sending duplicates of the notifications that JEMH will be sending.

  1. Go to Jira>Your Project>Project

...

  1. Settings

  2. Click Notifications

  3. Click on Actions and choose Use a different scheme

    Image Modified



  4. Select None from the drop-down menu and then click Associate to save the change

    Image Modified



  5. If you plan on sending issue creation notifications to non-Jira users, you will want to make sure that you have created a custom event (see Atlassian Jira - Adding a Custom Event for more).  When creating the event for the first time, it is advisable to select the Issue Created Template as the default template to start with

  6. Go to JEMH>Profile>Configuration>Notifications and click Edit

    Image Modified
  7. For the setting On Create Custom Event, choose the custom issue creation event.  This will cause the event to be fired on issue creation which as explained later is important for notifying of issue creation in certain scenarios.

  8. A typical set up for the relevant settings here may look like this:

    Image Modified


    (info) On Comment Event Behaviour : this setting will drive JEMH to always fire an ISSUE_COMMENTED event when a comment is added - mostly JEMH would fire ISSUE_UPDATED as custom fields get manipulated.

Before starting (Disable JSM Customer Notifications)

Disable customer Notifications through your Jira Project Settings to prevent duplicate notifications to JSM Customers

  1. Navigate to: Jira > Project > Project Settings > Customer Notifications

    Image Modified
  2. Edit each notification and de-select the ‘enabled’ checkbox and save your changes

    Image Modified
  3. Repeat for all Customer Notifications

    Image Modified

Initial configuration

Some settings for the Event Listener are global and are not tied to specific projects/people.

...

  1. Go to JEMH > Event Listener, located via the main JEMH navigation and edit the ISsue Event section:

  2. Image Modified

    Enable the event listener:

  3. Image Modified

    Fallback email Custom Fields is used to define any custom fields used for email addresses that you would have set up during first configuration of JEMH

    Image Modified



  4. The Email Storm Prevention section can be used to define a notification number limit.  If the limit is exceeded, a certain action can be triggered.

    • Scheme Entity Limit  -  The number of notifications per event, per notification scheme entity (e.g. Watcher, Group).  The default is 0, which essentially disables the prevention system

    • Scheme Entity Limit Action  -  The action to be taken when limit is met

      • capAndNotifyLead  -  allows notifications to send up to the previously mentioned limit for a scheme entity, and send a warning notification to the project lead

      • sendAllAndNotifiyLead  -  allows notifications for a scheme entity to send regardless of if doing so will break the limit.  At this point however a warning notification is sent to project lead

      • sendNoneAndNofifyLead  -  stops any notifications from being sent for a scheme entity if doing so will break the limit.  Project lead is notified of this

    • Scheme Entity Limit Template  -  A custom Ad-Hoc template can be chosen when notifying the project lead


    Example ConfigurationImage Modified



  5. Jira's Outgoing Mail should be enabled in order for subsequent notifications to be sent

    Image Modified

Anchor
JIRAUserConfig
JIRAUserConfig
Configuration of Jira User Notifications

This section will focus solely on the set up of the Event Listener to send issue event notifications to Jira users.  For Non-Jira user notification set up, see Non-Jira User Configuration on this page.

  1. Click the Jira notifications tab under Transports>Email

    Image Modified



  2. If you have already created a mapping when setting up Non-Jira User Notifications, click Edit 

    Image Modified

    to the right of the mapping. Otherwise, Click New Project Mapping to start setting up a new project specific configuration

Mapping Specific Settings

...

This section will focus solely on the set up of the Event Listener to send issue event notifications to Non-Jira users.  For Jira user notification set up, see Jira User Configuration on this page.

  1. Click the Non-Jira notifications tab under Transports>Email

    Image Modified



  2. If you have already created a mapping when setting up Jira User Notifications, click Edit 

    Image Modified

    to the right of the mapping. Otherwise, click New Project Mapping to start setting up a new project specific configuration

Mapping Specific Settings

...