Page Comparison

...

Scenario 1 : Create a Profile

Create a basic Profile

1. Create a Profile:
   

   Image Modified

2. Defining the "Catch Email Address" of your inbound mailbox, the target Project, and the IssueType:
   

   Image Modified

3. See the new Profile, configuration of which is through the cog icon, it can also be copied the + icon, as well as exported (useful for support!) and deleted.
   

   Image Modified

4. A summary of key information in the Profile, indicating defaults, can be seen by expanding the Catch Email Address

5. Use the Cog Icon to access the Profile, from here it is possible to edit some profile top level settings (1), and to gain access to the Project Mappings (2).
   

   Image Modified

6. Accessing the Project Mappings will show just the default Project Mapping, the lack of rules is shown by 

   Image Modified

   .  Configure the Project Mapping via the cog icon:
   

   Image Modified

7. The Profile view shows the vertical nav that will take you to specific sections of the Profile, in the main panel view are summaries of each section, with a Pen icon, which also takes you to the edit view of the section:
   

   Image Modified

8. To reinforce the 'default' nature of this Project Mapping, access the Rules link from the vertical nav:
   

   Image Modified

Validate Profile handling

Validating expected outcome of email handling can be done quickly and easily with a JEMHC Test Case, where an 'email' can  be crafted with a valid TO: address that matches the "Catch Email Address" in the profile (your mailbox inbound address).

1. Create a Test Case:
   

   Image Modified

2. Whats shown next is the platform neutral standards based format for a simple text email, select the profile created above (1), then  set the From: SMTP address (2) to be something valid, and the To: address (3) to be the Profile "Catch Email Address".  From this screen its also possible to upload (4) a previously exported email (in this neutral TEXT format, not a proprietary binary .msg format).  Finally hit Submit to save (5):
   

   Image Modified

3. The Created Test Case can now be run against the Profile it's associated with:
   

   Image Modified

4. The Result of running a Test Case will show the Issue Key of the created issue, and some other info:
   

   Image Modified

5. As custom fields already exist for 'Email Sender Address' and 'Email Participants' the resulting issue would look like:
   

   Image Modified

Summary

In this scenario, all mail will end up in the given project, that's it.  For more flexible use of one profile to route mail to different projects, see following scenarios.

...

Once a basic Profile with default Project Mapping exists, adding a new Mapping for a new project that will route some mail to that mapped project, and all other mail to the default Project Mapping project. More information pertaining to Rules can be found here: Rules.

Types of Project Mapping Rule

...

Create a new Project Mapping

1. In the Profile Project Mappings view, hit Create:
   

   Image Modified

2. Set the Project and give it a name, then hit Submit
   

   Image Modified

3. This Project Mapping doesn't yet have any Rules, so will never be used, indicated in the post-Submit view -

   Image Modified

   .  Use the Cog icon to configure the Project Mapping:
   

   Image Modified

4. Here the TEST Project Mapping is now available for configuration, all fields marked 

   Image Modified

    will without further change, automatically take on the value defined in the Default Project Mapping (by the way, this is to minimize the amount of configuration that needs to be done!).  Access the Rules section now:
   

   Image Modified

5. Initially, with no rules defined, again

   Image Modified

    will indicate the Project Mapping wont be used, so hit Create to define one:
   

   Image Modified

6. Rules can be created that match using regular expressions on the From or To (recipient) addresses defined in the email, as well as keywords, in this example, we'll map any sender from the @localhost domain with the regular expression .*@localhost (in regular expressions, * means any number of the preceding character not all characters, to match any character . is used, hence .* to match everything):

   Image Modified

7. After submitting, the summary for the rule is shown:

   Image Modified

Validate new Project Mapping

With this project mapping rule in place, any mail from @localhost will get handled through this Project Mapping, and be created in the TEST project

1. Create a new Test Case with a From: address of example@localhost and a To: address of the usual catchemail (incoming mailbox) address.  To do this, create a copy of the Test Case that was made earlier, using the copy option to get going:
   

   Image Modified

2. Change the From: address for this case to example@localhost and Submit
   

   Image Modified

3. After saving, run the new Test Case:
   

   Image Modified

4. The Test Case post-execution result screen shows that an issue was created in the TEST project, and specifically, through the Rule:  Rule=Sender 'example@localhost' matches '.*@localhost'
   

   Image Modified

...

...