Plantillas de Integración de Jira

Las plantillas son asignaciones predefinidas de campos de problemas de axe a campos de Jira que ayudan a crear formatos estandarizados para los tickets de Jira. Las plantillas se pueden crear para cualquier combinación de tipo de proyecto y problema y pueden ser utilizadas por cualquier persona en tu organización al enviar problemas a Jira.

Gestión de Acceso a Plantillas

Quién Puede Crear Plantillas

Cualquiera con acceso al producto de integración de Jira puede crear plantillas.

Quién Puede Editar o Eliminar Plantillas

• Autores de plantillas: Los usuarios que crearon la plantilla pueden editar o eliminar sus propias plantillas
• Admins del portal de cuentas de axe: Pueden editar o eliminar cualquier plantilla en la organización

Permisos de Plantillas

• Las plantillas son recursos a nivel de organización
• Todos los usuarios con acceso a la integración de Jira pueden usar cualquier plantilla
• Solo los autores de plantillas y los administradores pueden modificar las plantillas
• Las plantillas no se pueden restringir a usuarios o grupos específicos

Creando una Plantilla

1. Navega a la página de "CONFIGURACIÓN" dentro del Portal de Cuentas de axe (o navega directamente a https://axe.deque.com/configuration/integrations y omite el paso 2)
2. Haz clic en el enlace "Integraciones" dentro de la navegación de "Configuración"
3. Haz clic en el enlace "Configurar Plantillas de Jira"
4. Haz clic en el botón "Agregar Plantilla"
5. Rellena los campos en los pasos de "Información de la Plantilla", "Asignación de Campos" y "Asignación de Impacto". Puedes ver más detalles de cada paso en las secciones siguientes.
6. Revisa la información completada en los pasos 1 a 3
7. Haz clic en "Guardar"

Para utilizar una plantilla, consulta la sección de Envío de Problemas a Jira.

Agregando Información de la Plantilla

El primer paso para crear una plantilla es configurar la información básica que determina dónde y cómo se crearán los problemas en Jira.

1. Nombre de la Plantilla: Introduce un nombre descriptivo para tu plantilla. Este nombre aparecerá en la lista de plantillas al enviar problemas a Jira. Ejemplo: "A11Y Bug", "Accesibilidad Móvil", "Violaciones WCAG 2.1"
2. Proyecto: Selecciona el proyecto de Jira donde se crearán los problemas al usar esta plantilla. El desplegable muestra todos los proyectos en los que tienes permiso para crear problemas.
3. Tipo de Problema: Elige el tipo de problema que se creará en Jira. Las opciones disponibles dependen de la configuración del proyecto seleccionado. Tipos comunes: Error, Tarea, Historia, Subtarea
4. Habilitar Capturas de Pantalla de Problemas de Axe como Archivos Adjuntos: Cuando está activado, las capturas de pantalla capturadas por las herramientas de axe se adjuntarán automáticamente al ticket de Jira. Esto proporciona un contexto visual para los desarrolladores que arreglan los problemas.

Configurar Asignación de Campos

En la página de asignación de campos, el usuario puede asignar campos de axe a campos de Jira para transferir automáticamente los datos de problemas de accesibilidad al crear tickets:

1. En el desplegable del Campo de Jira, selecciona el campo de Jira que deseas asignar
2. En el desplegable del Campo de axe, elige el campo de datos de axe correspondiente
3. Haz clic en + Agregar Campo de axe para asignar campos adicionales
4. Haz clic en el botón menos (−) para eliminar una asignación
5. Haz clic en el botón Siguiente para guardar

Importante: Todos los campos de Jira requeridos (por ejemplo, Resumen) se muestran automáticamente en esta página. Si no los asignas a campos de axe, se solicitará a los usuarios que los rellenen manualmente al enviar problemas.

Los campos comunes de axe disponibles para asignación incluyen:

1. Regla: el ID de la regla de accesibilidad que se violó
2. Descripción: descripción detallada del problema de accesibilidad
3. Cómo corregirlo: instrucciones para resolver el problema
4. URL de Ayuda: enlace a la documentación de la regla
5. Resumen del Problema: resumen breve del problema
6. Selector: selector CSS del elemento
7. Fuente del Elemento: código fuente HTML del elemento
8. URL de la Captura de Pantalla del Problema: la URL de la captura de pantalla asociada con el problema
9. Etiquetas: array de etiquetas de metadatos para el problema (categorías, identificadores de punto de control wcag, etc.)
10. Nombre de la Prueba: nombre de la prueba guardada en la que se encontró el problema
11. URL para Compartir el Problema: enlace directo al problema compartido en el producto axe
12. Creado el: la fecha en que se detectó el problema
13. URL de Prueba del Problema: URL de la página probada
14. Encontrado por: usuario que realizó la prueba en la que se planteó el problema
15. Título de la Página: título del documento de la página probada
16. Versión de Axe: la versión de axe-core utilizada para la prueba

Campo de Descripción de Jira

El campo de descripción de Jira sigue una estructura estandarizada que no se puede personalizar ni mapear. Cuando los problemas se envían a Jira, automáticamente incluyen una descripción estructurada con las siguientes secciones:

• Descripción del Problema: descripción del problema
• Cómo corregirlo: instrucciones de remediación paso a paso
• Ubicación del Problema:
  • Selector: selector CSS del elemento con problema
  • Código Fuente del Elemento: código fuente HTML del elemento con problema
• URL de la Página: URL de la página probada
• Detalles Adicionales:
  • Impacto: nivel de severidad del problema
  • Enlace de Problema de Axe: enlace al informe de problemas en el Portal de Cuenta de axe (si está disponible)
  • Ayuda de la Regla: enlace a la documentación de la regla

Configurar Mapeo de Impacto

Los problemas de accesibilidad en axe se clasifican por nivel de impacto, indicando qué tan gravemente afectan a los usuarios. En la página de Mapeo de Impacto, puedes mapear estos niveles de impacto a tus valores de prioridad de Jira para asegurar una priorización adecuada de problemas.

Manejo de Errores

Validación de Campo Requerido

Si se deja en blanco un campo requerido en la plantilla

Durante el momento de envío del problema, el sistema mostrará un mensaje de error y los usuarios deben proporcionar un valor para el campo requerido antes de enviar el problema a Jira. Un problema de axe no puede enviarse a Jira hasta que todos los campos requeridos tengan valores.

Si una plantilla asigna un valor a un campo requerido de Jira pero el valor no existe en todos los productos de axe

• Durante la creación de la plantilla, el sistema mostrará un mensaje de advertencia de que el campo asignado no está disponible en todos los productos de axe, pero los usuarios pueden continuar creando la plantilla a pesar de la advertencia.
• Durante el envío de problemas a Jira, si una plantilla contiene asignaciones a campos que faltan en un producto de Deque, aparecerá un mensaje de advertencia. El sistema destacará los campos que requieren entrada manual y los usuarios deben ingresar manualmente valores para cualquier campo requerido que falte antes de que el problema pueda ser enviado. Los problemas solo se enviarán a Jira una vez que todos los campos requeridos estén completos, ya sea a través de asignaciones existentes o entrada manual.

Edición y Eliminación de Plantillas

Para editar o eliminar una plantilla, activa el menú "Opciones" para la plantilla dada y se te darán 2 opciones:

• Editar plantilla
• Eliminar plantilla