Jira Integration
By integrating Jira with Fable, Jira issues can be created directly within Compatibility Test results. The details of the accessibility issues will be in the description of the Jira ticket, along with a link back to shared Compatibility Test results page.
How it works
Once the integration is set up, users will have the option to create Jira tickets from the Compatibility Test results. When viewing the documented issues at the bottom of the results page, there will be an action labeled “Create Jira ticket” for each issue. Once selected, you will prompted to select the appropriate Jira project, and then the ticket will be created for you.
![Jira_Ticket_1 Screenshot of compatibility test results organized by tester. Issue documented by Douglas is displayed with feedback and issue details, and the option to create a jira ticket.](https://makeitfable.com/wp-content/uploads/2024/01/Jira_Ticket_1.png)
Once the ticket is created, it will be associated to that specific Compatibility Test issue with a link to the Jira ticket. If a ticket was created in error or is no longer needed, the ticket can be unlinked by selecting “Remove link”. Note: if you want to delete the Jira ticket completely you must do so directly within Jira. Any linked Jira tickets will also be included in the Word and Excel reports for that Compatibility Test.
![Jira_Ticket_2 Screenshot of compatibility test results organized by tester. Issue documented by Douglas is displayed with feedback and issue details, and a Jira ticket hyperlinked with an action to remove the Jira link.](https://makeitfable.com/wp-content/uploads/2024/01/Jira_Ticket_2.png)
The Jira ticket will include the following details:
- Summary of assistive technology and configuration used
- Issue summary and feedback provided by the tester
- Link to Compatibility Test shared page
- Step the issue occurred on
- Any environment or special instructions included in the test
- Related WCAG criteria
- Any required fields for the selected issue type (inputted when creating the ticket in Fable)
![Jira_Ticket_3 Screenshot of a Jira ticket describing an issue documeted by a Fable tester](https://makeitfable.com/wp-content/uploads/2024/01/Jira_Ticket_3.png)
Setup instructions
Step 1 – Confirm requirements
- Your organization is using Jira cloud.
- You are a Fable Administrator.
- You have read & write access to the Jira projects you want to create tickets for.
If you do not have read & write access for the Jira projects you want to use, please contact your Jira Administrator.
Step 2 – Integrate Jira
Once you have confirmed you meet the requirements you can begin setting up the integration. You can repeat steps 2 and 3 to integrate with multiple Jira sites.
- Log in to Fable as the Company Admin.
- Select your username on the top right of the page.
- Select “Preferences” from the drop down.
- Select the “Integrations” menu option.
- Locate the Jira integration section and select “Add Integration”. You will be redirected to Jira/Atlassian.
![Jira_Setup_1 Screenshot of the integrations preferences page with an action to add a Jira integration.](https://makeitfable.com/wp-content/uploads/2024/01/Jira_Setup_1.png)
- Log in to your Jira account, if you’re not already logged in.
- Review the terms for using the Fable integration, and select the Jira site you want to integrate to.
- Select Accept. You will be redirected back to Fable.
![Jira_Setup_2 Screenshot of a user authorizing the use of the Fable Engage Jira integration, listing permissions to agree to, and the options to Accept or Cancel.](https://makeitfable.com/wp-content/uploads/2024/01/Jira_Setup_2.png)
- Select the same Jira site you selected in Step 7 to confirm the integration. Note: if you only have one Jira site this step will be skipped.
You have now successfully integrated your Jira site to Fable.
![Screenshot 2024-04-25 at 1.23.06 PM Screenshot of the confirm integration page with radio options to select from a list of Jira instances to integration with Fable.](https://makeitfable.com/wp-content/uploads/2024/01/Screenshot-2024-04-25-at-1.23.06-PM.png)
Step 3 – Select Jira projects
Once Step 2 is complete, the page will be updated to reflect a successful integration. You must now select the Jira projects users can create tickets for within that site.
- Select “Edit Projects” for the Jira site.
- You will see the list of available Jira projects within the Jira site you set up in Step 2. Select all the projects you want to allow tickets to be created in. Note: you must select at least one project. If you do not select at least one project, Jira tickets cannot be created.
- Select “Save”.
Fable users will now be able to create ticket within the selected Jira projects. Repeat steps 2 and 3 to integrate with multiple Jira sites.
![Jira_Setup_4 Screenshot of the Jira integrations preference page, with a multi selection to select which Jira projects to use for the integration.](https://makeitfable.com/wp-content/uploads/2024/01/Jira_Setup_4.png)
Troubleshooting and support
If you are unable to set up the integration, please reach out to support@makeitfable.com with the error message you are receiving and the step you are on.
If you are able to set up the integration but unable to create tickets, please delete the integrations and try again. During step 2, please ensure you select the same Jira site on tasks 7 and 9.
If you still encounter issues, please reach out to support@makeitfable.com and provide us with the following information
- Jira project name.
- Ticket type ID for the type of issue you are trying to use.
- Field configuration for the issue type you are trying to use, including which fields are required.