Preguntas Frecuentes

Conceptos

¿Cuál es la diferencia entre un proyecto con Git y un proyecto sin Git?

Developer Hub organiza sus resultados de manera diferente dependiendo de si sus pruebas utilizan Git:

• Un proyecto con Git asocia los resultados de accesibilidad con ramas y commits, lo que le permite rastrear problemas hasta cambios específicos en el código.
• Un proyecto sin Git organiza los resultados como una serie de ejecuciones de prueba ordenadas por marca de tiempo, sin ningún dato de Git.
• Los datos de Git están disponibles cuando se utiliza Axe Watcher, Axe CLI o Axe DevTools para las API web (que cargan resultados a través de la CLI). Los proyectos móviles siempre son sin Git.

Consulte Comprenda Sus Resultados y las entradas del glosario para Git y sin Git para más detalles.

¿Qué es el umbral a11y y cómo lo configuro?

El umbral a11y refleja la tolerancia de su organización a los problemas de accesibilidad y determina qué se considera como una falla en su pipeline de CI/CD:

• Se calcula a partir de dos criterios: si contar todos los problemas o solo los nuevos y qué niveles de impacto incluir (el nivel Crítico siempre se incluye).
• Solo los administradores de proyectos pueden configurar el umbral.

Consulte Cambiar el Umbral A11y para obtener todos los detalles.

¿Qué significan los niveles de impacto (Crítico, Grave, Moderado, Menor)?

Cada violación de accesibilidad se asigna a uno de cuatro niveles de impacto, de más a menos severo:

• Crítico: Los usuarios con discapacidades tienen completamente bloqueado el acceso o la interacción con una función.
• Grave: Los usuarios con discapacidades enfrentan barreras significativas al interactuar con el sitio.
• Moderado: Existen algunas barreras, pero el contenido básico sigue siendo accesible.
• Menor: Problemas menos severos que aún requieren resolución para el cumplimiento total.

Consulte el Glosario para obtener definiciones detalladas.

Comparaciones

Developer Hub proporciona dos tipos de comparaciones para proyectos con Git. Comparaciones entre ramas aparecen en la vista de Ramas, donde se compara cada rama con la ejecución más reciente del pipeline en la rama predeterminada (esto muestra lo que cambiaría si fusionara en este momento). Comparaciones dentro de la rama aparecen en la vista de Commits, donde cada commit se compara con el commit escaneado anterior en la misma rama (esto le indica lo que un commit específico introdujo o solucionó). Consulte Comprenda Sus Resultados para una visión completa.

¿Cómo determino qué está cambiando de una versión a otra?

La vista de Ramas en un proyecto con Git le permite rastrear los cambios de accesibilidad entre versiones usando una comparación entre ramas:

• El commit escaneado más reciente de cada rama se compara con la ejecución más reciente del pipeline en su rama predeterminada.
• La comparación muestra el número total de problemas, nuevos problemas introducidos, problemas resueltos y cualquier cambio en el número de estados de página escaneados.

Para ver qué cambió en los commits individuales dentro de una rama, consulte ¿Cómo puedo ver qué ha cambiado de commit a commit dentro de una rama?

¿Cómo puedo determinar cuál será el impacto de una solicitud de extracción?

Ejecute su suite de pruebas en la rama de la solicitud de extracción para que los resultados aparezcan en Axe Developer Hub:

• En la vista de Ramas, cada rama que no sea la predeterminada muestra una comparación entre ramas y la rama predeterminada, mostrando nuevos problemas introducidos, problemas resueltos y la diferencia total.
• Si utiliza la Acción de GitHub, puede publicar automáticamente un comentario en la PR con un resumen y un enlace a los resultados completos.

Para profundizar en lo que cambió cada commit en la rama, consulte ¿Cómo puedo ver qué ha cambiado de commit a commit dentro de una rama?

¿Cómo puedo ver qué ha cambiado de commit a commit dentro de una rama?

Desde la vista de Ramas, haga clic en Ver Commits en cualquier rama para ver sus commits escaneados individualmente. A diferencia de las comparaciones entre ramas en la vista de Ramas, la vista de Commits utiliza comparaciones dentro de la rama:

• Cada commit se compara con el commit escaneado anterior en esa rama, mostrando nuevos problemas, problemas resueltos y cambios en los estados de página.
• Solo aparecerán los commits en los que se ejecutó la suite de pruebas.

Para ver cómo se compara la rama en su totalidad con la rama predeterminada, consulte ¿Cómo puedo comparar una rama con la última ejecución de CI/CD en la rama predeterminada?

¿Cómo puedo comparar una rama con la última ejecución de CI/CD en la rama predeterminada?

La vista de Ramas realiza automáticamente una comparación entre ramas para cada rama que no sea la predeterminada contra la última ejecución de la canalización de la rama predeterminada:

• Esto requiere que un administrador del proyecto haya configurado Axe Watcher para ejecutarse en la rama predeterminada como una ejecución de canalización.
• La comparación muestra problemas totales, nuevos problemas, problemas resueltos y diferencias en los estados de página.

Para ver qué cambió en los commits individuales dentro de esa rama, consulte ¿Cómo puedo ver qué ha cambiado de commit a commit dentro de una rama?

¿Cómo consigo resultados de comparación precisos antes de crear una solicitud de extracción?

Para obtener la comparación entre ramas más precisa antes de fusionar, mantenga su rama de características actualizada con la rama predeterminada:

1. Fusionar la rama predeterminada en su rama de características (por ejemplo, git merge main) antes de ejecutar su suite de pruebas.
2. Envíe el commit de fusión para que Axe Developer Hub pueda escanear la rama actualizada.
3. La vista de Ramas luego comparará su rama contra la última ejecución de la canalización en la rama predeterminada, mostrando solo los cambios de accesibilidad que realmente introduce su rama.

Si su rama de características está detrás de la rama predeterminada, la comparación puede mostrar problemas que ya fueron solucionados en la rama predeterminada pero que aún no se han fusionado en su rama de características. Fusionar la rama predeterminada primero elimina esos falsos positivos y reduce las sorpresas cuando se fusiona la solicitud de extracción.

CI/CD

¿Cómo me aseguro de que no se fusionen nuevos problemas de accesibilidad en mi código?

Integre Axe Developer Hub en su canalización de CI/CD para que las verificaciones de accesibilidad se ejecuten automáticamente en cada commit o solicitud de extracción:

• Si usa GitHub, la Acción de GitHub de Axe Developer Hub puede bloquear PRs que introducen errores de accesibilidad.
• Para otras plataformas como GitLab o Bitbucket, utilice la API de servicio REST para consultar resultados y fallar en su canalización cuando se detecten problemas.
• Puede ajustar qué se considera un fallo configurando el umbral de accesibilidad (a11y).

¿Cómo integro Axe Developer Hub con mi canalización de CI/CD si no uso GitHub?

Puede usar la API de servicio REST para integrarse con cualquier plataforma de CI/CD:

• La API de servicio REST le permite consultar Axe Developer Hub para obtener resultados después de que se ejecute su suite de pruebas.
• La API devuelve el conteo de problemas, nuevas violaciones, violaciones resueltas y un enlace a los resultados completos en Developer Hub.
• Puedes usar esta respuesta para aprobar o rechazar tu pipeline en GitLab, Bitbucket, Jenkins o cualquier otra plataforma.

Gestión de Proyectos

¿Cómo puedo ver los escaneos de accesibilidad de otros miembros del equipo en un proyecto?

Todos los miembros del proyecto pueden ver todos los resultados dentro de un proyecto compartido una vez que han sido añadidos:

• Agrega miembros del equipo a través de la página de configuración de Miembros.
• En los proyectos Git, la vista de Ramas muestra los resultados agrupados por clave de API, para que puedas ver quién realizó cada escaneo.

Para detalles sobre roles y permisos, consulta Configurar Proyectos para Uso del Equipo.

¿Cómo exporto mis resultados de accesibilidad?

Developer Hub ofrece varias maneras de exportar tus datos:

• Desde la vista de resumen de problemas, haz clic en el botón Exportar Problemas para descargar los resultados como CSV o JSON.
• Para acceso programático, utiliza el API de Servicio REST para consultar resultados de un commit y proyecto específicos.

Consulta Obtener Resultados de Forma Programática para más opciones.