Entender los resultados

Después de seguir las instrucciones de instalación de tu kit de herramientas, estarás generando resultados que se envían a Developer Hub cada vez que ejecutes tu conjunto de pruebas. En Developer Hub, puedes ver problemas de accesibilidad nuevos y existentes y seguir las tendencias a lo largo del tiempo.

Entendiendo la estructura de tu proyecto

Developer Hub organiza tus datos de accesibilidad de manera diferente dependiendo de si tus pruebas de extremo a extremo utilizan Git para el control de versiones:

Si usas Git, podrás ver diferentes ramas de tu proyecto y los commits individuales realizados en estas ramas. La estructura es la siguiente:
Proyecto → Ramas → Commits → Lista de problemas → Detalles del problema

Si no usas Git con tu proyecto web, o si ves un proyecto móvil, verás ejecuciones de pruebas individuales y podrás navegar hacia los problemas encontrados en cada ejecución. La estructura es la siguiente:
Proyecto → Ejecuciones de prueba → Lista de problemas → Detalles del problema

Trabajando con tus resultados

Cuando abras un proyecto, verás una lista de ramas (proyectos Git) o ejecuciones de prueba (proyectos sin Git).

Tus resultados de un vistazo

Verás la siguiente información devuelta de tus pruebas de accesibilidad:

• Para proyectos Git: Nombre de la rama, SHA del último commit y mensaje del commit para la prueba de extremo a extremo que se está ejecutando
• Para proyectos sin Git: Marca de tiempo de la ejecución de la prueba
• Número de problemas que superan el umbral de accesibilidad
• Información del paquete y versión del kit de herramientas de accesibilidad que estás usando
• Resumen de comparación que muestra el recuento total de problemas y el número de escaneos
• Un recuento de los problemas nuevos introducidos y los problemas que se resolvieron (solo proyectos web)
• Puntuación de accesibilidad (solo proyectos móviles): Un porcentaje (0–100%) que muestra cuán accesibles fueron los análisis de la sesión, detallado a continuación en Puntuación de Accesibilidad (Solo Proyectos Móviles)
• Botón 'Ver Commits' (solo proyectos Git) para profundizar en los commits individuales
• Botón 'Ver Problemas' para ver la lista completa de problemas

Puntuación de Accesibilidad (Solo Proyectos Móviles)

La puntuación de accesibilidad es un porcentaje (0–100%) que se muestra en las páginas de informes de sesiones móviles. Una puntuación más alta significa menos problemas serios de accesibilidad a lo largo de la sesión.

La puntuación se calcula en dos pasos:

1. Cada análisis se puntúa basado en su problema de accesibilidad más grave:

   • 100% — solo problemas menores, o ningún problema en absoluto
   • 80% — al menos un problema moderado; no hay problemas serios o críticos
   • 40% — al menos un problema serio; no hay problemas críticos
   • 0% — al menos un problema crítico

2. La puntuación de la sesión es el promedio de todas las puntuaciones de análisis.

Por ejemplo, una sesión con tres análisis, uno con solo problemas menores, uno con un problema serio y uno con un problema crítico, tendría una puntuación de (100 + 40 + 0) / 3 ≈ 47%.

Las sesiones sin análisis muestran un estado vacío en lugar de 0%.

Para especificación completa de la fórmula, consulte Calcular una Puntuación en la documentación de Axe DevTools Mobile.

Renombrando sesiones

Por defecto, las sesiones se identifican por su rama de git e información del commit (proyectos Git) o por la marca de tiempo (proyectos sin Git). Puedes establecer un nombre de visualización personalizado en cualquier sesión para facilitar la identificación de ejecuciones de escaneos específicas.

Los nombres personalizados aparecen en todo Developer Hub donde se hace referencia a una sesión: encabezados de página, títulos de panel, migas de pan y etiquetas de comparación. El identificador original de git o de marca de tiempo sigue siendo visible en un área de metadatos en la página de problemas.

Para renombrar una sesión, abre su página de problemas y haz clic en el botón de edición en el encabezado de la página. Los administradores de proyectos, colaboradores y administradores de la organización pueden renombrar cualquier sesión en el proyecto.

Información del pipeline

Para los equipos cuyos tests usan datos de Git con Axe Watcher, todas las ejecuciones pueden compararse con las ejecuciones de CI/CD en la rama por defecto, para asegurar que el nuevo código fusionado no esté introduciendo problemas adicionales de accesibilidad. Para configurar la comparación, un administrador del proyecto debe configurar Watcher para que se ejecute en la rama por defecto del repositorio; esto suele ser la main (o master) rama. Esta instancia del kit de herramientas debe configurarse como una ejecución de pipeline.

Una vez que los datos de escaneo provengan de la ejecución de pipeline designada en la rama por defecto, los resultados se mostrarán en la parte superior de la página. Los usuarios pueden elegir ver varios conjuntos de resultados por clave de API y ver cómo se comparan con la ejecución de pipeline en la rama por defecto.

Aprende más sobre configurar ejecuciones de pipeline con Axe Watcher en entornos de Integración Continua (CI)

Entendiendo las comparaciones

La información de comparación proporcionada para proyectos web te ayuda a entender qué cambió:

• Para proyectos Git:
  • En la página que muestra todas las ramas de tu proyecto, puedes ver cómo el último commit en cada rama compara con la última ejecución del pipeline en la rama predeterminada.
  • Cuando seleccionas una rama individual para ver, puedes ver cómo cada commit único en esa rama se compara con el commit que lo precede.
• Para proyectos sin Git: Cada ejecución de prueba se compara con la ejecución anterior.

Si no ves ningún dato de comparación, es probable que no haya habido un escaneo previo disponible para comparar, o que aún no se haya ejecutado un escaneo del pipeline en la rama predeterminada.

Obtén más información sobre cómo usar comparaciones para rastrear tendencias

Más información sobre problemas de accesibilidad

Después de hacer clic en Ver problemas desde una rama, commit o ejecución de prueba, verás una página de resumen que lista y agrupa las violaciones de accesibilidad por regla y nivel de impacto.

Tabla de comparación (solo para proyectos web)

Los proyectos web muestran una tabla de comparación en la parte superior que muestra:

• Total de problemas en los escaneos actuales y de referencia
• Nuevos problemas introducidos
• Problemas previamente existentes
• Problemas que fueron resueltos
• Todos estos se agrupan por severidad de impacto (Crítico, Grave, Moderado, Menor)

Nota: Los proyectos móviles no incluyen esta tabla de comparación.

Lista de reglas

Debajo de la sección de comparación (o en la parte superior para móviles), verás todas las reglas de accesibilidad violadas agrupadas por:

• Nombre de la regla (que puedes seleccionar para ver problemas individuales)
• Nivel de impacto
• Número de violaciones encontradas para esa regla

Filtrar y exportar

Con proyectos web, usa los controles de filtro para enfocarte en problemas específicos:

• Filtrar por nivel de impacto (Crítico, Grave, Moderado, Menor)
• Mostrar solo nuevos problemas
• Seleccionar estados específicos de página

Con proyectos móviles, utiliza el filtro para seleccionar una o varias pantallas en la lista y enfocarte en ciertos resultados.

Exporta tus resultados:

• Web
  • Exporta JSON para compartir fácilmente resultados detallados en formato legible por humanos
  • Exporta CSV para hojas de cálculo e informes
• Móvil
  • Exporta en formato Axe Universal JSON para integración con otras herramientas

Las exportaciones se alinearán con tus filtros actuales.

Página de problema único

Haz clic en cualquier nombre de regla en la lista de problemas para ver información detallada sobre cada violación.

Encontrar problemas en tu código

Proyectos web proporcionan:

• Código fuente del elemento (fragmento HTML)
• Selector CSS para localizar el elemento
• Expresión XPath como un localizador alternativo
• Todos con botones de copia para facilitar su uso en tus herramientas de desarrollo

Proyectos móviles proporcionan:

• Captura de pantalla con el problema resaltado
• Vista de detalles: Brinda contexto para el elemento problemático
• Vista de inspección de jerarquía: Muestra el árbol jerárquico para que puedas identificar la ubicación exacta y ver las propiedades detalladas del elemento

Guía de remediación

Cada problema incluye:

• Descripción de la regla que explica el problema de accesibilidad
• Enlaces a Deque University o páginas de reglas móviles para una guía completa y ejemplos de código
• Nivel de impacto y etiquetas de accesibilidad (criterios WCAG, mejores prácticas)
• Navegación para recorrer todas las instancias de esta violación (ej., "1 de 5")

Compartir problemas

Haz clic en Copiar enlace del problema en la parte superior de la página para compartir con tu equipo o agregar a tu sistema de seguimiento de problemas.

Permisos de compartición: Los enlaces de problemas respetan las configuraciones de compartición de tu organización. Los miembros del equipo necesitan permisos adecuados para ver los problemas. Los administradores pueden configurar las configuraciones de compartición en:

• Configuración global - Establecer valores predeterminados de compartición a nivel organizacional
• Configuración del proyecto - Accede y actualiza configuraciones para proyectos individuales en Axe Developer Hub