Importação de Problemas Automatizados, IGT e Manuais

Os usuários do Axe Auditor podem importar problemas manualmente (exportados como um arquivo JSON usando a extensão axe DevTools Pro) e por meio de integração automatizada no nível da unidade de teste, permitindo a importação de problemas automatizados, IGT e manuais em uma única operação.

Nota 1 - Importação automática da captura de tela com o problema manual: Ao importar um problema manual, a captura de tela associada é importada automaticamente usando a tag ScreenshotURL no arquivo JSON.

Nota 2 - Comparando apenas versões principais durante a importação: O Axe Auditor permite importar problemas gerados pela extensão axe DevTools Pro desde que estejam usando a mesma versão principal do axe-core. Isso significa que o axe Auditor só impedirá a importação de um arquivo gerado pela extensão se o número da versão principal (o primeiro dígito no número da versão) for diferente entre a Execução de Teste e a extensão. Em caso de as versões secundárias serem diferentes, o axe Auditor fornecerá apenas um aviso ao usuário, indicando que a versão do axe-core sendo importada não coincide com a versão do axe Auditor e que pode haver algumas variações nos dados do teste. Essas variações geralmente se referem a possíveis diferenças nos pontos de verificação Deque associados aos problemas no axe Auditor.

Nota 3 - Importação de Problemas do axe DevTools Mobile para Android Nativo e iOS Nativo - Ao importar problemas do axe DevTools Mobile para tipos de ativos digitais baseados em dispositivos móveis nativos, o axe Auditor não importa problemas Experimentais e Necessitam Revisão. Além disso, o axe Auditor ignora problemas com o conjunto de regras AAA, pois não suporta regras AAA.

Nota 4 - Usando a opção de teste e problemas salvos: Use a opção 'Teste e problemas salvos' ao exportar problemas da Extensão axe DevTools.

Nota 5 - Importação de Arquivos JSON com Zero Problemas: Ao importar arquivos JSON usando o DevTools Pro sem problemas, o axe Auditor mostra os pontos de verificação que foram testados como parte dos IGTs que não têm problemas relatados. Isso permite obter uma lista mais completa de pontos de verificação que foram testados como parte dos testes com axe DevTools Pro e axe Auditor, permitindo focar apenas nos pontos de verificação que ainda precisam ser testados.

Nota 6 - Múltiplas Execuções de IGT nas Importações do axe DevTools: Se você estiver usando o recurso de múltiplas execuções na extensão axe DevTools (recurso Pro) e usando a exportação para ser importada na Execução de Teste do axe Auditor, ela pode ser importada no axe Auditor com os problemas importados sendo o total de todos os problemas ao longo de múltiplas execuções (após remover manualmente os duplicados).

Usando o Botão de Importar Problemas

Os três diferentes tipos de problemas que uma unidade de teste pode incluir são:

• Problemas Automatizados - de dentro do Auditor ou de um arquivo JSON carregado pelo usuário.
• Problemas IGT - Todos os problemas que a extensão axe DevTools Pro pode encontrar ao executar testes IGT a partir de um arquivo JSON carregado pelo usuário são marcados como problemas IGT.
• Problemas Manuais - de dentro do Auditor ou de um arquivo JSON carregado pelo usuário.

Na página de Visão Geral da Unidade de Teste, use a seção chamada Status do Teste para importar problemas automatizados, IGT e manuais. Esta seção contém:

• A data e hora em que a importação dos problemas foi iniciada,
• O status do teste indicando o status da importação e a data e hora em que foi concluída, e
• Um botão de Importar Problemas que permite ao usuário carregar um arquivo JSON em um formato pré-definido fornecido pela Deque Systems.

Clicar no botão Importar Problemas abre a caixa de diálogo de confirmação de Importação de Problemas, onde você pode importar todos os três tipos de problemas usando um arquivo JSON. Para gerar o arquivo JSON, use a opção JSON na extensão axe DevTools (Exportar → Teste e Problemas Salvos → opção JSON).

Ao importar um problema, a captura de tela associada é importada automaticamente usando a tag ScreenshotURL no arquivo JSON. Se a tag ScreenshotURL estiver vazia, nenhuma captura de tela é adicionada ao problema.

Nota 1: Ao importar problemas novamente, você pode optar por manter os problemas existentes ou substituí-los pelos problemas no arquivo, se a unidade de teste já contiver esses problemas. O Axe Auditor apenas exclui e substitui problemas manuais importados usando um arquivo JSON. Problemas manuais adicionados manualmente pelo usuário permanecem intactos e não são excluídos ou reimportados.

Nota 2: Quando o tipo de ativo digital não é Web Desktop ou Web Mobile, ou todos os padrões WCAG e de testers confiáveis, você não pode executar testes automatizados ou importar problemas IGT e manuais. Os botões na página de Visão Geral da Execução de Teste exibem "Não aplicável" em vez de "Executar Testes Automatizados" e "Importar Problemas" para tipos de ativos que não são Web Desktop ou Web Mobile.

Nota 3: O Axe Auditor considera apenas violações, portanto, se algum problema importado incluir problemas "Necessita Revisão" ou de "Melhores Práticas", o axe Auditor não importa esses problemas.

Usando Integração Automatizada no Axe Auditor

Visão Geral

Além das importações manuais, axe Auditor suporta importações de problemas por meio de integração automatizada.
O Axe Auditor está integrado com a extensão axe DevTools Pro via APIs, permitindo que os usuários enviem problemas para o Auditor com um único clique—desde que tenham subscrito ao Integração do Axe Auditor em Axe Account.

Como Enviar Dados da Extensão axe DevTools Pro para o Auditor

Pré-requisitos

Antes de enviar os dados, certifique-se de que as seguintes etapas sejam concluídas no Auditor:

1. A Integração Auditor deve estar disponível na extensão devTools pro e o usuário deve assinar a Integração Auditor assinatura.
2. O usuário deve ser um usuário licenciado do Auditor.
3. Crie um caso de teste e uma correspondente execução de teste.
4. Mova a unidade de teste para o status "Em Progresso" . (Se a unidade de teste estiver no status "Não Iniciado", os dados não poderão ser importados.)

Etapas para Importar Problemas

1. Realizar Testes na Extensão Axe DevTools Pro

   • Abra o URL que você deseja testar.
   • Inicie a Extensão Axe DevTools Pro e conclua seu teste.

2. Obter o Link de Teste Compartilhado

   • Após o teste ser concluído, obtenha o link de teste compartilhado e abra-o em uma nova aba.

3. Enviar Problemas ao Auditor

   • Clique no botão "Enviar para Auditor" .
   • Insira o ID da Unidade de Teste, que pode ser copiado da Unidade de Teste do Auditor (disponível na Visão Geral da Execução de Teste e nas páginas de Unidade de Teste ).

4. Confirmação e Manipulação de Dados

   • Uma vez enviado, o DevTools enviará os dados para o Auditor e exibirá uma mensagem de confirmação.
   • Se a Unidade de Teste do Auditor já contiver problemas, uma mensagem solicitará se deseja substituir os dados existentes.
   • Se substituir for selecionado, todos os problemas anteriores no Auditor serão substituídos pelos recém-importados.

Tipos de Problemas Suportados

Os usuários agora podem enviar os seguintes tipos de problemas diretamente para o Auditor através da integração:

• Problemas automatizados
• Problemas de IGT (Intelligent Guided Testing)
• **Problemas manuais**

Todas as **validações**—incluindo **verificações de URL, padrões de metodologia de teste e compatibilidade com a versão axe-core**—serão aplicadas aos dados importados, garantindo precisão e consistência.

---

Mensagens de Erro

---

Esta integração agiliza o fluxo de trabalho de testes de acessibilidade, assegurando uma **transferência de problemas contínua, precisa e eficiente** entre o **Axe DevTools Pro Extension** e o **Auditor**.