Versions Compared

Key

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

This page will guide you how to associate a Salesforce Object (such as an Account, a Case, a Contact, etc.) with a Jira Issue, from within Salesforce.

By doing so, you can easily link a Jira issue with the current Object, and also configure its sync behavior.

For example, when Salesforce agents receive a Case caused by a known bug, they can associate the Case with an existing Jira issue containing the bug report. This way, both the team working in Jira and the team working in Salesforce can see all related Cases and Jira issues, and push or pull data between the systems.

On this page:

Table of Contents
minLevel1
maxLevel3
outlinefalse
styledisc
typelist
printabletrue

Prerequisites

...

Associating a Salesforce Object with a Jira Issue

  1. In a Salesforce object, click Associate.

...

  1. Image Added

    The Associate Jira Issue pop-up window appears.

  2. Search for your Jira issue by entering the Issue Key or Issue Summary in the search box.

  3. If there are multiple matches, the most recently created issues will appear first.
    Only issues belonging to Projects bound to the authorized Connection will be searchable.

...

  1. Image Added
  2. You may choose to toggle the following options:
    View Only - Manual and automatic synchronization will be disabled.
    Auto Pull - Changes to the associated Jira issue will be pulled automatically to this object.
    Auto Push - Changes to this object will be pushed automatically to associated Jira issues given respective triggers are installed.

    Note
    (warning) Some combinations are not possible and cannot be selected. Refer to the help provided under the What Will Happen? panel.

    You can also choose what to do after the Jira issue is associated by choosing from the following options:

...

  1. csfjira-after-assoc.pngImage Added
  2. When you are satisfied with your configuration, click Associate.

  3. Upon successful association, the Issue associated successfully message is shown.

...

  1. Image Added
Info

Jira Issues Display in Lightning

JIRA issues in Salesforce Lightning are listed as cards if the association is less than 5. Otherwise, they are shown as a table which aligns with the Lightning Design System.
Image Modified

Known limitations

  • Each Jira issue can be associated with a maximum of 300 Salesforce records only due to a storage limitation imposed by Jira.

  • When using the Salesforce NextGen Lighting Component, the maximum amount of JIRA associations than can be displayed is 50.

Related information