View Source

Since QuickBuild 3, a two-way solution is provided to integrate with Atlassian JIRA. The integration features:
* Hyperlink the JIRA keys in commit messages to corresponding JIRA pages
* Generate an issues report from commit messages
* Progress/update the issues from commit messages
* Release a version of a project in JIRA and update the fixed versions field of issues with status fixed or closed
* Create an issue to JIRA based on a customized step condition
* View SCM changes for each issue
* View related builds for each issue
* View related builds for each project

This page will describe how to integrate QuickBuild in JIRA.

{info}
Supported JIRA version: 4.0 or higher.
{info}

*On This Page*

{toc:class=pagetoc|style=disc|indent=20px|maxLevel=3}

h3. Install QuickBuild Plugin For JIRA

# Download QuickBuild Plugin for JIRA from administration page like below:
!download-jira-plugin.png!
# Shutdow JIRA server.
# Copy the plugin jar into plugins directory: \{JIRA_HOME\}/plugins/installed-plugins/
# Start JIRA server.

You may reference http://confluence.atlassian.com/display/JIRA/Managing+JIRA's+Plugins for details about managing JIRA plugin.

h3. Configure QuickBuild Server
If the plugin has been installed successfully, you can configure the QuickBuild server from Administration page:

!quickbuild-server-admin.png!

To add a QuickBuild Server, you need define the associations between JIRA project and QuickBuild configuration(s). One JIRA project can be associated with multiple QuickBuild configurations.

!add-quickbuild-server.png!

h3. Issue Changes and Issue Builds
{note}
Issue changes and builds are only available when JIRA for QuickBuild plugin is configured. Reference [Integrating QuickBuild with JIRA] for details.
{note}

After successfully configured QuickBuild server, you can now view the related changes for an issue:

!issue-changes.png!

Click the 'View' link to view the source code, and 'Diff Prev' to diff the source code with previous edition.

and also the related builds:

!issue-builds.png!


h3. Project Builds
You can also view the builds history from your JIRA project tab.

!project-builds.png!