How-to Set Up Keyword Mapping

Owned by Patrick Cartier (Unlicensed)
Last updated: Nov 28, 2020 by Steven (Unlicensed)
2 min read

In this article, we explain how to map keywords in emails to different custom fields in Jira.

 

You must have the Jira Administrator permission and an incoming mail server configured in order to complete this how-to article

Instructions

  1. Navigate to the “Incoming Mail” section of Jira Administration.

     

  2. Select the mail handler you would like to use Mapping on or follow these instructions for .

  3. Choose the “Parser” section and select which parser you would like to use. Keep in mind the formats from the parent page: .

     

  4. Choose the “Mapping” section and then the “Mapping” tab to map your keywords to Jira fields. You can also set default values in the “Default” section.

     

  5. Map your keywords to fields as you see fit. Each mapping corresponds to key/value pairs that will be expected in the body of the email, depending on the parser type chosen.

     

Example

Consider the Mapping configuration above.

Depending on the parser type, the email body might look something like this:

JSON parser

XML parser

JSON parser

XML parser

title:”Some title”
description:”Some description”
level:”High”
feedback:”Some comment”

<title>Some title</title>
<description>Some description</description>
<level>High</level>
<feedback>Some comment</feedback>

Parser Rules

  1. Specify field values rather than field IDs.
    Ex: Write <issuetype>MyTaskType</issuetype> instead of <issuetype>10000</issuetype>

  2. For multiple-value fields, separate the options by commas (,)
    Ex: Write <comps>Comp1, Comp2</comps> or comps:”Comp1, Comp2” for the JSON parser.
    Note: Spaces between values are ignored.