Sinergify Jira Plugin

Published Date: 06-12-2022

Read Time:

importantImportant!

This documentation is related to Jira Plugin Version 3.0. In order to Install & Setup the Plugin on your respective Cloud/Server Instance, kindly make sure your Salesforce side package requirements are met. i.e. Sinergify Package on Salesforce should be updated to Version 4.x or above from AppExchange.

Post Update: In Some Instances Sinergify Application panel might not be visible post update. To Resolve this, Simply go to Manage Apps > Sinergify > Configuration and then click Save to save the settings.

For Queries drop us an email at [email protected].

Sinergify plugin allows Jira users to sync Jira updates to Salesforce. With configurable syncing, the admin can decide what updates to be synced from Jira to Salesforce. Along with controlled syncing, the Jira plugin now also offers additional capabilities for Jira Users. Refer to the below use-cases for an overview.

Jira Plugin Use Cases

1) Search and Link Salesforce Records

Step 1: Find your Sinergify Application on the Jira Record Panel.

  • Sinergify Application Panel on Right Side: Right Side Compact view will show upto 5 fields of the mapped Salesforce Object for a quick glance.

  • Sinergify Application Panel on Left Side: Left Side List View can show upto ‘n’ Number of fields of the mapped Salesforce Object for a detailed view.

Step 2: Select the link button as shown below, to link an existing Salesforce record.

Link an existing Salesforce record from Sinergify List View
[Link an existing Salesforce record from Sinergify List View]


[Link an existing Salesforce record from Sinergify Compact View]

Step 3: A new window will open.

Step 4: Search Salesforce records by typing the appropriate keywords in the search field.

Step 5: Select the records that you want to link from available search results.

Step 6: Select Link. The specific record will now be linked to the Jira ticket.

2) View Linked record details

Step 7: You will see the linked records within the Sinergify App Under the Specific Object. For. eg. Case, as shown below.


[Viewing a Salesforce record overview from Sinergify Compact View]

Step 8:To see a more detailed view of the linked Salesforce record, click the Pop Out Icon as shown in the images below.


[Compact View: Open Salesforce Record Detailed View via Pop Up]


[List View: Open Salesforce Record Detailed View via Hyperlink]

Step 9: A new window will pop up, and you will see the three tabs:

  1. Details

  2. Comments

  3. Feed posts

  1. Details: This tab is used to show all the fields which are selected under the configuration screen for the current object.

  2. Comments: The comment tab will show all the comments commented on the current record. All the case comments will appear in the Case tab and also we can post the Case comments from Jira. The Tab visibility can be controlled by a Jira Admin.

  3. Feed Post: The feed post will display all the Feed items of the current record and we can also create posts from Jira.

Points to remember:

  1. Feed post tab will also have support for Rich Text .

  2. The feed post tab will be available for only those Salesforce objects whose feed is enabled under Salesforce. Jira Admin can further control tab visibility as explained below under ‘Install and Setup Plugin in Jira’.

3) Unlink Salesforce records

Step 10: If in case multiple records need to be unlinked, you can do it with the help of below steps. Jira Admin can control this feature set from Sinergify Configuration.

Note: In Order to achieve the use cases, as shown above, Please follow the steps below for configuration Inside Salesforce and Jira respectively.

4) Setup Plugin in Salesforce

Before we install the application in Jira, we need to create and set up a Connected App within Salesforce.

Step 1: From the Setup page in your Salesforce Org, enter ‘App Manager’ in the Quick Find box and click on it from the search results

Step 2:Select New Connected App to create the app.

Step 3: Basic Information

  • In the Basic Information area of the page, specify the following information to describe the connected app.

  • For the Connected app’s name, enter a name. For example, you can use ‘Sinergify Jira’.

  • For the Connected app’s API name, which is a unique identifier used when referring to the app programmatically, just press Tab. The API name defaults to the connected app’s name, replacing spaces with underscores.

  • For the Contact email, enter your email. Salesforce uses this contact information if they need to contact you about the connected app.

  • For the Logo image URL, leave it blank.

  • For the Icon URL, leave it blank.

  • For the Info URL, leave it blank.

  • For the Connected app’s description, enter the Connected app to securely access Sinergify Jira Plugin.

Step 4: API (Enable OAuth Settings)

  • In the API (Enable OAuth Settings) area of the page, select Enable OAuth Settings.

  • Enter the callback URL that will be: JiraInstanceURL/plugins/servlet/sinergify_authentication.

  • Move ‘Full access’ and ‘Perform requests on your behalf at any time’ options from ‘Available OAuth Scopes’ to ‘Selected OAuth Scopes’.

Step 5: Leave any other settings as default and select Save.

Step 6: If the below pop-up is visible, select Continue.

Note: Kindly save the Consumer Key and Consumer Secret visible under API (Enable OAuth Settings). These will be populated once all the above steps are completed. It can also be accessed again via App Manager > Select the app you just created > Under the drop-down select View.

Note: Kindly save the Consumer Key and Consumer Secret visible under API (Enable OAuth Settings). These will be populated once all the above steps are completed. It can also be accessed again via App Manager> Select the app you just created> Under the drop-down select View.

Step 7: Click Manage.

Step 8:Click Edit Policies.

Step 9: Under the OAuth Policies, select:

  • Permitted Users - Admin approved users are pre-authorized

  • IP Relaxation - Relax IP restrictions.

  • Refresh Token Policy - Refresh token is valid until revoked

Step 10: Select Save.

Step 11: On the same page, click Manage Profiles.

Step 12: Check the box(es) next to the profiles that you want to include and select Save. Make sure the profile of the specific Salesforce user who will be used to Authenticate Jira Plugin is checked.

5) Install and Setup Plugin in Salesforce

A. Installation

Step 1: Select Apps, under the drop-down menu select, Find new apps in your Jira instance.

Step 2: Enter Sinergify in the Search for apps input box and press enter.

Step 3: Select Sinergify under the results.

Step 3: Select Get App to install the application in the background. Follow the steps below once the app is installed.

B. Authentication

Step 1: In the Apps drop-down, select Manage apps.

Step 2: Select Authentication under the Sinergify sub-section on the left panel.

Step 3: Enter the Salesforce login instance URL along with the Client key (consumer key) and Client secret (consumer secret) of your connected app.

[You can now use the Consumer Key and Consumer Secret that you saved earlier in Connected App Setup, Step 6].

If you have a developer or production org, the URL will be https://login.salesforce.com, If not, it will be https://test.salesforce.com

Step 4: Select Login to Salesforce. This will redirect you to the Salesforce login page. Type in your credentials and Select Allow on the Allow Access pop-up screen.

Step 5: If the authentication is successful Salesforce Status will change from "Not Connected" to "Connected"

Step 6: Select Next.

C. Configuration

Step 1: Settings for panel on issue screen

  1. Show Panel on Issue Screen: Toggle this option to show or hide the Sinergify application completely from the Jira Issue Record.

  2. Panel Location: Select the location of Sinergify application, either Right Side or Left Side. By clicking on the icon [i], you can see a more detailed view about panel location and its use case.

  3. Allow linking of records on the panel: Toggle this option to Enable or Disable the linking of Salesforce records.

  4. Allow Unlinking of records on the panel: Toggle this option to Enable or Disable the unlinking of Salesforce records.

  5. Step 7: Salesforce Case Comments

    • Show Case Comments: Toggle the button to Enable or Disable the Case Comments Tab for Jira Users.

    • Post Case Comments: Toggle the button to Enable or Disable posting of new Case Comments for Jira Users and keep it to view only.

  6. Salesforce Chatter Feed

    • Show Feed Posts: Toggle the button to Enable or Disable Feed Tab in Jira Records.

    • Create feed Posts: Toggle the button to Enable or Disable creation of new Feed Posts and keep it to Read only.

2) Field Configuration

  1. Already Mapped Objects: This will show you the Objects that have been mapped on the Salesforce side Administration Panel. If you donot see any Object, kindly complete the Project Mapping & Field Configuation on Salesforce.

  2. Choose a Salesforce Object: Select the Salesforce object for which you want to Configure and then Select Configure Fields. If no Object is selected, the button will not be visible. Objects in the drop-down will appear with respect to what you have configured in the Salesforce Sinergify Admin setting.

  3. Configure Fields: A new screen will pop up with 4 tabs - Search, Details, List View, Compact View.

3) Search

Search results will be pulled in Jira using the fields selected below. You can select upto a max of 5 fields. Search your Salesforce fields under Available Fields and then select the Checkbox. (Only Search Compatible fields are visible).

4) Details

Salesforce object fields selected in this section will be used to show salesforce record details on the Jira issue page. Search your Salesforce fields under ‘Available Fields’ and then select the Checkbox. The order of the fields will be displayed on the Jira page as per the selection.

5) List View

The list tab will contain only those fields whose maximum character length is less than 256 characters and the selected field will be displayed on the list view panel on Jira issue Page. For. E.g. For Objects like Case, Case Number will be auto selected. See the reference screenshot below.

6) Compact View

The list tab will contain only those fields whose maximum character length is less than 256 characters and the selected field will be displayed on the list view panel on Jira issue Page. For. E.g. For Objects like Case, Case Number will be auto selected. See the reference screenshot below.

Once you have selected all the desired fields under each section, close the pop up window from top right. Select Save and then Select Next.

D. Event Configuration

  • Project Keys: Mention the Project keys, separated by commas, if you want the event listener to work only for particular Projects, else leave it blank if you want it to work for all the project keys.

  • Issue Types: Mention the Issue types, separated by commas, if you want the event listener to work only for particular Issue Types, else leave it blank if you want it to work for all the issue types.

  • Instance number: Enter the Instance Number that is mentioned on the Sinergify admin screen in Salesforce for your specific Jira

  • Issue-related events: Click the Issue-related events for which the event listener should work. Select all as a default. Select Save.

Plugin Uninstallation

Please follow the steps below if in case Plugin needs to be uninstalled from the Jira Instance.

Step 1: Click on the Apps tab, and under the drop-down menu, click Manage apps.

Step 2: Click Manage apps under the ATLASSIAN MARKETPLACE section on the left of your screen.

Step 3: Click on the Uninstall option under the Sinergify app.

Step 4: Select Uninstall and the application will be uninstalled.