Versions Compared

Key

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

Introduction


There are some fields in which you may need to map values in JIRA to values in the remote system. Typically such fields would have pre-determined values users can select from, such as Status or Priority.

It would not make sense in most situations to map free text fields, although this can be done.

The following is an example:

In JIRA you might have the following Status options:

  • Open
  • In Progress
  • Reopened
  • Resolved
  • Closed

In Salesforce you might have the following Case Status options:

  • New
  • Working
  • Escalated
  • Closed

The JIRA status field is read-only, but you can still sync from JIRA to Salesforce. What this means is the Connector will have to translate the status of the JIRA issue to a legitimate status in Salesforce, as "Reopened" for example has no equivalent (yet) in Salesforce. You can decide to have the following mappings that make sense:

 


JIRA
 

Salesforce
Open➡️New
In Progress➡️Working
Reopened➡️New
Resolved➡️Escalated
Closed➡️Closed
Panel
titleColor#205081
titlePage Contents

Table of Contents
maxLevel2

Tip
titleProTip

Value Mappings are case sensitive and must not include trailing white spaces.

Step-by-Step Guide

Mapping Values in JIRA to Values in Salesforce


The above example will be used in the steps below:

  1. Go to the Field Mapping Configuration Interface. 
  2. Click the Map Values link next to the configured field mapping that you would like to enable value mappings for.



  3. Add each value mapping in the Map Values form and click Submit after each one.



  4. Each mapping will appear in the Value Mappings table and should look similar to the following image when complete.

Tip
titleProTip

Note that you have to specify mappings for both directions of the synchronization, so if you configure a mapping for JIRA Priority to Salesforce Priority, you will need to configure a mapping for Salesforce Priority back to JIRA Priority.

The reason for this is because there are cases where the mappings are not always 1 to 1 and as such, requires uni-directional mapping configurations.

Mapping Null JIRA Values


It is possible to map null JIRA values to Salesforce values instead by entering "null" while mapping values:

Image Added

In the example above, when a JIRA issue description is left empty by the user, the corresponding Salesforce Case description will display "Same as Summary" when the two are synchronized.