October 18, 2013

Adding Jira Users To Your Swarm


Swarm is designed to help software teams ship quality software faster and every day we add new, useful functionality. We recently got many requests to further enhance our Jira integration and so we added a couple of enhancements which make life a whole lot better for those using both Jira and Swarm. Jira users can now see both the review and commit work developers are doing without ever needing to leave Jira. This made a lot of our own project managers very happy because they could quickly tell the state of an issue without needing to go bug developers about and we think it will make a lot of you very happy too.

Introducing Swarm Links in Jira

Swarm will automatically create or update any associated Jira issues with links back to Swarm whenever a Perforce change is committed, a code review is created, or a code review is updated. Swarm associates the Jira ticket either via Perforce jobs or via callouts to the Jira issue number in the Swarm change or code review descriptions. Setting Job names to be Jira numbers or using the Perforce Defect Tracking Gateway to replicate Jira and Perforce Jobs can further enhance the experience but these are not required to have the links appear in Swarm.

Enhanced Linking from Swarm to Jira

The Jira project list is now fetched automatically; whereas prior to 2013.2 admins needed to hard-code the list of Jira project IDs, these are now dynamically configured via settings in the config.php. This enhances the feature that allows Swarm to automatically link out to any Issues linked through changes or reviews.

To enable the Jira module, add the following configuration block to your data/config.php file:

    // this block should be a peer of 'p4''jira'=>array( 'host'=>'', // URL for your installed Jira web interface'user'  =>'', // the username required for Jira API access
        'password'  => '',// the password required for Jira API access
        'job_field'=>'', // optional, if P4DTG is replicating Jira issue IDs
                           // to a job field, list that field here
        'timeout'=>5,// optional, timeout for Jira API requests, in seconds.
                           // Default is 5 seconds,

Get the Latest Swarm

Grab the latest version of Swarm (2013.2) from our downloads page and start taking advantage of Jira and Swarm today!

Be sure to tell us what you think about Swarm in our Swarm forum.