Jira is the most popular issue tracking system in the world, and Qase has built-in integration with it without any plugins or add-ons. With Jira integration, you can create a new task with defect description directly from a test run in Qase.
Step 1. Prepare
Each project in Qase has it's own integration settings, and you should have access rights to add/update integrations. You should open your project's settings, choose "Integrations" from the menu in the sidebar, and click on the "Install" button in Jira's card.
Step 2. Connection
To connect Qase to your Jira Cloud, you should complete the form with credentials. We don't use Jira password for authentication, only API token. You can learn how to get it from the official article.
Jira Standalone doesn't have API tokens, so to connect Qase to your Jira installation, you need to provide your Jira username and password (API token field) in the form.
Step 3. Integration settings
If everything is right and we have successfully checked Jira connection, you will be redirected to the page with integration settings, where you should choose the Jira project and issue type you want to use for new issues created from Qase.
Step 4. Defect creation
After you have Jira integration installed and configured, you will be able to send issues from test runs. If you click on the failed button, you will see a modal window with a defect creation form. There will be a checkbox "Send defect to Jira". If you keep it checked, Qase will create a task in the selected project with proper issue type in your Jira.
Here is a list of most common problems you can face during integration setup or defect creation:
- Jira installation is unreachable. This problem can appear if your Jira is inside a private network and can't be accessed from the internet. To solve this problem, read the article: What are the Qase IP addresses I should use to configure my corporate firewall?
- Unsupported custom fields. As mentioned above, Qase doesn't fully support all custom fields available in Jira. That's why Qase receives an error when tries to create an issue through API. Jira doesn't allow us to do that if required custom fields are not provided. If your integration was successfully installed, but new issues are not created, this problem can be the main reason. In that case, please contact support.
- User doesn't have access to the project. If the user loses access to the selected project, Qase won't be able to create new issues. To solve this problem, restore access to the project or create integration with a new API token from a user who has such access.
If you have any problems with Jira integration, don't hesitate to contact us: firstname.lastname@example.org. We will help you to find a problem and solve it.