Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Field group
contentAdfStringified{"version":1,"type":"doc","content":[{"type":"paragraph","content":[{"type":"text","text":"There are 3 options for linking Jira with Salesforce with"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"short-text","parameters":{"id":"swsjabynsr","extensionKey":"short-text","name":"page:space > space:name","placeholder":"","isRequired":false,"type":"line","atlassian-macro-output-type":"INLINE"}}},{"type":"text","text":". It is possible to mix and match options to best fit your needs. Which combination you use depends on your organization's requirements. "}]},{"type":"paragraph","content":[{"type":"text","text":"The options are:"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Remote System Reference"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Remote Object Link"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Remote Issue Link"}]}]}]},{"type":"paragraph"heading","attrs":{"level":2},"content":[{"type":"hardBreak"}]}]}
fieldGroupNamemigrated
fieldGroupIdyro5vapra8
excerptThere are 3 options for linking Jira with Salesforce with . It is possible to mix and match options to best fit your needs. Which combination you use depends on your organization's requirements.  The options are: Remote System Reference Remote Object Link Remote Issue Link

...

deckIdoptions

...

idremote-system-reference
titleRemote System Reference
,{"type":"text","text":"Remote System References"}]},{"type":"paragraph","content":[{"type":"text","text":"This is typically referred to as the \"synchronization\" functionality, which is bi-directional. This allows you to create an association between a Jira issue and any Salesforce object (e.g., Case, Account, Solution, Opportunity, custom objects, etc.).

...

"}]},{"type":"paragraph","content":[{"type":"text","text":"Once associated, you can then \"share\" information across the two systems such that when the Salesforce object is updated, the Jira issue is updated as well. Likewise, when the Jira issue is updated, the Salesforce object is updated. You are able to control what fields are updated in each system with our flexible "},{"type":"text","text":"Mapping Configurations","marks":[{"type":"link","attrs":{"href":"https://servicerocket-apps.atlassian.net/wiki/spaces/CFSJ/pages/971579206/Configuring+Mappings"}}]},{"type":"text","text":". In addition, comments are also automatically synchronized across the two systems.

...

"}]},{"type":"paragraph","content":[{"type":"text","text":"This synchronization can be used in conjunction with the "},{"type":"text","text":"Remote Object Link","marks":[{"type":"link","attrs":{"href":"https://servicerocket-apps.atlassian.net/wiki/spaces/CFSJ/pages/971572508/Adding+a+Remote+Object+Link"}}]},{"type":"text","text":" option to create associations with multiple Salesforce object types.

...

"}]},{"type":"paragraph","content":[{"type":"text","text":"For example, you can use the Remote System Reference to link the issue with a Salesforce Case and then configure additional Remote Object Link references for the Account, Contact and Owner. The associated values can be mapped using our Mapping Configurations, and by doing so, the system will automatically pull across the Account, Contact and Owner of the Case when the issue is created or synchronized.

...

Advantages

"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"text","text":"Advantages"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Automatically updates the other system based on a flexible set of "},{"type":"text","text":"Mapping Configurations","marks":[{"type":"link","attrs":{"href":"https://servicerocket-apps.atlassian.net/wiki/spaces/CFSJ/pages/971579206/Configuring+Mappings"}}]},{"type":"text","text":", so data is editable in both systems

...

"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Automatically create and update comments between systems (the automatic creation can be disabled in the "},{"type":"text","text":"configurations","marks":[{"type":"link","attrs":{"href":"https://servicerocket-apps.atlassian.net/wiki/spaces/CFSJ/pages/971579206/Configuring+Mappings"}}]},{"type":"text","text":" so that you can selectively push comments from Jira to Salesforce)

...

"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"You can still access the mapped data in the event the other system is unavailable temporarily (e.g. during scheduled maintenance)

...

"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Can be used in conjunction with "},{"type":"text","text":"Remote Object Link","marks":[{"type":"link","attrs":{"href":"https://servicerocket-apps.atlassian.net/wiki/spaces/CFSJ/pages/971572508/Adding+a+Remote+Object+Link"}}]},{"type":"text","text":" to establish links to multiple Salesforce object types

...

Disadvantages

"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"text","text":"Disadvantages"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Consumes more API calls (compared to the non-synchronizing options). Salesforce enforces a limit on how many API calls are available per day for an organization (see: "},{"type":"text","text":"Salesforce documentation about API usage metering","marks":[{"type":"link","attrs":{"href":"http://www.salesforce.com/us/developer/docs/api/Content/implementation_considerations.htm#sforce_api_rate_metering

...

"}}]},{"type":"text","text":")"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"text","text":"When should I use this?

...

"}]},{"type":"paragraph","content":[{"type":"text","text":"You should use this if you want to share information between the systems so that it is updateable from both systems.

...

"}]},{"type":"paragraph","content":[{"type":"text","text":"For example, you can map the Jira issue Priority field to the Salesforce Case Priority field. When the Jira issue's priority is updated, the Salesforce Case's priority is automatically updated to match.

...

"}]},{"type":"paragraph","content":[{"type":"text","text":"Likewise, if you would like comments in Jira to appear in Salesforce (we currently support comments on Case and Idea objects) and vice versa, this is the recommended approach.

...

Further reading

...

idremote-object-link
titleRemote Object Link
"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"text","text":"Further reading"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Adding a Remote System Reference","marks":[{"type":"link","attrs":{"href":"https://servicerocket-apps.atlassian.net/wiki/spaces/CFSJ/pages/971576899/Adding+a+Remote+System+Reference"}}]}]}]}]},{"type":"paragraph","content":[]},{"type":"heading","attrs":{"level":2},"content":[{"type":"text","text":"Remote Object Link"}]},{"type":"paragraph","content":[{"type":"text","text":"This allows you to create \"Custom Fields\" which are used to associate a Jira issue with any Salesforce object. This can either be a 1 to 1 (using the Remote Object Link custom field) or a 1 to many configuration (using the Multi Remote Object Link custom field).

...

"}]},{"type":"paragraph","content":[{"type":"text","text":"Using this method, you are still able to see the various attributes of the Salesforce object (configurable to display various fields of the object), however you will not be able to update the fields of the linked Salesforce object from within Jira (you will have to log into Salesforce to do this). In a way, it is only a read-only method from Jira.

...

Advantages

"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"text","text":"Advantages"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Uses less API calls (as it does not need to update the Salesforce object, only retrieve information from it).

...

"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Allows 1 to 1 or 1 to many Salesforce object links.

...

"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Can be used in conjunction with "},{"type":"text","text":"Remote System Reference","marks":[{"type":"link","attrs":{"href":"https://servicerocket-apps.atlassian.net/wiki/spaces/CFSJ/pages/971576899/Adding+a+Remote+System+Reference"}}]},{"type":"text","text":" to be automatically set and updated.

...

"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Can link a Jira issue with multiple Salesforce object types.

...

Disadvantages

"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"text","text":"Disadvantages"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"The data will not be available in Jira when Salesforce is unavailable (e.g., for scheduled maintenance).

...

"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"The information can only be updated in the respective system (e.g., you can only update the Case from within Salesforce and can only update the issue from within Jira).

...

"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"text","text":"When should I use this?

...

"}]},{"type":"paragraph","content":[{"type":"text","text":"You should use this if you would like to link many Salesforce records to a single Jira issue where the user in Jira does not need to update the Salesforce object (and vice versa, the Salesforce user does not need to update the Jira issue).

...

"}]},{"type":"paragraph","content":[{"type":"text","text":"For example, you could use Remote Object Link to associate several Salesforce Account records to one Jira issue.

...

Further reading

...

idremote-issue-link
titleRemote Issue Link

...

Advantages

  • Configuration is not necessary (if connection is already configured), customization is easy.
  • Some data is still available when Salesforce is unavailable.
  • Allows 1 to many links to Salesforce objects.
  • Jira issue loads faster (as additional information is obtained asynchronously).
  • Can associate a Jira issue with multiple Salesforce object types.

Disadvantages

  • Cannot update the Salesforce object from within Jira.
  • The Jira issue will not display in the "Related Jira Issues" view in Salesforce.
  • Cannot search from within Jira issue navigator.

When should I use this?

You should use this to associate many Salesforce objects with a single Jira issue when you do not have complex rules around the data in Jira and do not need to see the related Jira issues from within Salesforce.

For example, you could use Remote Issue Links for when you just need to add one or more links to Salesforce objects in a Jira issue.

...

"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"text","text":"Further reading"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Adding a Remote Object Link","marks":[{"type":"link","attrs":{"href":"https://servicerocket-apps.atlassian.net/wiki/spaces/CFSJ/pages/971572508/Adding+a+Remote+Object+Link"}}]}]}]}]}]}
fieldGroupNamemigrated
fieldGroupIdyro5vapra8
excerptThere are 3 options for linking Jira with Salesforce with . It is possible to mix and match options to best fit your needs. Which combination you use depends on your organization's requirements.  The options are: Remote System Reference Remote Object Link Remote Issue Link Remote System References This is typically referred to as the "synchronization" functionality, which is bi-directional. This allows you to create an association between a Jira issue and any Salesforce object (e.g., Case, Account, Solution, Opportunity, custom objects, etc.). Once associated, you can then "share" information across the two systems such that when the Salesforce object is updated, the Jira issue is updated as well. Likewise, when the Jira issue is updated, the Salesforce object is updated. You are able to control what fields are updated in each system with our flexible  Mapping Configurations . In addition, comments are also automatically synchronized across the two systems. This synchronization can be used in conjunction with the  Remote Object Link  option to create associations with multiple Salesforce object types. For example, you can use the Remote System Reference to link the issue with a Salesforce Case and then configure additional Remote Object Link references for the Account, Contact and Owner. The associated values can be mapped using our Mapping Configurations, and by doing so, the system will automatically pull across the Account, Contact and Owner of the Case when the issue is created or synchronized. Advantages Automatically updates the other system based on a flexible set of  Mapping Configurations , so data is editable in both systems Automatically create and update comments between systems (the automatic creation can be disabled in the  configurations  so that you can selectively push comments from Jira to Salesforce) You can still access the mapped data in the event the other system is unavailable temporarily (e.g. during scheduled maintenance) Can be used in conjunction with  Remote Object Link  to establish links to multiple Salesforce object types Disadvantages Consumes more API calls (compared to the non-synchronizing options). Salesforce enforces a limit on how many API calls are available per day for an organization (see:  Salesforce documentation about API usage metering ) When should I use this? You should use this if you want to share information between the systems so that it is updateable from both systems. For example, you can map the Jira issue Priority field to the Salesforce Case Priority field. When the Jira issue's priority is updated, the Salesforce Case's priority is automatically updated to match. Likewise, if you would like comments in Jira to appear in Salesforce (we currently support comments on Case and Idea objects) and vice versa, this is the recommended approach. Further reading Adding a Remote System Reference Remote Object Link This allows you to create "Custom Fields" which are used to associate a Jira issue with any Salesforce object. This can either be a 1 to 1 (using the Remote Object Link custom field) or a 1 to many configuration (using the Multi Remote Object Link custom field). Using this method, you are still able to see the various attributes of the Salesforce object (configurable to display various fields of the object), however you will not be able to update the fields of the linked Salesforce object from within Jira (you will have to log into Salesforce to do this). In a way, it is only a read-only method from Jira. Advantages Uses less API calls (as it does not need to update the Salesforce object, only retrieve information from it). Allows 1 to 1 or 1 to many Salesforce object links. Can be used in conjunction with  Remote System Reference  to be automatically set and updated. Can link a Jira issue with multiple Salesforce object types. Disadvantages The data will not be available in Jira when Salesforce is unavailable (e.g., for scheduled maintenance). The information can only be updated in the respective system (e.g., you can only update the Case from within Salesforce and can only update the issue from within Jira). When should I use this? You should use this if you would like to link many Salesforce records to a single Jira issue where the user in Jira does not need to update the Salesforce object (and vice versa, the Salesforce user does not need to update the Jira issue). For example, you could use Remote Object Link to associate several Salesforce Account records to one Jira issue. Further reading Adding a Remote Object Link

Field group
contentAdfStringified{"type":"doc","version":1,"content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Differences between options","type":"text"}]},{"type":"paragraph","content":[{"text":"The table below summarizes the differences between the options:","type":"text"}]}]}
fieldGroupNamemigrated
fieldGroupIdxwznzudzby
Excerpt


Remote System Reference

Remote Object Links

Remote Issue Links

Link to Salesforce

(tick)

(tick)

(tick)

Custom display configuration

(tick)

(tick)

(tick)

Configuration required

(tick)

(tick)

(error)

Workflow custom field features such as validation

(tick)

(tick)

(error)

Searchable in Jira

(tick)

(tick)

(error)

Relationship visibility in Salesforce

(tick)

(tick)

(error)

Data availability when Salesforce down

(tick)

(error)

(tick)

Synchronize to/from Salesforce

(tick)

(error)

(error)

Comments synchronization

(tick)

(error)

(error)

More API calls

(tick)

(error)

(error)

Auto-lookup to Salesforce

(error)

(tick)

(error)

Associate to multiple links in Salesforce

(tick)

(tick)

(tick)

Associate to multiple Salesforce object types

(error)

(tick)

(tick)

Synchronize Remote Attachment

(tick)

(error)

(error)