Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

A profile can be mapped to more than one project, using the Project Mappings as previously described.  If there is more than one project mapped then you can use rules to direct the emails to the correct project.  If there is only one project mapped, then you will not be able to add a new rule, because the default settings will always apply.

Creating a rule

Info

Rules can only be created for non default Project Mappings.

Navigate to your Profile Configuration via Profile > Project Mappings > A Project Mapping Item > Configure (Cog Icon). By clicking on Rules on the left of your screen, then click on Create to add a new rule.

Image RemovedImage Added

This will add a new option to the Rules page

Once created you will need to press the Cog icon to edit the configuration.

Syntax help for using regexps are described on this page. A more in depth guide on how to create Project Mapping Rules can be found here: Use Project Mappings | Scenario 2: Adding a Rule Driven Project Mapping.

After you have filled in the fields, click on Save to save your changes.

Configuration options

Rule Configuration

Active

If selected it mean that the Rule is active and can be used to process incoming emails.

Apply Strategy

This defines the strategy that should be used when matching incoming emails. Current Options are:

  1. Or - The emails will only need to match one of the configuration options within this Rule.

  2. And - The emails will need to match all of the configuration options within this Rule. e.g. needs to match the From Regexp and a Keyword.

Addresses and Keywords

Priority

This defines the Priority of this Rule. Higher the number = lower priority.

  • This only applies when the Rule Evaluation Strategy is set to Rule Priority. Found within the Global Profile configuration.

From regexps

This is a list of regexps used to match the email sender address.

From is From Any Group

This checks if the sender is a Jira User that belongs within one of the selected group.

Recipient regexps

A list of regexps that is used to match specific email recipients address.

Keywords

List of strings to look for within the email’s body or subject.

Keyword Scope

Defines whether the keywords rule should be applied. This can be body, subject or both.

Script Configuration

This is where you can create a Custom Script that will check if the incoming email matches specific conditions. For more info see: Script Rules

Configuring a Rule

Rule Configuration allows specific rules to drive parameters and configurations, such as Issue Parameters (.i.e. Issue Type , Priority etc…) or even configure other features with specific set configurations' to the matched Rule Item such as Pre-Processing, HTML Format, Field Processors, Attachment Configuration, User Configuration. A full Summary of each configurable action is listed on Summary panel.

To navigate to the Rule Configuration find the rule you want to configure via Profile > Project Mappings > A Project Mapping Item > Configure (Cog Icon) > Rules > A Rule Item > Cofigure (Cog Icon).

You will first find yourself at the Rule Page. On this page you can edit the Rule items match condition/trigger via the Edit Button.

You can navigate to the summary page to review all configurations currently set on the rule. To edit each configuration click on the related configurations edit button (pen icon) as shown below (note only a few of the possible edit buttons are highlighted below scroll down the Summary Page for for more):

Or you can go to each configurations' dedicated panel via the navigation list on the left, as shown below:

Shortcut for editing already existing rules

You can quickly select an existing rule to edit via Profile > Project Mappings > A Project Mapping Item > Rule Column > Rule Item > Edit Icon (Pen Icon) which will take you the Rule Configuration more info in heading: Rules | Configuring a Rule. As shown below:

Filter by label (Content by label)
showLabelsfalse
max5
sortmodified
showSpacefalse
reversetrue
cqllabel in ( "rules" , "project-mapping" ) and space = "JEMHC" and type = "page"