Versions Compared

Key

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

Introduction


In the Mappings configuration page, there are multiple settings you can configure to your liking.

The following options are available for you to set:

  • Automatically Push New Comments to Remote System
  • Automatically Pull New Comments from Remote System
  • Pull comments from Remote System
  • Automatically Push New Comments for Issues Associated with Multiple Remote Objects
  • Restrict Comments to be Pushed Based on Roles and Groups (Allow push for only "All Users")
  • Validate JIRA Issue Required Fields
  • Optimize Query to Remote System (Only query fields mapped, limited details sent to JIRA)
  • Synchronize Attachments from Remote System (Enabling this feature will disable the old feature "Remote Attachment Tab")
Panel
titleColor#205081
titlePage Contents

Table of Contents
maxLevel2

Anchor
AutoPushComments
AutoPushComments
Automatically Push New Comments to Remote System


When configuring mappings with certain objects (currently we support Cases and Ideas), the Automatically push new comments option becomes available.

This setting is used to instruct the add-on to automatically send new comments from JIRA to Salesforce or not:

  • Enabled: all new comments on the JIRA issue are created as a new comment in Salesforce.com in the related Case/Idea.
  • Disabled: new comments will not be created in Salesforce.com.

You can toggle this option by:

  1. Accessing the Field Mapping Interface
  2. Click Settings
  3. Click on the button next to the Automatically push new comments to Remote System setting to enable or disable.

When disabled, you can still choose to send comments individually to the related Salesforce.com Case or Idea.

For more information, see: Pushing a comment from JIRA to Salesforce

 

Anchor
AutoPullComments
AutoPullComments
Automatically Pulling New Comments from Remote System


The Automatically pull new comments from Remote System is only available for Cases and Ideas mapping.

This setting is used to instruct the add-on to copy a Salesforce.com Case/Idea comments to JIRA Issue or not:

  • Enabled - all comments on the Case/Idea will copy and sync to JIRA Issue .
  • Disabled - no comments will copy to JIRA issue.

This setting applies when using create endpoint or synchronize endpoint from Salesforce.com for Case/Idea Objects or using Pull Changes in More > Manage Application Link from JIRA Issue.

Anchor
PullComments
PullComments
Pulling Comments from Remote System


This setting allows you to control what comments are pulled from Salesforce.com to JIRA:

  1. All - All comment will sync from Salesforce.com
  2. Private only - Only private comment will sync to JIRA issues
  3. Public only - Only public comment will sync to JIRA issues

 

Note
titleRegarding Comment Synchronization

Prior to version 5.3.6, all comments (whether public or private) were synchronized by default.

As a consequence, if you change the Pull comments from Remote System settings in this situation, all comments made prior to updating to version 5.3.6 will still be viewable.

Also, do take note that in situations where you have enabled the Public only option and synchronized your JIRA instance with Salesforce.com, and then changed the setting to Private only, all public comments will still be viewable.

Anchor
AutoPushNewCommentsIssuesAssocMRO
AutoPushNewCommentsIssuesAssocMRO
Automatically

push new comments

Pushing New Comments for Issues

associated with multiple remote objects

Associated with Multiple Remote Objects


The Connector will automatically trigger the update to include every new comment made in a JIRA issue to a Salesforce.com Object.

This option is to control this scenario for JIRA Issues that are associated with multiple records of Salesforce.com Objects:

  • Enabled - all comments on the Case/Idea will push to Salesforce.com Case/Idea automatically.
  • Disabled - no comments will be pushed to Salesforce.com.

The comment can also be pushed manually. Refer: Pushing a comment from JIRA to Salesforce

 

Anchor
RestrictComments
RestrictComments

Restrict comments

Restricting Comments to be

pushed based

Pushed Based on Roles and Groups (Allow push for only "All Users")


The connector will allow to limit the comments sharing base Connector allows limiting of comment sharing depending on the JIRA User Roles and JIRA User Group.

 

This option is Image Added

The options available to restrict a JIRA comments as below:

  • Enabled - Only the comments that are viewable by "All UserUsers" will push be pushed and synchronize synchronized with a remote system.
  • Disabled - All comments will be available to share to Salesforce.com

Image Added

 

Anchor
OptimizeQuery
OptimizeQuery
Optimizing Query to Remote System (Only Query Fields Mapped, Limited Details Sent to JIRA)


The Connector is using Salesforce Object Query Language (SOQL) internally. It will generate a script to query the record of a Salesforce.com Object.

Image Added

This option may impact performance of the instance. The following settings are available:

  • Enabled - Only query the mapped fields and limited details sent to JIRA. The Connector performance will be better but you won't be able to modify the field template.
  • Disabled - Performance will be slow for Salesforce.com Objects with a lot of fields.
Warning

You will need to restart the JIRA instance after reenabling this feature.

Anchor
SyncAttachments
SyncAttachments
Synchronizing Attachments from Remote System (Enabling this feature will disable the old feature "Remote Attachment Tab")


The Connector only supports attachment synchronization from Salesforce.com Cases to JIRA Issues.

Image Added

The configurable options are as follows:

  • Enabled - This will remove the "Remote Attachment Tab" and the attachment will become a JIRA attachment.
  • Disabled - This will render a list of attachments. Salesforce.com credentials are required to view/download the attachments.