Shipped: JIRA Integration

Picture of Lita Stephenson
Lita Stephenson, Tuesday March 8, 2016

Project managers rejoice — we developed a JIRA integration for the Rainforest platform! This integration lets Rainforest users automatically create issues in JIRA when a test fails in Rainforest.

Why We Developed a JIRA Integration

Some of our customers use JIRA to track bugs and issues. Previously, they had to manually check for test failures in Rainforest, and then create issues in JIRA. This manual process takes time, and detracts from the continuous nature of the testing workflow. To ensure that Rainforest integrates seamlessly into workflows at both small and large organizations, we decided to make it fast and easy to automatically port Rainforest test results right into your JIRA dashboard.

How Does the JIRA Integration Work?

The JIRA integration is configured within Rainforest under the 'Integrations' Tab. To set it up, just select JIRA from the "Add an integration..." dropdown, and fill out the configuration settings to hook into your JIRA account. Once configured, you can make changes to the details by clicking to expand JIRA under the action.

When a test fails according to the actions that you have selected, an issue is automatically created in JIRA. The default for how Atlassian references issues is always "project key - number". Something like this: BORK-4, BORK-5 ... Additionally, recall that the Project Key is a shorthand that you set within JIRA when you create a project. When an issue is created, it's automatically tagged with type: "Bug", Priority: "High", and a label: "RfTest[test number]".

If the test fails multiple times while it is still open, we will automatically add a second tag: "RepeatedFailure" and increase the priority. Once it's closed, any new failures for that test will create a new issue. As with any issue in JIRA, you can then drag these into sprints, and go forward with your existing processes.

What’s Next

We’re working on more integrations to ensure that Rainforest fits into your development workflow. Don’t see the favorite tools? Get a demo to learn more about how our full-featured API hooks into just about anything that you use.