Versions Compared

Key

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

...

Ensure that you have already installed the Salesforce Package and configured a connection before continuing with this guide.

Step 1: Creating a Visualforce page

Tip

The package is shipped with ready-made Visualforce pages for Case. If you plan to use it for Case only, you can skip to Step 2. For other standard objects and custom objects, follow the steps in this section.

Creating a Jira Issues Visualforce page

  1. Go to Setup and type "Visualforce Page" in the quick find box.
    Image RemovedImage Added
  2. Click New.
  3. Provide a name and a label for the Visualforce page. 
    We recommend Jira Issues as the label and ObjectNameJiraIssuesPage as the name. Replace ObjectName accordingly. For example:
    • AccountJiraIssuesPage for Account
    • OpportunityJiraIssuesPage for Opportunity
    • MyCustomObject__cJiraIssuesPage for MyCustomObject MyCustomObject__c
      Image RemovedImage Added
  4. Paste the following into the Visualforce Markup editor:

    tab-group


    Cloud

    deckIdtabCloudxmlxmlJIRA Issues Visualforce Page
    <apex:page standardController="ObjectName" extensions="JCFS.GenericObjectController">
        <JCFS:JiraIssuesComponent son="{!son}" soid="{!soid}"></JCFS:JiraIssuesComponent>
    </apex:page>
    Code Block
    jiraissuesVF
    language
    xml
    title
    JIRA Issues Visualforce Page
    Tab
    titleServer

    Server

    Code Block
    languagexml
    titleJIRA Issues Visualforce Page
    <apex:page standardController="ObjectName" extensions="JSFS.GenericObjectController">
        <JSFS:JiraIssuesComponent son="{!son}" soid="{!soid}"></JSFS:JiraIssuesComponent>
    </apex:page>

  5. Remember to replace ObjectName accordingly.
    Image Removed
    Image Added 

  6. Click Save.

Creating a Jira Comments Visualforce Page

If you wish to display Jira comments for your object, you can repeat the steps in "Creating Jira Issues Visualforce Page" section above with the following details:

...

Name: "ObjectNameJiraCommentsPage"

Visualforce Markup:

...


Cloud

deckIdtabCloudxmlxml
Code Block
jiracommentsVF
language
xml
title
JIRA Comments Visualforce Page for Custom Objects
Tab
titleServer
<apex:page standardController="ObjectName" extensions="JCFS.GenericObjectController">
    <JCFS:JiraCommentsComponent son="{!son}" soid="{!soid}"></JCFS:JiraCommentsComponent>
</apex:page>

Server

Code Block
languagexml
titleJIRA Comments Visualforce Page for Custom Objects
<apex:page standardController="ObjectName" extensions="JSFS.GenericObjectController">
    <JSFS:JiraCommentsComponent son="{!son}" soid="{!soid}"></JSFS:JiraCommentsComponent>
</apex:page>

Step 2: Adding a Visualforce page to Object Layout

  1. Log in to your Salesforce instance and click Setup.
  2. Now let's customize your object Page Layout.
    Under the sidebar, go to Build > Customize > (object name) > Page Layout.
  3. Choose the layout you want to edit in the list, then click Edit
    Here's an example for Case:
    Image RemovedImage Added
  4. Under the Layout panel, scroll until you find Visualforce Pages.
    Image RemovedImage Added

    If you don't see the Visualforce page you're looking for, review the steps in "Step 1: Creating a Visualforce Page".
  5. Now click and drag Section to a preferred section in the layout. Give this section a name, in this case, we've named it 'Jira Section' and configured it as a two-column layout.
    Now click and drag Jira Issues and Jira Comments onto the newly-created 'Jira Section' and place them side them side by side.  You You may also want to adjust the properties so that you get a panel with a size you'll be more comfortable working in (a minimum height of 500px is recommended).
    Image RemovedImage Added
    Image RemovedImage Added
  6. Then, click Save.

Now when you load an object's page, you are able to see Jira issues associated issues associated with the object, along with their comments.
Image RemovedImage Added
You will also find that upon creating a new Jira issue or associating to an existing one, the Jira Comments page will refresh automatically.

What's next?