Conectar Jira al informe de confianza: cada prueba end-to-end fallida se convierte en un bug de Jira, automáticamente
Conecte su sitio de Jira una vez a GUI Test Studio y cada prueba end-to-end fallida se convierte en una incidencia de Jira lista para corregir: pasos para reproducirla, imágenes esperada y encontrada con el cambio rodeado, un PDF y las pruebas.Desde el informe de confianza en un clic, o desde TeamCity y cualquier pipeline de CI/CD en cada build fallido.
8 min de lecturaPor el equipo de GUI Test Studio
El informe de defecto que nadie tiene que escribir
Cuando una prueba end-to-end falla, alguien tiene que decírselo a los desarrolladores: qué se rompió, dónde, cómo llegar y cómo debería verse.Escribirlo bien lleva tiempo, y las imágenes y los pasos suelen faltar o ser vagos.
Una ejecución fallida de GUI Test Studio ya lo sabe todo.Grabó cada paso, la imagen o el texto que esperaba, lo que mostró la pantalla en su lugar y cuántas veces había fallado antes la prueba.El informe de error lo convierte en un ticket, y con Jira conectado al informe de confianza llega directamente a su backlog: una regresión funcional, un flujo roto, una pantalla equivocada, cada uno como una incidencia lista para corregir.
Jean sube un cambio
Un nuevo estilo para los botones del pago
TeamCity ejecuta la prueba end-to-end
Con gtr-cli
La prueba falla
Los botones ya no se ven como deben
Aparece una incidencia de Jira
Pasos, imágenes, evidencias
En este artículo, Jean es el desarrollador, Pierre escribió la prueba, James se ocupa del backlog en Jira y John gestiona TeamCity.La tienda y su prueba son una pequeña demostración, pero cada imagen procede de una ejecución real.
Lo que necesita
| Qué | Por qué | Dónde conseguirlo |
|---|---|---|
| Un sitio de Jira | Adonde van las incidencias.Jira Cloud con cualquier plan, incluido el gratuito, o Jira Data Center | Jira de Atlassian |
| Un token de API de Jira | Permite a GUI Test Studio crear incidencias en su nombre, sin su contraseña | Crear un token de API |
| GUI Test Studio | La prueba, y la ejecución que falló | Instalar y configurar |
| TeamCity (para el paso 3) | Ejecuta las pruebas con cada cambio | TeamCity de JetBrains |
Paso 1: conectar Jira al informe de confianza
- 1
Crear un token de API
En su cuenta de Atlassian, abra Seguridad, tokens de API y cree uno.Cópielo: solo se muestra una vez.En Jira Data Center, cree en su lugar un token de acceso personal en su perfil de Jira.
- 2
Conectar GUI Test Runner-Recorder
En el informe de confianza de una ejecución, haga clic en Conectar Jira junto a Informe de error (el formulario del informe de error también lo ofrece, bajo Crear una incidencia de Jira).Pegue la dirección de cualquier página de su sitio de Jira, su email y el token.La ventana los comprueba al momento y dice como quién está conectado.Desde entonces cada informe de confianza puede registrar su informe de error en Jira.
Paso 2: enviar una ejecución fallida a Jira desde la aplicación
Abra el informe de confianza de la ejecución fallida y haga clic en Informe de error (o pulse Ctrl+B).Elija Crear una incidencia de Jira.Todo está rellenado a partir de la ejecución: usted solo lo comprueba.
| Campo | Rellenado con |
|---|---|
| Proyecto y tipo de incidencia | Leídos de su sitio de Jira.Un Bug cuando el proyecto tiene ese tipo, si no una Task |
| Asignado a | Las personas a las que Jira le permite asignar en ese proyecto |
| Prioridad | La valoración del propio informe, adaptada a las prioridades de su sitio |
| Imágenes | Lo esperado, lo encontrado y lo que cambió, mostrado en la propia incidencia |
| Adjuntos | El informe de defecto en PDF y un zip con todas las imágenes del fallo |
Haga clic en Crear incidencia de Jira.La clave de la incidencia y un enlace a ella aparecen al momento, y el informe la recuerda: su botón Jira abre esa incidencia desde entonces.El formulario en sí se describe en Crear un informe de error.
Paso 3: dejar que TeamCity lo haga en cada compilación fallida
En un pipeline nadie abre un informe, así que gtr-cli crea la incidencia por sí mismo.Parta del comando de Ejecute sus pruebas end-to-end en cada build y añada las opciones de Jira:
gtr-cli run tests --countdown 0 --format teamcity --artifacts ci-out\artifacts ^
--jira on-failure --jira-project SCRUM --jira-assignee "James" ^
--jira-labels gui-test-studio,ui-regressionLa conexión procede de tres variables de entorno, así que el token nunca aparece en el comando ni en el registro de compilación:
| Variable | Contiene |
|---|---|
| JIRA_BASE_URL | Su sitio de Jira, como https://your-team.atlassian.net |
| JIRA_USER_EMAIL | El correo electrónico de la cuenta que crea las incidencias |
| JIRA_API_TOKEN | El token de API.En TeamCity, conviértalo en un parámetro de contraseña: queda oculto en todas partes |
Cuando una prueba falla, el registro de compilación dice en qué incidencia se convirtió, con su enlace, y la incidencia enlaza de vuelta a la compilación.
Lo que contiene la incidencia de Jira
Esta es la incidencia que creó la compilación fallida, tal como James la encuentra en el backlog.
Pasos para reproducir
Los propios pasos de la ejecución, numerados, hasta el que falló.Un desarrollador puede seguirlos a mano sin tener que adivinar.
Lo que vio la prueba
Por cada comprobación que falló: la imagen que espera la prueba, la imagen que encontró, y de nuevo la imagen encontrada con cada cambio resaltado en rojo.Esta última es la vista Pulso del Informe de confianza: la mirada va directa a lo que cambió.
El informe de defecto en PDF y un zip con todas las imágenes van adjuntos, para quien necesite toda la historia o quiera conservarla.
Un defecto, una incidencia
Un fallo que se repite no debe inundar el backlog.Cada fallo lleva una etiqueta formada a partir de la prueba y de lo que falló.Cuando el mismo defecto vuelve a fallar, en la siguiente compilación, en otro navegador o dispositivo, o en dos ejecuciones a la vez, gtr-cli encuentra su incidencia abierta y añade un comentario con la nueva ejecución en lugar de un duplicado.
Una vez resuelta la incidencia, un nuevo fallo registra una incidencia nueva: un defecto que vuelve es una novedad.
| Opción | Qué hace |
|---|---|
| --jira on-failure | Crear una incidencia por cada prueba fallida.Una prueba que no se pudo ejecutar nunca se convierte en una |
| --jira-project | La clave del proyecto de Jira, como SCRUM |
| --jira-issue-type | Bug de forma predeterminada; el tipo más cercano cuando el proyecto no lo tiene |
| --jira-assignee | Un correo electrónico o un nombre, comparado con las personas del proyecto |
| --jira-labels | Etiquetas propias, separadas por comas |
| --jira-repeat new | Crear siempre una incidencia nueva, nunca un comentario |
¿No usa Jira ni TeamCity?
Jira y TeamCity son el ejemplo, no un requisito.
- 1
Cualquier herramienta de CI
gtr-cli se ejecuta de la misma forma en Jenkins, GitHub Actions, GitLab, Azure DevOps o un script propio, y
--jira on-failurefunciona en todos ellos.Consulte Ejecutar pruebas en su pipeline. - 2
Cualquier gestor de incidencias
Sin Jira,
--bug-report pdf(oexcel, oboth) escribe el mismo informe de defecto ya rellenado y sus evidencias en archivos, listos para adjuntar a una incidencia en cualquier gestor.El archivo de resultados--jsontiene todo lo que necesita un script para registrarla por usted. - 3
Ningún pipeline
Desde la aplicación, Informe de error guarda el informe como PDF o como libro de Excel, o lo envía a Jira, para cualquier ejecución que elija.
Adónde ir después
¿Listo para grabar su primera prueba?
Todas las funciones, durante 15 días.
¿Prefiere verlo con el tipo de aplicación que prueba?Reserve una llamada gratuita de 30 minutos con nuestro equipo.