Versions Compared

Key

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

The Connector for Salesforce & Jira supports synchronization of cascading fields in Jira with dependent fields in Salesforce.

Four modes of synchronization are required:

  1. Jira Parent - Salesforce Picklist

  2. Jira Child - Salesforce Picklist (Legacy)

  3. Merged

  4. Cascading

Requirements

Warning

Value mappings need to use the exact IDs as shown on the Salesforce page, with the correct case (IDs are case-sensitive). and with no spaces before or after the value. For example,  00590002fBnyAAE

 is

 is not the same as  00590002fbnyaae.

Jira

  • Cascading select lists

icon
Note
false

(warning) Cascading select lists are a type of Jira custom field. Read more on how to create custom fields in Jira

Salesforce

  • Salesforce Picklist

icon
Note
false

(warning) Salesforce Picklist fields can be dependent fields. Read more on how to create dependent fields in Salesforce.

Cascading field mapping modes

...

This mode allows you to synchronize only the Parent value of your Jira cascading select list to a Salesforce picklist (dependent or non-dependent picklist).

  • You are not able to synchronize bi-directionally in this mode.

  • You are not able to update based on the Child value of your Jira cascading select list.

...

Jira Child  - Salesforce Picklist (Legacy)

...

This mode allows you to synchronize only the Child value of your Jira cascading select list to a Salesforce picklist (dependent or non-dependent picklist).

  • The synchronization only works in one direction, from Jira to Salesforce. 

  • You are not able to update based on the Parent value of your Jira cascading select list.

...

Merged

Merge mode allows you to synchronize a combination of the Parent and Child value of your Jira cascading field to a Salesforce picklist (Parent/Child or non-dependent picklist).

  • You are able to synchronize bi-directionally in this mode.

  • You are not able to update based on the Jira Cascading Child values.

  • The Jira value mapping format required for this mode is: Parent Option;Child Option.

...

Cascading

This mode allows you to synchronize the field values in a fully cascading manner.

You can define the Parent value of your Jira cascading select list to a Salesforce picklist value (Parent or non-dependent picklist), and the Child value of your Jira cascading select list to another Salesforce picklist (Child or a non-dependent picklist).

  • You are able to synchronize bi-directionally in this mode.

  • You are required to choose the corresponding Salesforce child and parent fields to use this mode.

...

Warning

Be aware that switching between synchronization modes will result in losing existing field value mappings. You will also be required to select a second (dependent) picklist when switching from either the first 3 modes to the Cascading mode.

Create a  Cascading field mapping

  1. Select a Jira cascading select list custom field in the field mapping.

...


  1. Image Added

     

  2. Select the corresponding Salesforce field(s).
    Depending on the Cascading mode, you can either select only the first field or both.

...


  1. Image Added
  2. Click + Add to add the newly-created field mapping.

  3. Then click Configure on the field mapping you just created.

...


  1. Image Added
  2. Choose the appropriate synchronization mode that fits your use case.

...


  1. Image Added
  2. Add the Parent or Child values for both Jira and Salesforce and click Add.

  3. Save the value mapping configuration when you are done.