Integrate Jira with Your Projects (Enterprise Only)
The Jira integration in A11yNow allows your team to seamlessly manage accessibility issues within Jira while maintaining synchronization with accessibility findings in A11yNow. By mapping projects, issue types, severities, statuses, and fields, you can streamline issue tracking, improve collaboration, and ensure accessibility defects are managed within your existing development workflow.
Pre-Requisites
- Before configuring a project-level integration, ensure that Jira has already been connected to A11yNow through the organization settings.
Connect Jira to a Project
To connect GitHub on A11yInspect with your project:
- Sign in to BarrierBreak A11yNow.
- Select Projects module.
- Open the project you want to configure.
- Select the Integrations tab.
- Select Connect option under Jira. You will now redirect to configure the required integration settings.
Configure Jira Integration Setting
After connecting the Jira, configure the required integration settings by proceeding with following steps:
Step 1: Select Project and Issue Type
- Choose a Jira Project from the available list.
- Select the Issue Type that A11yNow should use when creating Jira issues.
Step 2: Configure Sync Options
Choose any option to sync BarrierBreak A11yNow with GitHub. Refer the following table to understand the options:
- Auto Sync: Automatically synchronizes updates between A11yNow and Jira.
- Auto-Create Issues: Automatically creates Jira issues for new accessibility findings detected in A11yNow. If Auto-Create Issues is enabled, select which findings should generate Jira issues as All Issues, Fails, or Fails & Suggestions.
Step 3: Configure Parent Linking
Choose any option to configure the parent linking as follows:
- No Parent: The issues will be created in Jira without parent issues.
- Choose During Sync: It will allow you to select the parent issue while manually syncing to Jira.
- Default Parent: Select a parent issue from dropdown field. All the issues will sync under that selected parent issue.
Step 4: Map Severity Levels
Configure following A11yNow severity levels correspond to Jira priorities as Highest, High, Medium, Low, Lowest.
- Blocker nb
- Critical
- Major
- Minor
- Best Practice
Step 5: Configure Status Mapping
Map A11yInspect issue status with the corresponding GitHub issue statuses as follows:
| A11yNow Issue Status | Jira Issue Status |
|---|---|
| To Do | Open |
| In Progress | Open |
| Done | Close |
Step 6: Field Mapping
Map accessibility finding details to Jira issue fields to ensure all relevant information is synced correctly during issue creation. Field mappings can be customized based on your repository requirements. Refer to the table below to fields values (Summary, Description, Issue Color, Labels)
| A11yNow Fields | Jira Fields (Default) |
|---|---|
| Issue | Summary |
| Type | Labels |
| Severity | Labels |
| Success Criteria | Description |
| Conformance Level | Description |
| Element | Description |
| Attribute | Description |
| Actual Result | Description |
| Expected Result | Description |
| Recommendation | Description |
| Step To Validate | Description |
| Existing Code | Description |
Step 7: Save the Configurations
- Review all the configured settings
- Select Submit to save the configuration
All the configured integration details will be displayed on the project integration dashboard. You can edit configurations anytime.
Edit the Existing Jira Integration Settings
Based on your requirements, you can edit existing configurations anytime.
To edit the integration settings:
- Sign in to BarrierBreak A11yNow.
- Go to Projects.
- Open the project you want to edit.
- Go to Integration tab.
- Select View Integration option under Jira.
- Select on Edit in the upper- right corner.
- Update the required configuration options.
- Select on Submit to save changes.
Disconnect GitHub Integrations
To disconnect GitHub integration:
- Sign in to BarrierBreak A11yNow.
- Go to Projects module.
- Open the project you want to edit.
- Go to Integration tab.
- Select View Integration option under GitHub.
- Select Unlink Jira.
Now your Jira is unlinked with BarrierBreak A11yNow.
note
- You must connect Jira in Settings before it can be linked to individual projects.