Issue filing in Accessibility Insights for Android

Accessibility Insights for Android makes it easy to file issues directly from automated checks failure instances.

How to file issues

Run automated checks

For detailed instructions, see FastPass in Accessibility Insights for Android.

Configure your issue filing service

To configure GitHub issue filing

1. Open the Settings panel:

   • Select Settings (gear icon) in the command bar.

   or

   • Select your keyboard's Tab key to set focus on the Settings button, then select the Enter key.

2. Configure your service:

   1. In the Settings panel, under Issue filing, select GitHub.
   2. Enter the URL of your GitHub repository's Issues tab. Example: https://github.com/owner/repo/issues

   or

   1. Select Tab to set focus on the currently selected Issue filing option. If needed, use the Up arrow or Down arrow key to select GitHub.
   2. Select Tab again to set focus on the Enter desired GitHub issues link box, then enter the URL.

3. Close the Settings panel:

   • Select Close Settings Panel (X icon).

   or

   • Select Tab to set focus on the Close Settings Panel button, then select Enter.

   

To configure Azure Boards issue filing

1. Open the Settings panel:

   • Select Settings (gear icon) in the command bar.

   or

   • Select your keyboard's Tab key to set focus on the Settings button, then select the Enter key.

2. Configure your service:

   1. In the Settings panel, under Issue filing, select Azure Boards.

   2. Enter the URL of your Azure Boards project. Example: https://dev.azure.com/org/project

   3. Select the field where you want issue details to appear:

      1. If your project tracks bugs, select Repro steps.
      2. If your project tracks issues, select Description.

   4. Close the Settings panel.

   or

   1. Use the Tab key to set focus on the currently selected Issue filing option. If needed, use the Up arrow or Down arrow key to select Azure Boards.

   2. Tab to the Enter your Azure Boards project link box, then enter the URL. Example: https://dev.azure.com/org/project

   3. Tab to the Select a field for issue details dropdown, use the Up arrow or Down arrow key to select an option, and then press the Enter key:

      1. If your project tracks bugs, select Repro steps.
      2. If your project tracks issues, select Description.

   4. Tab to the Close Settings Panel button, then press the Enter key.

   

File an issue

1. Find the failure instance you want to file as an issue:

   1. Select a rule to expand it.
   2. Examine the failure instances that appear as cards below the rule.

   or

   1. Select your keyboard's Tab key to set focus on a rule, then select the Enter key.
   2. Select Tab to navigate through the failure instances for the rule.

2. Open a new issue form:

   1. In the bottom right corner of a failure instance card, select More actions (vertical ellipsis icon).
   2. In the menu that opens, select File issue.

   or

   1. Select Tab to set focus on a failure instance's More actions button, then select Enter to open the menu.
   2. Use Enter again to select File issue.

   

   If you're using GitHub, a New Issue form will open:

   

   If you're using Azure Boards, and your project tracks bugs, a New Bug form will open:

   

   If you're using Azure Boards, and your project tracks issues, a New Issue form will open:

   

   If you're using Azure Boards, a Sever Error page will open if there's a problem with your issue filing configuration:

   

   To resolve this problem:

   1. In Accessibility Insights, go to Settings > Issue filing > Select a field for issue details, and choose a different option.
   2. If the problem persists, make sure the bug or issue work item type is enabled in Azure DevOps.

3. The New Bug or New Issue form will open with failure details automatically populated. If desired, edit the information in the form.

4. Save the new issue:

   • If you're using GitHub:

     • Select the Submit new issue button.

     or

     • Select Tab to set focus on the Submit new issue button, then select Enter.

   • If you're using Azure Boards:

     • Select the Save button.

     or

     • Select Ctrl+S on your keyboard.

     or

     • Select Tab to set focus on the Save button, then select Enter.

Copy failure details

If you want to record an issue without filing it on GitHub or Azure Boards, you can copy the failure details to your clipboard and then paste them into the tool or document of your choice.

1. In the bottom right corner of a failure instance card, select More actions (vertical ellipsis icon).
2. In the menu that opens, select Copy failure details.

or

1. Select your keyboard's Tab key to set focus on a failure instance's More actions button, then select the Enter key to open the menu.
2. Select the Up arrow or Down arrow key to choose Copy failure details.
3. Select Enter to copy the failure details to your clipboard.