Versions Compared

Key

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

...

A catch email address is an email address that your JEMH profile is configured to receive emails to (the address of the mailbox that JEMH is connected to). You should always specify a list of catch email addresses for mailbox address that you have configured JEMH to handle email from. JEMH automatically filters catch email addresses from email notifications so that you do not notify your own JEMH incoming mailbox of issue notifications, not specifying a catch email address can cause the JEMH mailbox to be notified of issue events that can then lead to a mail loop.

  • Click the Configure icon 

    Image Removed

     next Click Configure next to your created profile to access the profile configuration screen.

  • Locate the Email section and press the Edit icon 

     to modify the configuration.

  • Within the Email Selection tab modify the Catch Email Address field and insert the email address of the mailbox where JEMH will be receiving email. In this example emails are being sent to support@test.com. The Catch Email Address field is CSV compatible so you can list multiple comma separated addressesMultiple addresses can be added to this field.The Catch Email Address field is also compatible with Regular Expressions

...

The Default Reporter will require issue permissions in the associated projects that your JEMH profile will be interacting with. 

  • Click the Configure icon 

    Image Removed

     next next to your created profile to access the profile configuration screen.

  • Locate the User section and press the Edit icon 

     to modify the configuration.

  • Define the username of your desired Default Reporter within the Default reporter user name field.  In this example the username of my Default Reporter is admin.

...

JEMH Issue Creation is driven by Project Mapping's. A Project Mapping contains project specific JEMH configuration to be used when processing emails for the project defined in the Project Mapping. When processing an email JEMH will evaluate all Project Mappings defined in a profile to try and locate a Project Mapping with rules that match the email being processed. If a matching Project Mapping is found, an issue will be created in the project linked to the Project Mapping. If no Project Mapping matches via a rule, an issue will be created in the Default Project Mapping if one is defined. For this quick tutorial we are going to configure JEMH with a Default Project Mapping so that all incoming emails that do not result in an issue comment will result in issue creation inside the project defined in the Default Project Mapping.

  • Click the Configure icon 

    Image Removed

     next to your created profile to access the profile configuration screen.

  • Locate the Project Mappings section and click New Project Mapping to create a new Project Mapping.

  • Define the mapped project for the Project Mapping via the Mapped Project field.

  • Check the Is Default Mapping checkbox to make this Project Mapping the default.

  • Select Scroll to the bottom of the page and press Save.

...

  • Within the Project Mapping select Issue and select a valid issue type via the Issue Type field. (Make sure that the selected issue type does not require fields for issue creation, if a field is required for issue creation and a value is not specified, issue creation will fail.)

  • Scroll to the bottom of the page and press SubmitSave

...

Step 7 - Create and run a Test Case

  • Go to the Test Cases Tab within JEMH and click Create New

  • The Test Case editor will load with some example content pre-populated, your profile should already be selected in the Profile field.

  • The Content field contains the raw content of an email, think of it as the source code of an email. 

  • Modify the From: line in the Content field to contain the email address of a Jira user who has permission to create issues in the project defined in your Project Mapping. In the below example I have modified the from address to be the address of a Jira user named Bob.

...

  • Modify the To: line to match the address of your catch email address that you defined in the earlier step. My catch email address was support@test.com so I will use that.

...

  • Press Create after modifying the from address with the address of a valid Jira user and modifying the to address to match your profile defined catch email address.

  • The Test Case is now shown in a view of all Test Cases, press the run 

    Image Removed

     button Run to run the test case.

...

  • The result screen will show you some basic information about the processing outcome, including a link to your first issue. Click the issue key to see the issue that JEMH has created!

...