Configure Entity Mappings and Field Mappings

Owned by Mark Kleinsmith
Last updated: Jul 09, 2024 by Jeff Gleeson
3 min read

This page helps you configure Entity Mappings and Field and Value Mappings for your bindings.

  • Configuring Entity Mappings means setting up Jira Issue Types to match the corresponding Salesforce Objects. 

  • Configuring Field Mappings means setting up Jira fields to match the corresponding Salesforce Fields. 

  • Optionally, you can set up value-to-value mapping for each Field Mapping.

If you haven't done so, consult the Binding a Project to a Connection page before reading this page.

To find out what Jira field types are compatible with Salesforce field types, visit the Jira Field Type to Salesforce Field Type compatibility page.

Part 1: Configuring Entity Mappings

  1. Go to Settings > Apps. In the sidebar, under CONNECTOR FOR SALESFORCE, select Bindings.

  2. On the Bindings screen, choose the binding to configure and click Mapping.

  3. On the Configure Mapping screen, click on +Add Entity Mapping.
    (Alternatively, if you have a previously exported Entity Mapping, you can also Import it here.)

  4. The Add Entity Mapping dialog appears.

  5. Choose the Issue Types you want mapped to specific Salesforce Objects.

  6. Click Add.

Part 2: Configuring Field Mappings

  1. On the far right side of the Entity Mapping you just created, click Mappings.

  2. The Task to Case Mapping dialog box appears.

    Here, you can choose the Jira Fields that match the corresponding Salesforce Field.
    You can customize the Sync Direction (inbound or outbound) by clicking the Green Arrow buttons.

  3. The example below matches the Summary Jira Issue Field to the Subject Salesforce Field and the Description Jira Issue Field to the Description Salesforce Field:

    When you’re finished, click Save.

Part 3: Configuring Value Mappings

Optionally, you can also map the field values, for example:

  • Matching the Jira status In Progress with Salesforce Status Escalated to Dev.

  • Matching the Jira priority Major with Salesforce priority High.

  • Matching the Jira component UI with Salesforce Case Reason User Interface.

If the value is not mapped, the Connector will try to match it with an exact value.

To map field values:

  1. From Part 2, select the Sync Direction (inbound or outbound) desired for the field mapping.

  2. Click on Map Values.

  3. Enter the values for the Jira field and Salesforce field accordingly.

  4. If the value of the Jira field is the user type, then a user picker will be available to select available Jira users.

  5. When you're done, click Add, then Save.

Creating inbound-only or outbound-only mappings

You can configure separate value mappings for each direction (inbound or outbound). This also allows you to map values in a one-to-many relationship. Simply create two records for the same fields, one for each direction, and then proceed with configuring the value mappings.

For example:

For inbound-only mapping:

For outbound-only mapping:

Related information