Solución de problemas
Guía para resolver problemas que pueda encontrar al usar Axe Developer Hub
Al abrir un proyecto se muestra „No hay datos de escaneo disponibles“
Si ya ha ejecutado escaneos de accesibilidad y espera ver resultados, debe verificar la configuración del proyecto.
Verificar su clave API
Tu clave de API personal debe ser compatible con el tipo de proyecto. Para los proyectos que integran Axe Watcher, APIs web, o CLI, debes usar una clave de API del Axe Developer Hub. Para proyectos móviles, debes usar una clave de API de Axe DevTools para Móviles. Para crear una clave de API necesitas tener una licencia activa para Axe Developer Hub y/o Axe DevTools para Móviles. Una vez tengas acceso, visita Claves de API para añadir una nueva clave.
- Haz clic en el botón + AÑADIR NUEVA CLAVE API, y verás una ventana emergente como la que se muestra a continuación:

- Selecciona Axe Developer Hub o Axe DevTools para Móviles en el menú desplegable Producto.
- Dale a la clave de API un Nombre.
- Haz clic Guardar.
Después de unos segundos, se mostrará la página actualizada de Administrar Claves API, junto con un mensaje indicando que la clave API se añadió exitosamente.
En la columna Acciones de tus claves de API, haz clic para copiar una clave de API al portapapeles. Deberías ver un mensaje indicando que la clave de API se copió exitosamente.
Cuando configures configurar su proyecto, es posible que hayas copiado y pegado código en tus pruebas de extremo a extremo. Revisa este código y asegúrate de que has reemplazado API_KEY con la clave de API correspondiente.
Verificar su ID de proyecto
Para encontrar tu ID de Proyecto, navega a las Instrucciones de Instalación desde la página de Proyectos. Abre el menú desplegable de Configuración de tu proyecto y selecciona Configurar Proyecto. Verás el ID del Proyecto, el cual puedes hacer clic y copiar al portapapeles. Revisa el código que copiaste y pegaste en tus pruebas de extremo a extremo durante configuración del proyecto y asegúrate de que reemplazaste todas las instancias de PROJECT_ID con el ID del Proyecto correspondiente.
Verificar que la salida de escaneo no muestre errores
En la ventana que ejecuta su prueba, puede haber errores que impidieron que los resultados se enviasen a Axe Developer Hub. Revise cuidadosamente estos errores y resuélvalos.
Verificar que la prueba se completó con éxito
Si su prueba aún está en ejecución, es posible que los resultados aún no se hayan enviado al Developer Hub. Espere a que su prueba finalice con éxito y luego actualice la página para ver sus resultados.
No se ven resultados para todos los escaneos
Si escaneas varias veces en el mismo commit (el mismo SHA de commit), los resultados pueden "sobrescribirse" para mostrar solo el más reciente. Cuando se utilizan datos de Git, debes crear un nuevo commit para ver los nuevos escaneos. Si no deseas crear un nuevo commit cada vez que ejecutas la prueba, y este proyecto aún no está bloqueado por Git, usar pruebas sin Git evita el problema.
Para obtener una vista de una suite de pruebas sin Git, envíe sus resultados a un proyecto separado y bloqueado sin Git en lugar de intentar cambiar la forma de los datos de un proyecto existente. Una vez que un proyecto se ha bloqueado en Git en su primera sesión exitosa, eliminar la carpeta .git o desactivar la recopilación de datos de Git ya no produce una sesión sin Git: en su lugar, la ejecución se rechaza. Consulte Ejecución Rechazada: La Forma de los Datos o el Repositorio No Coincide con el Proyecto para ver cómo es el rechazo y cómo resolverlo.
Como mejor práctica, debes ejecutar el conjunto de pruebas cada vez que se crea un nuevo commit.
Los datos de Git no corresponden al código
Si se están ejecutando pruebas de extremo a extremo en un repositorio separado del código que estás probando, los datos de Git que se muestran serán para la prueba, no el código que estás probando. Si esto causa confusión y este proyecto aún no está bloqueado por Git, usar pruebas sin Git lo evita.
Para obtener una vista de una suite de pruebas sin Git, envíe sus resultados a un proyecto separado y bloqueado sin Git en lugar de intentar cambiar la forma de los datos de un proyecto existente. Una vez que un proyecto se ha bloqueado en Git en su primera sesión exitosa, eliminar la carpeta .git o desactivar la recopilación de datos de Git ya no produce una sesión sin Git: en su lugar, la ejecución se rechaza. Consulte Ejecución Rechazada: La Forma de los Datos o el Repositorio No Coincide con el Proyecto para ver cómo es el rechazo y cómo resolverlo.
Como mejor práctica, recomendamos que mantengas las pruebas de extremo a extremo en el mismo repositorio que el código que estás probando.
Ejecución Rechazada: Forma de Datos o Repositorio No Coincide con el Proyecto
Una vez que un proyecto ha ingerido su primera sesión exitosa, su forma de datos (Git o sin Git) y, para proyectos Git, su repositorio, quedan bloqueados. Una ejecución que no coincide con el bloqueo es rechazada en la ingesta, y los resultados no se guardan. El mensaje de rechazo nombra lo que el proyecto espera, lo que la ejecución envió y qué hacer al respecto, por ejemplo:
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 comunes y cómo resolverlas:
- Un segundo repositorio o conjunto de pruebas está apuntado al mismo proyecto. Envíalo a su propio proyecto en lugar de al que ya está bloqueado a un repositorio diferente.
- Un clon superficial, estado de HEAD separado, o una
originremota faltante está eliminando la URL del repositorio, la rama, o el SHA del commit de CI, haciendo que una ejecución de Git parezca sin Git. Verifica que tu configuración de CI proporcione información completa de Git. Consulta Axe Watcher en Entornos de Integración Continua (CI) para obtener orientación específica de CI. - La recolección de datos de Git se desactivó en un proyecto ya bloqueado a Git. Enviar una ejecución con
git: falseo con la carpeta.giteliminada ya no convierte el proyecto a sin Git; la ejecución es rechazada. Envía ejecuciones sin Git a un proyecto separado sin Git.
Ayuda
Visita support.deque.com para acceder a artículos de la base de conocimiento, informes de estado del producto SaaS de Deque y otros soportes de producto. Si no puedes resolver tu problema, por favor envíenos un correo electrónico para que podamos ayudarte.
