Solución 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

Guía para resolver problemas que pueda encontrar al usar Axe Developer Hub

Not for use with personal data

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.

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 origin remota 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: false o con la carpeta .git eliminada ya no convierte el proyecto a sin Git; la ejecución es rechazada. Envía ejecuciones sin Git a un proyecto separado sin Git.

Ejecución Rechazada: Cliente Web Envió Resultados a un Proyecto Móvil

Axe Watcher y Axe DevTools CLI solo pueden enviar resultados a un proyecto web. Si el ID del proyecto en su configuración de prueba pertenece a un proyecto móvil, la sesión es rechazada cuando comienza y no se guardan resultados. El error dice:

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

Para resolverlo, verifique su ID de proyecto y reemplácelo con el ID de un proyecto web, creando uno si es necesario. Los proyectos móviles solo reciben resultados de las herramientas Axe DevTools Mobile.

Ejecución Rechazada: El Administrador de la Organización No Es Miembro del Proyecto

Los administradores de la organización ven todos los proyectos de su organización, pero solo pueden enviar resultados a los proyectos de los que son miembros (con el rol de administrador o miembro) y solo con una licencia activa para ese tipo de proyecto. Una licencia faltante o inactiva se rechaza por separado, antes de esta verificación. Si usted es un administrador de la organización con una licencia activa y el ID del proyecto en su configuración de prueba pertenece a un proyecto del que no es miembro, la ejecución es rechazada con un error 403 que dice:

You don't have access to this project <project ID>. Please ensure you have the required permissions.

Para resolverlo, agregue a usted mismo al proyecto en su página de Miembros (consulte Añadir Miembros a un Proyecto), o envíe resultados a un proyecto del que ya es miembro. Si selecciona proyectos con la API de Proyectos, añada member_only=true para listar solo los proyectos de los que es miembro.

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.