Solução de Problemas

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Orientações para resolver problemas que você pode encontrar ao usar o Axe Developer Hub

Not for use with personal data

Abrir um Projeto Mostra „Nenhum Dado de Varredura Disponível“

Se você já executou verificações de acessibilidade e espera ver resultados, deve verificar a configuração do projeto.

Verifique sua Chave de API

Sua chave de API pessoal deve ser compatível com o tipo de projeto. Para projetos que integram Axe Watcher, Web APIs ou CLI, você deve usar uma chave de API Axe Developer Hub. Para projetos móveis, você deve usar uma chave de API Axe DevTools para Mobile. Para criar uma chave de API, você precisa ter uma licença ativa para Axe Developer Hub e/ou Axe DevTools para Mobile. Assim que tiver acesso, visite Chaves de API para adicionar uma nova chave.

Clique no botão + ADICIONAR NOVA CHAVE DE API, e você verá uma janela pop-up como a ilustrada abaixo:
Selecione Axe Developer Hub ou Axe DevTools para Mobile no menu Produto.
Dê um Nome para a chave de API.
Clique em Salvar.

Após alguns segundos, a página Gerenciar Chaves de API atualizada será exibida, bem como uma mensagem indicando que a Chave de API foi adicionada com sucesso.

Na coluna Ações para suas chaves de API, clique para copiar uma chave de API para a área de transferência. Você deverá ver uma mensagem indicando que a chave de API foi copiada com sucesso.

Quando você configuraro seu projeto, pode ter copiado e colado código em seus testes de ponta a ponta. Revise esse código e certifique-se de que substituiu API_KEY pela chave de API correspondente.

Verifique seu ID de Projeto

Para encontrar seu ID do Projeto, navegue até as Instruções de Instalação na página de Projetos. Abra o menu de Configurações para seu projeto e selecione Configurar Projeto. Você verá o ID do Projeto, que pode clicar para copiar para a área de transferência. Revise o código que copiou e colou em seus testes de ponta a ponta durante configuração do projeto e certifique-se de que substituiu todas as instâncias de PROJECT_ID pelo ID do Projeto correspondente.

Verifique se a Saída da Varredura Não Mostra Erros

Na janela em que seu teste está sendo executado, pode haver erros que impediram os resultados de serem enviados para o Axe Developer Hub. Revise cuidadosamente esses erros e resolva-os.

Verifique se o Teste Foi Concluído com Sucesso

Se o seu teste ainda estiver em execução, seus resultados podem não ter sido enviados ao Developer Hub ainda. Aguarde até que o seu teste termine com sucesso e, em seguida, atualize a página para ver seus resultados.

Não Está Vendo Resultados para Todas as Varreduras

Se você escanear várias vezes o mesmo commit (mesmo SHA do commit), os resultados podem ser "sobrescritos" para mostrar apenas o mais recente. Quando dados do Git estão sendo usados, é necessário criar um novo commit para ver novos escaneamentos. Se você não quiser criar um novo commit toda vez que rodar o teste, e este projeto ainda não estiver bloqueado pelo Git, usar testes sem Git evita o problema.

Para obter uma visão sem Git de uma suíte de testes, envie seus resultados para um projeto separado, bloqueado sem Git, em vez de tentar alterar o formato de dados de um projeto existente. Uma vez que um projeto tenha se bloqueado ao Git em sua primeira sessão bem-sucedida, deletar a pasta .git ou desativar a coleta de dados do Git não produzirá mais uma sessão sem Git: a execução será rejeitada. Veja Execução Rejeitada: Formato de Dados ou Repositório Não Corresponde ao Projeto para saber como é a rejeição e como resolvê-la.

Como uma boa prática, você deve executar a suíte de testes cada vez que um novo commit for criado.

Os Dados do Git Não Correspondem ao Código

Se testes de ponta a ponta estiverem sendo executados em um repositório separado do código que você está testando, os dados do Git exibidos serão para o teste, não o código que você está testando. Se isso causar confusão e o projeto ainda não estiver bloqueado pelo Git, usar testes sem Git evita o problema.

Como uma boa prática, recomendamos que você mantenha os testes de ponta a ponta no mesmo repositório do código que está testando.

Execução Rejeitada: Formato de Dados ou Repositório Não Corresponde ao Projeto

Uma vez que um projeto tenha ingerido sua primeira sessão bem-sucedida, seu formato de dados (Git ou sem Git) e, para projetos Git, seu repositório, são bloqueados. Uma execução que não corresponde ao bloqueio é rejeitada na ingestão, e os resultados não são salvos. A mensagem de rejeição nomeia o que o projeto espera, o que a execução enviou e o que fazer a respeito, por exemplo:

This project is locked to a different repository. Project expects {lockedRepo}; this run sent {incomingRepo}. The results were not ingested. Send this run to its own Axe Developer Hub project, or check that CI is providing git information for the locked repository.

Causas comuns e como resolvê-las:

Um segundo repositório ou suíte de testes está direcionado ao mesmo projeto. Envie-o para seu próprio projeto em vez de para aquele já bloqueado em um repositório diferente.
Um clone superficial, estado de HEAD destacado, ou falta de origin remoto está removendo a URL do repositório, o branch, ou o SHA do commit do CI, fazendo uma execução Git parecer sem Git. Verifique se sua configuração de CI fornece informações completas do Git. Consulte Axe Watcher em Ambientes de Integração Contínua (CI) para orientações específicas de CI.
A coleta de dados do Git foi desativada em um projeto já bloqueado para o Git. Enviar uma execução com git: false ou com a pasta .git removida não converte mais o projeto para sem Git; a execução é rejeitada. Envie execuções sem Git para um projeto separado sem Git.

Execução Rejeitada: Cliente Web Enviou Resultados para um Projeto Móvel

O Axe Watcher e o Axe DevTools CLI podem enviar resultados apenas para um projeto web. Se o ID do projeto na sua configuração de teste pertencer a um projeto móvel, a sessão é recusada quando se inicia e nenhum resultado é salvo. O erro é o seguinte:

This is a mobile project. Axe Watcher and the axe DevTools CLI can only send results to a web project.

Para resolver, verifique seu ID de projeto e substitua-o pelo ID de um projeto web, criando um caso necessário. Projetos móveis recebem resultados apenas das ferramentas do Axe DevTools Mobile.

Ajuda

Visite support.deque.com para acessar artigos da base de conhecimento, relatórios de status dos produtos SaaS da Deque e outros suportes de produtos. Se você não conseguir resolver seu problema, por favor envie-nos um e-mail para que possamos ajudar.