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 ao nível da unidade de teste, permitindo-lhes importar problemas automatizados, IGT e manuais em uma única operação.

Nota 1 - Importando automaticamente a captura de tela com o problema manual: Quando você importa uma questão 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: Axe Auditor permite que você importe questões geradas pela extensão axe DevTools Pro desde que estejam utilizando 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 do número da versão) for diferente entre a Execução do 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 coincide com a versão do axe Auditor e que pode haver algumas variações nos dados de teste. Essas variações estão principalmente relacionadas a possíveis diferenças nos pontos de verificação da Deque associados às questões no axe Auditor.

Nota 3 - Importando Problemas do axe DevTools Mobile para Android Nativo e iOS Nativo - Ao importar questões do axe DevTools Mobile para tipos de ativos digitais baseados em aplicativos móveis nativos, o axe Auditor não importa questões Experimentais e Necessita Revisão. Além disso, o axe Auditor ignora questões 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 'Testes e questões salvas' ao exportar questões da extensão do axe DevTools.

Nota 5 - Importando Arquivos JSON com Zero Problemas: Ao importar arquivos JSON usando o DevTools Pro com zero questões, o axe Auditor mostra os pontos de verificação que foram testados como parte dos IGTs que não têm questões relatadas. Isso permite que você obtenha uma lista mais completa de 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 em Importações do axe DevTools: Se você estiver usando o recurso de execuções múltiplas na extensão do 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 as questões importadas sendo o total de todas as questões em execuções múltiplas (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 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 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 a hora quando a importação dos problemas foi iniciada,
• O status do teste indicando o status da importação e a data e hora de sua conclusão, 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 Importar 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 → Teste e Problemas Salvos → 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 questões novamente, você pode optar por manter as questões existentes ou substituí-las pelas questões no arquivo, se a unidade de teste já contiver essas questões. O Axe Auditor apenas exclui e substitui questões manuais importadas usando um arquivo JSON. Questões manuais adicionadas manualmente pelo usuário permanecem inalteradas e não são excluídas ou reimportadas.

Nota 2: Quando o tipo de ativo digital não é Web Desktop ou Web Mobile, ou todos os padrões WCAG e testadores confiáveis, você não pode executar testes automatizados ou importar IGT e questões 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 Questões" para tipos de ativos que não sejam Web Desktop ou Web Mobile.

Nota 3: Axe Auditor considera apenas violações, portanto, se quaisquer questões importadas incluírem questões "Necessita Revisão" ou "Melhores Práticas", o axe Auditor não importa essas questões.

Usando Integração Automatizada no Axe Auditor

Visão Geral

Além das importações manuais, axe Auditor suporta importações de questões através de integração automatizada.
O Axe Auditor é integrado com axe DevTools Pro Extension via APIs, permitindo que os usuários enviem questões para o Auditor com um único clique—desde que tenham assinado Integração do Axe Auditor no 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 sejam concluídas no Auditor:

1. A integração com o Auditor deve estar disponível na extensão devTools pro e o usuário deve assinar a assinatura Integração com o Auditor.
2. O usuário deve ser um usuário licenciado do Auditor.
3. Crie um caso de teste e um correspondente teste executado.
4. Mova o status unidade de teste para "Em Progresso". (Se a unidade de teste estiver com 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 a URL que você deseja testar.
   • Inicie Axe DevTools Pro Extension e complete seu teste.

2. 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.

3. Enviar Problemas para o Auditor

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

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

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

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 (Testes Inteligentes Guiados)
• Problemas manuais

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

---

Mensagens de Erro

---

Essa integração simplifica o fluxo de trabalho de testes de acessibilidade, assegurando uma transferência de questões transferência de problemas fluida, precisa e eficiente entre Axe DevTools Pro Extension e Auditor.