Importando 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 através de integração automatizada no nível da unidade de teste, permitindo que importem problemas automatizados, IGT e manuais em uma única operação.

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

Nota 2 - Comparando apenas as 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 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 do número da versão) for diferente entre a Execução de Teste e a extensão. Caso as versões secundárias sejam diferentes, o axe Auditor apenas fornecerá um aviso ao usuário, indicando que a versão do axe-core sendo importada não corresponde à versão do axe Auditor e que podem haver algumas variações nos dados de teste. Essas variações se referem principalmente a potenciais diferenças nos pontos de verificação do Deque associados aos problemas no axe Auditor.

Nota 3 - Importando Problemas do axe DevTools Mobile para Android Móvel Nativo e iOS Móvel 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 que Precisam de Revisão. Além disso, o axe Auditor ignora problemas com o conjunto de regras AAA, já que não suporta regras AAA.

Nota 4 - Usando a opção Teste salvo e problemas: Use a opção 'Teste salvo e problemas' ao exportar problemas da extensão axe DevTools.

Nota 5 - Importando Arquivos JSON com Zero Problemas: Ao importar arquivos JSON usando o DevTools Pro com zero problemas, o axe Auditor exibe os pontos de verificação que foram testados como parte dos IGTs que não tiveram problemas relatados. Isso permite que você obtenha uma lista mais completa de pontos de verificação que foram testados como parte do teste com axe DevTools Pro e axe Auditor, permitindo que você se concentre apenas naqueles pontos de verificação que ainda precisam ser testados.

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

Usando o Botão 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 de 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 Visão Geral da Unidade de Teste, use a seção chamada Status de Testes para importar problemas automatizados, IGT e manuais. Essa seção contém:

• A data e hora em que a importação dos problemas foi iniciada,
• O status dos testes indicando o status da importação e a data e hora em que foi concluída, e
• Um botão 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 traz à tona 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 Salvo e Problemas → opção JSON).

Quando você importa um problema, a captura de tela associada é automaticamente importada 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 os problemas manuais importados usando um arquivo JSON. Os problemas manuais adicionados manualmente pelo usuário permanecem intocados 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 testador confiável, não é possível realizar testes automatizados ou importar problemas de IGT e manuais. Os botões na página Visão Geral da Execução de Testes 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, então, se quaisquer problemas importados incluírem problemas de "Necessita Revisão" ou "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 através de integração automatizada.
O Axe Auditor é integrado com Extensão axe DevTools Pro via APIs, permitindo que os usuários enviem problemas para o Auditor com um único clique — desde que tenham assinado a Integração do Axe Auditor na Conta Axe.

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

Pré-requisitos

Antes de enviar dados, certifique-se de que os seguintes passos sejam concluídos no Auditor:

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

Passos para Importar Problemas

1. Realizar Testes na Extensão Axe DevTools Pro

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

2. Obter o Link de Teste Compartilhado

   • Quando o teste estiver completo, obtenha o link de teste compartilhado e abra-o em uma nova aba.

3. Enviar Problemas para o Auditor

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

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

   • Uma vez submetido, DevTools enviará os dados para o Auditor e exiba uma mensagem de confirmação.
   • Se o Unidade de Teste do Auditor já contém problemas, uma solicitação perguntará se deseja substituir os dados existentes.
   • Se substituir for selecionado, todas as questões anteriores no Auditor serão substituídas pelas novas importadas.

Tipos de Problemas Suportados

Usuários agora podem enviar os seguintes tipos de problemas diretamente para o Auditor via integração:

• problemas automatizados
• problemas de IGT (Testes Guiados Inteligentemente)
• problemas manuais

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

---

Mensagens de Erro

---

Esta integração simplifica o fluxo de trabalho de testes de acessibilidade, garantindo uma sem interrupções, preciso e eficiente transferência de problemas entre Extensão Axe DevTools Pro e Auditor.