Search this space

Live demo

Want to see a live demo and learn what this Connector can do? Join our jam sessions!

Page tree

If you are looking for documentation for the new Salesforce & JIRA Cloud Connector, click here.

Skip to end of metadata
Go to start of metadata

Introduction


The Connector provides a set of URLs that can be used by Salesforce.com to call on JIRA functionality such as creating new issues or viewing related JIRA issues from within a Salesforce.com object page.

These URLs are listed, for every Salesforce object mapping, under that object's mapping configuration under the Endpoints heading.

Page Contents

Locating the Endpoint URLs


To find the Endpoints for the Salesforce object mapping:

  1. Go to Cog Icon  > Add-ons.
  2. In the sidebar, under Cloud Connectors, click Mappings.
  3. Choose the desired Salesforce Object mapping and click Configure.


     
  4. At the Configure Mappings screen, you will see the > Endpoints label.
    Click on the > Endpoints label to display the Endpoint URLs table.

     

  5. You will see something similar to the following image:

     

 

The URLs Required for Configuring Your Salesforce Instance


The Endpoints URL table, when expanded, displays the list of possible actions Salesforce can call for this object.

The URLs associated with each action are available on that screen as reference for the JIRA administrator to copy and paste into Salesforce during configuration.

Anatomy of an Endpoints Table

Below is an example of an Endpoint URL table from a system with a base JIRA URL of http://localhost:5130:

 

Reference

Field Name

Definition

1

Create

URL used to access JIRA action to create new issues.

2

Fetch

URL used to search for results in JIRA. Used to grab related issues of a Salesforce object.

3Pull UpdateURL used to get update from JIRA Issue especially with the not 1 to 1 relationship

4

Synchronize

URL used to sync details in the Salesforce object with the linked JIRA issues.

5

Create or Update

Similar to #1 except it will provide an option to sync information if there are already some issues linked to the object. If there are not then the behavior is exactly as for #1.

6Link

URL used to link Salesforce Object with Remote Object Link or Multi Remote Object Link field in JIRA issue.
Replace {!Remote Object Link or Multi Remote Object Link Custom Field Id} with the Custom Field ID of the desired Remote Object Link or Multi Remote Object Link. (View sidebar for steps on getting the Custom Field ID.)

7AssociateURL used to associate with more than one JIRA issue with synchronize capability

URLs are not editable!

These URLs are not editable directly in JIRA.

They are only made available in the Endpoints table for the JIRA admin's reference for use while configuring Salesforce.com.

Where do I find the Custom Field ID?

  1. Go to Cog Icon > Issues
  2. In the sidebar, under Fields, click Custom Fields
  3. Choose your desired custom field, then click on the pull-down menu on the right, and click Configure
  4. Now look at the address bar at the top.
    At the end of the URL, you should see something similar to this:
    "customFieldId=xxxx",
    where xxxx is your Custom Field ID.

Full List of Salesforce Objects


Please refer to the Salesforce.com documentation page for Standard Objects for the system name of your Salesforce object if it is not one of the above.

The Id field is always named as such and so the pattern for the syntax is:

{!<OBJECT_NAME>.Id} 

 

Regarding Visualforce Pages


For Visualforce pages only, the following syntax can be used generically for all objects:

{!$CurrentPage.parameters.id} 

Example: 
http://localhost:5130/plugins/servlet/customware/connector/issue/2/Case/fetch.action?id={!$CurrentPage.parameters.id} 

 

  • No labels