Xray y Zephyr
Con la integración de Xray Cloud o de Zephyr (Zephyr Scale, en Jira Cloud), Proton publica automáticamente el resultado de las ejecuciones en la gestión de pruebas, crea los Tests de los datasets, convierte un Test Plan en un grupo de automatización y acepta ejecuciones iniciadas desde Jira.
Las pantallas usan los nombres de Xray (Test, Test Execution, Test Plan). Cuando la organización usa solo Zephyr, los textos cambian a sus nombres (Test Case, Test Cycle y Test Plan).
Configurar
En Configuraciones > Integraciones, registra la integración (ver Integraciones):
| Xray | Zephyr | |
|---|---|---|
| URL Base | El Jira Cloud donde está Xray. | El Jira Cloud donde está Zephyr. |
| Credenciales | Client ID y Client Secret de una clave de API de la configuración global de Xray. | El Token de API de Zephyr (en "Zephyr API Access Tokens", en tu perfil de Jira) y la Región de la API de Zephyr. |
| Proyectos | Las claves de los proyectos de Jira (hasta 50) y el proyecto predeterminado. | Igual. |
Publicar los resultados de un grupo
La publicación se configura por grupo de automatización. En el grupo, el botón Xray del encabezado abre el panel lateral Publicación en Xray. En la pestaña Publicación:
| Campo | Qué es |
|---|---|
| Integración de Xray | Solo aparece cuando hay más de una integración. |
| Proyecto | El proyecto de Jira. |
| Test Plan | El plan donde entran los resultados. Si está vacío, Proton crea un plan para el grupo. |
| Carpeta de los Tests en Xray | Donde quedan los Tests creados por Proton. |
| Crear el Test del dataset que aún no tiene | Proton crea el Test en la primera publicación del dataset. |
| Enviar la evidencia al terminar | Envía el informe PDF y las capturas de los pasos. |
| Publicar los lotes del grupo | Activa y desactiva la publicación. |
Después de guardar, el botón muestra el plan en uso (o que la publicación está pausada). Dejar de publicar la desactiva.
Cómo funciona la publicación
La publicación es automática: cada lote de ejecuciones del grupo se convierte en una Test Execution, con el nombre "Proton · grupo · ciclo · lote", vinculada al Test Plan. De cada ejecución se envían el estado, los pasos, los bugs vinculados, un comentario con el enlace de la ejecución y, si se pidió, la evidencia (hasta 10 MB por archivo y 15 MB de capturas por ejecución).
- Proton junta las ejecuciones que terminan en secuencia y las publica en pocos segundos.
- Si Xray o Zephyr rechaza el envío, Proton lo intenta de nuevo, con intervalos cada vez mayores, hasta 8 veces.
- Un dataset sin Test (con la creación automática desactivada) queda fuera, y la pantalla avisa cuántos quedaron.
La pestaña Lotes muestra cada lote: En la cola, la clave de la Test Execution (que se abre en Jira), Nada que publicar o el error con el motivo. Publicar de nuevo vuelve a enviar el lote.
En el detalle de la ejecución, las insignias de la Test Execution, del Test y del Test Plan se abren cada una en Jira.
El Test de cada dataset
Cada dataset se vincula a un Test. Además de la creación automática en la publicación:
- en la tarjeta del dataset, Sin Test ofrece Crear en Xray o Vincular a un Test que ya existe;
- en la lista de datasets, marca varios y usa Enviar a Xray para crear los Tests de una sola vez.
El Test creado por Proton lleva los pasos de los componentes. En un Test que ya existía, Proton no cambia los pasos. Las issues que el Test cubre en Xray se convierten en requisitos del dataset en Proton. Ver Jira.
Importar un Test Plan
En el Centro de Automatización, Importar de Xray crea un grupo de automatización a partir de un Test Plan:
- Elegir el plan: el proyecto y la búsqueda del plan.
- Revisar los Tests: escribe el Nombre del grupo y elige la Automatización de los datasets nuevos. Para cada Test del plan, la pantalla muestra qué hacer: Ya vinculado, Vincular a un dataset sugerido, Elegir dataset, Crear dataset o No importar. Los filtros Vinculados, Sugeridos y Sin dataset ayudan a revisar.
- Confirma. El grupo nace con un ciclo y, con el módulo de Calidad, con la finalidad de prueba.
El grupo importado muestra de qué plan vino, y Sincronizar con el plan trae los Tests que entraron en el plan después. La importación se hace en la computadora.
Ejecutar desde Jira
El grupo puede aceptar ejecuciones iniciadas en Jira, mediante una regla de Jira Automation: por ejemplo, ejecutar el plan cuando una versión pasa a homologación. La configuración está en la pestaña Ejecución desde Jira del panel lateral, después de la publicación:
- Marca Aceptar ejecución desde Jira.
- Elige dónde se ejecuta (runner o cluster), el Ambiente, si graba video y si avisa por correo cuando el lote termine.
- Usa Guardar.
La pestaña muestra entonces La regla en Jira Automation: el método, la dirección, los encabezados y el cuerpo de la llamada, cada uno con el botón de copiar. Arma la regla en Jira con esos datos y con el token de API de una cuenta robot que pueda ejecutar en el Centro de Automatización (el perfil Executor puede).
La regla llama a Proton con la clave de un Test Plan o de una Test Execution, y Proton ejecuta los datasets vinculados a sus Tests. Últimas ejecuciones desde Jira muestra cada pedido, Iniciado o Rechazado con el motivo (clave inválida, ningún grupo acepta la ejecución, ciclo cerrado, sin runner, pedido repetido en menos de un minuto y otros). La ejecución desde Jira cuenta como una ejecución inmediata.
En Zephyr, el Test Cycle y el Test Plan no son issues de Jira: la regla pregunta la clave o se ejecuta a partir de una issue vinculada a un único Test Cycle.
Permisos y celular
| Acción | Permiso en el perfil |
|---|---|
| Ver y configurar la publicación y la ejecución desde Jira | Grupo de Automatización: read y update |
| Importar y sincronizar un Test Plan | Grupo de Automatización: create (y Dataset: create, para crear datasets) |
| Crear y vincular el Test del dataset | Dataset: read y update |
| El robot de la ejecución desde Jira | Centro de Automatización: run |
El panel lateral de la publicación y las insignias del detalle de la ejecución funcionan en el celular; la importación del Test Plan, no.