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 da integração automatizada no nível da unidade de teste, permitindo-lhes importar 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 é automaticamente importada 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 contanto que estejam usando a mesma versão principal do axe-core. Isso significa que o axe Auditor apenas 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. 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 pode haver algumas variações nos dados de teste. Essas variações se referem principalmente a potenciais diferenças nos pontos de verificação 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, o axe Auditor não importa problemas Experimentais e de Revisão Necessária. 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 testes e problemas salvos: Use a opção 'Testes e problemas salvos' 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 mostra os pontos de verificação que foram testados como parte dos IGT que não têm problemas relatados. Isso permite que você obtenha uma lista mais completa dos pontos de verificação que foram testados como parte dos testes com o axe DevTools Pro e o 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 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 em uma Execução de Teste do axe Auditor, ela pode ser importada para o axe Auditor com os problemas importados sendo o total de todos os problemas entre várias execuções (após a remoção manual dos duplicados).
Usando o Botão de Importação de 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 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 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 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 → Testes e Problemas Salvos → opção JSON).
Ao importar 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 problemas manuais importados usando um arquivo JSON. Problemas manuais adicionados manualmente pelo usuário permanecem inalterados e não são excluídos ou re-importados.
Nota 2: Quando o tipo de ativo digital não é Web de Desktop ou Web Móvel, ou todos os padrões WCAG e de testador confiável, você não pode executar testes automatizados ou importar problemas IGT e manuais. Os botões na página de Visão Geral de 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 de Desktop ou Web Móvel.
Nota 3: O Axe Auditor considera apenas violações, portanto, se algum problema importado incluir problemas de "Revisão Necessária" 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, o axe Auditor suporta importações de problemas através de integração automatizada.
O Axe Auditor é integrado com a extensão axe DevTools Pro via APIs, permitindo que os usuários enviem problemas perfeitamente para o Auditor com apenas um clique—desde que tenham uma assinatura da Integração 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 as seguintes etapas estejam concluídas no Auditor:
- A Integração do Auditor deve estar disponível na extensão devTools pro e o usuário deve se inscrever na Integração do Auditor subscrição.
- O usuário deve ser um usuário licenciado do Auditor.
- Criar um caso de teste e uma execução de testecorrespondente.
- Mova a unidade de teste para "Em Progresso" status. (Se a unidade de teste estiver com status "Não Iniciado", os dados não poderão ser importados.)
Etapas para Importar Problemas
-
Realizar Testes na Extensão Axe DevTools Pro
- Abra a URL que você deseja testar.
- Inicie a Extensão Axe DevTools Pro e complete seu teste.
-
Obter o Link de Teste Compartilhado
- Uma vez concluído o teste, obtenha o link de teste compartilhado e abra-o em uma nova aba.
-
Enviar Problemas para o 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 do Teste e nas páginas de Unidade de Teste ).
-
Confirmação e Tratamento de Dados
- Uma vez enviado, DevTools enviará os dados ao Auditor e exibirá uma mensagem de confirmação.
- Se a Unidade de Teste do Auditor já contiver problemas, um aviso perguntará se deseja substituir os dados existentes.
- Se a opção substituir for selecionada, todos os problemas anteriores no Auditor serão substituídos pelos novos 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 (Teste Guiado Inteligente)
- **Problemas do manual**
Todas as **validações**—incluindo **verificações de URL, padrões de metodologia de teste e compatibilidade com a versão axe-core**—se aplicarão aos dados importados, garantindo precisão e consistência.
Mensagens de Erro
| **Código de Erro** | **Descrição** |
|---|---|
| **409 - Conflito** | Aparece se a unidade de teste já contém problemas. Os usuários devem clicar em »Substituir Dados« para enviar os problemas. |
| **500 - Erro Interno do Servidor** | Aparece se a **URL, padrão de teste ou versão axe-core** não corresponde à unidade de teste do Auditor. |
Esta integração simplifica o fluxo de trabalho de testes de acessibilidade, garantindo uma **transferência de problemas contínua, precisa e eficiente** entre a **Extensão Axe DevTools Pro** e o **Auditor**.





