Versions Compared

Key

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

The Salesforce Package provides a set of Visualforce pages to show associated Jira issues and some operation buttons to create or associate. It also provides a page to view Jira comments related to the associated Jira issues. 

This page guides you on how to configure Visualforce pages for both standard objects and custom objects in Salesforce.

Info

Using the Lightning view? Check out Configuring Lightning Experience components.

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

On this page:

Table of Contents
minLevel1
maxLevel3
outlinefalse
styledisc
typelist
printabletrue

Create 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

to Add a Visualforce page to an Object Layout. For other standard objects and custom objects, follow the steps in this section.

Create a Jira Issues Visualforce page

  1. Go to Setup and type "Visualforce Page" in the quick find Quick Find box.

    Image RemovedImage Added
  2. Click New.

  3. Provide a name and a label for the Visualforce page. 
    We recommend recommend using 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__c

  4. Paste the following into the Visualforce Markup editor:
    Cloud

    JIRA Issues Visualforce Page

    Code Block
    languagexml
    <apex:page standardController="ObjectName" extensions="JCFS.GenericObjectController">
        <JCFS:JiraIssuesComponent son="{!son}" soid="{!soid}"></JCFS:JiraIssuesComponent>
    </apex:page>

    Server

    JIRA Issues Visualforce Page

    Code Block
    languagexml
    <apex:page standardController="ObjectName" extensions="JSFS.GenericObjectController">
        <JSFS:JiraIssuesComponent son="{!son}" soid="{!soid}"></JSFS:JiraIssuesComponent>
    </apex:page>
  5. Remember to replace ObjectName  ObjectName accordingly.
     

  6. Click Save.

Create a Jira Comments Visualforce Page

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

"

Jira Comments

"


Name: 

"ObjectNameJiraCommentsPage"

ObjectNameJiraCommentsPage
Visualforce Markup:

Cloud

JIRA Comments Visualforce Page for Custom Objects

Code Block
languagexml
<apex:page standardController="ObjectName" extensions="JCFS.GenericObjectController">
    <JCFS:JiraCommentsComponent son="{!son}" soid="{!soid}"></JCFS:JiraCommentsComponent>
</apex:page>

Server

JIRA Comments Visualforce Page for Custom Objects

Code Block
languagexml
<apex:page standardController="ObjectName" extensions="JSFS.GenericObjectController">
    <JSFS:JiraCommentsComponent son="{!son}" soid="{!soid}"></JSFS:JiraCommentsComponent>
</apex:page>

Add a Visualforce page to an Object Layout

  1. Log in to your Salesforce instance and click Setup.

  2. Now let's To customize your object Page Layout.
    Under , under the sidebar, go navigate 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 Removed

    Example of Case Page Layout

    Image 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 Create a Visualforce Page.

  5. Now click and drag Click and drag Section to a preferred section in the layout. Give this section a name, in . In this case, we've named it 'Jira Section' and configured it as a two-column layout.Now click

  6. Click and drag Jira Issues and Jira Comments onto the newly-created 'Jira Section' and place them side by side. You may can also want to adjust the properties so that you get a the panel with a size you'll be more comfortable working in size is more usable (a minimum height of 500px is recommended).

  7. Click Save.

Now, when you load an object's page, you are able to can see the Jira issues associated with the objectit, along with their comments.

Upon creating a new Jira issue or associating to it with an existing one, the Jira Comments page will refresh automatically.

Next steps