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")
  • Allow updates on comments originated from Remote System
Panel
titleColor#205081
titlePage Contents
toc

maxLevel2

Anchor
AutoPushComments
AutoPushComments
Automatically

Push New Comments

push new comments to Remote System

When configuring

mappings

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

Jira to Salesforce or not:

  • Enabled: all new comments on the
JIRA
  • 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.
Image Removed

  1. Image Added

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  

Anchor
AutoPullComments
AutoPullComments
Automatically

Pulling New Comments

pull new comments from Remote System

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

mapping

Mapping.

Image Removed

Image Added

This setting is used to instruct the add-on to copy a Salesforce

.com

Case/Idea comments to

JIRA

Jira Issue or not:

  • Enabled - all comments on the Case/Idea will copy and sync to
JIRA
  • Jira Issue.
  • Disabled - no comments will copy to
JIRA
  • 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

Jira Issue.

Anchor
PullComments
PullComments
Pulling

Comments

comments from Remote System

This setting allows you to control what comments are pulled from Salesforce

.com

to

JIRA

Jira:

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

 

Image Removed NotetitleRegarding Comment Synchronization

Image Added

Note

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

Jira instance with Salesforce

.com

, and then changed the setting to Private only, all public comments will still be viewable.

Anchor
RemoteSystemComments
RemoteSystemComments
Allow updates on comments originated from Remote System

Image Added

Which comments are affected by this setting?

When a Jira issue is created from Salesforce, all existing comments from Salesforce are copied into Jira and added with a label, for example:

This comment was made by John Doe on Wed Jun 29 16:15:06 PST 2016 from Salesforce

  • Disabled - Any edits made to these comments within Jira will not be reflected in Salesforce upon the next synchronization.
  • Enabled - Any edits made to these comments within Jira will be reflected in Salesforce upon the next synchronization.

Anchor
AutoPushNewCommentsIssuesAssocMRO
AutoPushNewCommentsIssuesAssocMRO
Automatically

Pushing New Comments for Issues Associated with Multiple Remote Objects

push new comments for issues associated with multiple remote objects

The Connector will automatically trigger the update to include every new comment made in a

JIRA

Jira issue to a Salesforce

.com

Object.

Image Removed

Image Added

This option is to control this scenario for

JIRA

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

 

Anchor
RestrictComments
RestrictComments
Restricting

Comments

comments to be

Pushed Based

pushed based on Roles and Groups (Allow push for only "All Users")


The Connector allows limiting of comment sharing depending on the

JIRA

Jira User Roles and

JIRA

Jira User Group.

Image Removed

Image Added

The options available to restrict

JIRA

Jira comments:

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

Image Added

 

Anchor
ValidateJIRAIssue
ValidateJIRAIssue
Validating

JIRA

Jira Issue

Required Fields

required fields

Creating

JIRA

Jira issues using the Connector has two methods of validation:

  • Enabled - The connector will obey the required fields and default value settings. Unmapped or empty values of required fields will be populated after clicking the Create button.
  • Disabled - New
JIRA
  • Jira Issues will be directly created without any
JIRA  
  • Jira validation.

Image Removed

 

Image Added


Anchor
OptimizeQuery
OptimizeQuery
Optimizing Query to Remote System (Only

Query Fields Mapped, Limited Details Sent to JIRA)

query fields mapped, limited details sent to Jira)

(warning) You will need to restart the Jira instance after reenabling this feature.

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 Removed

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
  • 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
. WarningYou will need to restart the JIRA instance after reenabling this feature
  • .

Anchor
SyncAttachments
SyncAttachments
Synchronizing

Attachments

attachments from Remote System (

Enabling this feature will disable the old feature

This will turn off the "Remote Attachment Tab" when enabled.)

The Connector only supports attachment synchronization from Salesforce

.com

Cases to

JIRA

Jira Issues.

Image Removed

Image Added

The configurable options are as follows:

  • Enabled - This will remove the "Remote Attachment Tab" and the attachment will become a
JIRA
  • Jira attachment. It will also make a previously hidden setting, Synchronize files from Remote System, become visible.
  • Disabled - This will render a list of attachments. Salesforce
.com
  • credentials are required to view/download the attachments.

 

Anchor

RemoteSystemComments 

IssueCommentedEvent

RemoteSystemCommentsAllow updates on comments originated from Remote System

Image Removed

Which comments are affected by this setting?

When a JIRA issue is created from Salesforce, all existing comments from Salesforce are copied into JIRA and added with a label, for example:

This comment was made by John Doe on Wed Jun 29 16:15:06 PST 2016 from Salesforce.com

Disabled - Any edits made to these comments within JIRA will not be reflected in Salesforce upon the next synchronization.

Enabled - Any edits made to these comments within JIRA will be reflected in Salesforce upon the next synchronization.

IssueCommentedEvent
Dispatch Issue Commented event upon new comment synchronization

If enabled, the "Issue Commented" event will be triggered whenever a new Salesforce Comment is created.

Image Added

Anchor
IssueCommentEditedEvent
IssueCommentEditedEvent
Dispatch Issue Comment Edited event upon edited comment synchronization

If enabled, the "Issue Commented Edited" event will be triggered whenever a new Salesforce Comment is edited.

Image Added