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 JiraAdonde van las incidencias.Jira Cloud con cualquier plan, incluido el gratuito, o Jira Data CenterJira de Atlassian
Un token de API de JiraPermite a GUI Test Studio crear incidencias en su nombre, sin su contraseñaCrear un token de API
GUI Test StudioLa prueba, y la ejecución que fallóInstalar y configurar
TeamCity (para el paso 3)Ejecuta las pruebas con cada cambioTeamCity de JetBrains

Paso 1: conectar Jira al informe de confianza

  1. 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. 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.

CampoRellenado con
Proyecto y tipo de incidenciaLeídos de su sitio de Jira.Un Bug cuando el proyecto tiene ese tipo, si no una Task
Asignado aLas personas a las que Jira le permite asignar en ese proyecto
PrioridadLa valoración del propio informe, adaptada a las prioridades de su sitio
ImágenesLo esperado, lo encontrado y lo que cambió, mostrado en la propia incidencia
AdjuntosEl 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:

Comando
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-regression

La conexión procede de tres variables de entorno, así que el token nunca aparece en el comando ni en el registro de compilación:

VariableContiene
JIRA_BASE_URLSu sitio de Jira, como https://your-team.atlassian.net
JIRA_USER_EMAILEl correo electrónico de la cuenta que crea las incidencias
JIRA_API_TOKENEl 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ónQué hace
--jira on-failureCrear una incidencia por cada prueba fallida.Una prueba que no se pudo ejecutar nunca se convierte en una
--jira-projectLa clave del proyecto de Jira, como SCRUM
--jira-issue-typeBug de forma predeterminada; el tipo más cercano cuando el proyecto no lo tiene
--jira-assigneeUn correo electrónico o un nombre, comparado con las personas del proyecto
--jira-labelsEtiquetas propias, separadas por comas
--jira-repeat newCrear siempre una incidencia nueva, nunca un comentario

¿No usa Jira ni TeamCity?

Jira y TeamCity son el ejemplo, no un requisito.

  1. 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-failure funciona en todos ellos.Consulte Ejecutar pruebas en su pipeline.

  2. 2

    Cualquier gestor de incidencias

    Sin Jira, --bug-report pdf (o excel, o both) 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 --json tiene todo lo que necesita un script para registrarla por usted.

  3. 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.

Reservar una demo