Versions Compared

Key

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

...

Project Mappings can also have two key configurations:

  • the checkbox Join Group From Email Domain set, that will create a group based on the domain of the users.

  • the select Add Group to Given Project Role, that will automatically add dynamically created groups into the nominated Project Role.

Tip
title

Order of matching

JEMH will make the following checks for a match in order. As soon as a match is made, that's it.

  1. Email From:

  2. Email Addressee: (note: this is filtered through catchEmail and/or jemhAddresseeRegexp values for matches against incoming addresses)

  3. Group matching

User Creation

Creating users is required, but that doesn't mean taking a JIRA seat, in the JEMH Users section, ticking create users will create users, perhaps based on their email address. Optionally, they can be auto-joined to a group. If you were to use jira-users this would allow them to login (taking a JIRA seat), seting this to nonjira-users for example, would not allow them to login but will allow creation of issues through JEMH.

...

In order for the Project Mapping to be active, JEMH needs to match an incoming email as suitable, this can be done with:

  • email domain mappings

  • group mappings

Domain Mappings

A domain mapping can be a full email address or a partial address using regexp expressions like:

No Formatcode
.*@yourco.net

Domain mappings can be used to match against the sender or the addressee, and also have an optional component that will be used for that particular match.

...

To allow you to validate your configuration works as expected, a test case can be made where you are able to set any aspect of an email you need to:Image Removed

...

Creating a test case

Click the 'Create' icon link to create a new test case, this will create the basic outline of a simple email:Image Removed

...

(info) Note: When creating a Test Case, you need to associate it with a Profile to allow it to be run
(info) Alternate content: You are free to paste in any 'original' email content into a test case window, all content is stored on disk.
(info) Upload content: You may also upload a local email file

After saving it will show up like this:Image Removed

...

Once created, operations available include run, edit, copy, delete.

...

For context, the example test case has the following configuration:

...

Project Mapping

Showing project mapping configuration

...

User configuration

Showing user creation settings
Image Removed

...

Issue configuration

Showing add sender as watcher:

...

...

User configuration

Showing user creation settings

...

Running a test case

If your configuration is good, you should see an Created: Issue link, this example has used Project Mapping to associate a specific sender email domain to a specific Project and component:Image Removed

...

Clicking on the link takes you to the issue:Image Removed

...

Note the following

  • Project set through Project Mapping

  • Component set through Proejct Mapping

  • reporter was auto-created as user