Jira / Jira Studio Ticket Integration

Summary

We now offer direct integration with Atlassian's Jira or Jira Studio.  See, http://www.atlassian.com/.  This integration is only available for Business and above plans.  This article explains how to configure CloudForge with Jira.

Configure CloudForge

  1. CloudForge - Create a project that has both version control and Jira services
  2. Projects -> Project -> Integrations  -> Jira

Fill out the settings form:

Screen_Shot_2012-11-19_at_5.53.40_PM.png
Notes: 
  1. Enter the host name of the external service like:  youraccount.onjira.com, just the host, no http ...
  2. For Remote Project Name - enter the Project Key from Jira, which is an unique identifier in uppercase.  Make sure its in uppercase, for example, PROJECT
  3. On JIRA - Make sure that API access is turned on in Jira
    1. Administration -> General Configuration -> Global Settings -> Edit Configuration -> Accept Remote API calls -> ON
  4. On JIRA - Make sure your Jira user has access to the Project and has the permission to comment on issues

Jira Specific Ticket Integration Syntax

You can now update Jira issues with the CloudForge Ticket Update syntax, but please read this specific to Jira:

  • Each Jira issue will contain a unique key, something like PROJECT-1.  For the ID of the issue, you just need to use the number part of the unique key
  • test close[t:1] - this will set the  issue PROJECT-1 to resolved status alone with the commit message
  • If you have more than one external integrations within the same project, you will need to specify Jira as the external integration provider that you want to work with, to do so, use the syntax:  close[s:jira, t:1]
  • Notice that there is no space between close and [] if you want to set the status in Jira to resolved

Jira / Jira Studio

Atlassian's Jira product has an on-premise version (Jira), and a hosted version (Jira Studio).  Our integration can work with either product.

Jira Studio

  • Jira Studio is hosted, therefore, the API access is internet accessible.  All you need to do is enter the correct URL / Host Name in CloudForge

Jira, On-Premise, Behind the Firewall

  • If you have Jira installed in your local network, behind the firewall, you will need to expose Jira API to the internet so that CloudForge can access your local instance of Jira.  This requires opening up your firewall to allow this
  • To test and make sure your firewall is opened to your local Jira instance, type in URL that looks like the following from a browser outside the firewall, and see if you get an XML message back:  https://yourjira.company.com/rpc/soap/jirasoapservice-v2?wsdl, you may need to view the source page of your browser page to see the XML
  • For security, you may want to whitelist CloudForge IP address, as part of your firewall configuration, for access to your local Jira instance

Release Notes

  • Due to limitation of current Jira API, we cannot do per user integration at the moment.

 

Have more questions? Submit a request

0 Comments

Article is closed for comments.