This webservice can be called from within Apex Class. This example will guide you on how to call "create" API.
Before you write Apex code that calls remote URL, you have to allow salesforce to make a call to external server.
Log in to Salesforce.com.
Go to Your Name > Setup > Administration Setup > Security Controls > Remote Site Settings.
Add new remote site.
Enter the name of remote site.
Enter your JIRA URL in Remote Site URL, e.g., http://yourjiraurl.com/
Click Save.
Once you are done, you can start writing the code. Here are the steps to write Salesforce Apex Class.
Log in to Salesforce.com.
Go to Setup > App Setup > Develop > Apex Classes > New
Paste this code into the field:
global class JIRAConnectorWebserviceCalloutCreate {
@future (callout=true)
WebService static void createIssue( String jiraURL, String systemId, String objectType, String objectId, String projectKey, String issueType) {
//Set your username and password here
String username = 'yourJIRAusername';
String password = 'yourJIRApassword';
//Construct HTTP request and response
HttpRequest req = new HttpRequest();
HttpResponse res = new HttpResponse();
Http http = new Http();
//Construct Authorization and Content header
Blob headerValue = Blob.valueOf(username+':'+password);
String authorizationHeader = 'Basic ' + EncodingUtil.base64Encode(headerValue);
req.setHeader('Authorization', authorizationHeader);
req.setHeader('Content-Type','application/json');
//Construct Endpoint
String endpoint = jiraURL+'/rest/customware/connector/1.0/'+systemId+'/'+objectType+'/'+objectId+'/issue/create.json';
//Set Method and Endpoint and Body
req.setMethod('POST');
req.setEndpoint(endpoint);
req.setBody('{"project":"'+projectKey+'", "issueType":"'+issueType+'"}');
try {
//Send endpoint to JIRA
res = http.send(req);
} catch(System.CalloutException e) {
System.debug(res.toString());
}
}
}
Copying the above code and pasting it directly into the field may result in additional, unwanted characters being included. To avoid this from happening, we recommend pasting the code into a text editor that accepts plain text (e.g. Notepad.exe) and then recopying it again before pasting it into the field.
Change the variables accordingly:
Variables
Details
username
Your JIRA username
password
Your JIRA password
Click Save.
WARNING
Please use this class with care. It can cause an infinite loop of Issue and Case creation if it conflicts with the JIRA Push to Remote System workflow.
The Usage of Written Class
Now that the class is ready to be used and it can be called in various ways including:
Salesforce Trigger can be used to automate the creation of JIRA issue. It is event-based process similar to JIRA workflow, yet more flexible.
In this example, we want to automate JIRA issue creation when Case is created:
VERY IMPORTANT NOTE:
You will NEED to create a custom profile called "JIRA Agent" in Salesforce.com to avoid causing an infinite loop. Then assign a user to that profile and block it to execute the trigger.
This way, any cases created from JIRA will not trigger creation of more issues back to JIRA.
First, create custom profile called 'JIRA Agent':
Log in to Salesforce.com.
Go to Setup > Administration Setup > Manage Users > Profiles > New Profile.
Choose 'Existing Profile' to be: Custom: Support Profile.
Fill in 'Profile Name' with : JIRA Agent.
Click Save.
"CUSTOM: SUPPORT PROFILE" NOT AVAILABLE?
Your version of Salesforce may not have the Custom: Support Profile option.
If so, you can create a new profile or clone from any existing profile. But please make sure that the profile has Read, Edit and Create permissions for the relevant object.
Second, assign the created profile to specific user that will be used in JIRA Connector:
Go to Setup > Administration Setup > Manage Users > Users.
Create/Edit the user that is used as JIRA agent.
Use the created profile as profile of the user.
Click Save.
WARNING
Make sure that this user is used in Application Links authentication in JIRA.
Third, add Trigger code to Case Trigger.
Write Apex Class as described above
Go to Setup > Application Setup > Customize > Cases > Triggers.
Create New Trigger and replace the code with:
trigger CreateIssue on Case (after insert) {
//Identify profile name to be blocked from executing this trigger
String JIRAAgentProfileName = 'JIRA Agent';
List<Profile> p = [SELECT Id FROM Profile WHERE Name=:JIRAAgentProfileName];
//Check if specified Profile Name exist or not
if(!p.isEmpty())
{
//Check if current user's profile is catergorized in the blocked profile
if(UserInfo.getProfileId()!= String.valueOf(p[0].id))
{
for (Case c : Trigger.new) {
//Define parameters to be used in calling Apex Class
String jiraURL = 'http://jira.example.com';
String systemId = '4'; //Please change this accordingly to the configuration in JIRA
String objectType ='Case'; //Please change this accordingly to the configuration in JIRA
String objectId = c.id;
String projectKey = 'SFDC'; //Please change this accordingly to the configuration in JIRA
String issueType = '1'; //Please change this accordingly to the configuration in JIRA
//Execute the trigger
JIRAConnectorWebserviceCalloutCreate.createIssue(jiraURL, systemId ,objectType,objectId,projectKey,issueType);
}
}
}
}
Copying the above code and pasting it directly into the field may result in additional, unwanted characters being included. To avoid this from happening, we recommend pasting the code into a text editor that accepts plain text (e.g. Notepad.exe) and then recopying it again before pasting it into the field.
Change the variables accordingly:
Variables
Details
jiraURL
Your JIRA URL
systemId
Your system Id in Connection. You should check this in JIRA under Connection
objectType
Salesforce object that is used in Connection. In our example, it is Case
objectId
The id of the object. It varies in every operation. Therefore, it should be object.id
projectKey
Under which JIRA Project you want to create the issue.
issueType
standard JIRA issue type values range from '1' to '4' . '1' is for Bug and so on
Click Save
Now you are ready to use the trigger. Try out: Create Case in Salesforce as normal user and check if JIRA Issue is created.
Button
Other than trigger, you can use the written Apex class for button. Using this method, you can eliminate some processes, including:
The required Login page
The prompt page of choosing Project and Issue type.
