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.
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.
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
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.
- 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.
- 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 instance you want to integrate to. Note: you can only integrate to one Jira instance at this time.
- Select Accept. You will be redirected back to Fable.
You have now successfully integrated your Jira instance to Fable.
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.
- Select “Edit Projects”.
- You will see the list of available Jira projects within the Jira instance 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.
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 reach out to support@makeitfable.com and provide us with the following information
- Jira project name.
- Bug ticket type ID for the Jira project, or the ticket type ID you wish to use.
- Confirm that both the description and label fields are present in the Jira project.