Míralo primero
Lo que necesitas
- Jira Cloud: una dirección que termina en
.atlassian.net. - Una cuenta de Jira que pueda crear incidencias en el proyecto al que deben ir los bugs.
- Derechos de administrador en tu espacio de trabajo de UAT Studio.
Conecta tu proyecto de Jira
Crea un token de API en Atlassian
- Inicia sesión en Atlassian con la cuenta de Jira que vas a usar y ve a id.atlassian.com › Security › API tokens.
- Haz clic en Create API token.
- Dale un nombre que reconozcas más adelante, por ejemplo UAT Studio, y elige una fecha de caducidad.
- Haz clic en Copy. Deja la ventana abierta hasta que hayas pegado el token en el paso 5: Atlassian solo lo muestra una vez.
Busca tu dirección de Jira y la clave del proyecto
Dirección de Jira: abre Jira y mira la barra de direcciones. Todo hasta .atlassian.net, incluido, es tu dirección, por ejemplo https://acme.atlassian.net.
Clave del proyecto: el código corto delante de cada número de ticket. En PORTAL-123 la clave es PORTAL. Abre cualquier ticket del proyecto y la verás en la ruta de navegación de arriba. ¿Aún no hay tickets? Abre el proyecto y mira la barra de direcciones: la clave va después de /projects/.
Abre Connections en UAT Studio
Inicia sesión en app.uat.studio y abre tu espacio de trabajo. Haz clic en Connections. También lo encuentras en Setup de cualquier proyecto, como Manage connections.
Añade Jira y rellena la configuración
En Add a connection, elige Jira y haz clic en Add.
Aparece una tarjeta para la nueva conexión. Rellena:
| Campo | Qué rellenar |
|---|---|
| Name | El texto del botón: Send to Jira. Cámbialo si conectas más de un proyecto, por ejemplo Portal Jira. |
| Jira address | Tu dirección del paso 2, como https://acme.atlassian.net. |
| Email of the Jira account | La dirección de correo de la cuenta que creó el token. |
| Project key | La clave del paso 2, en mayúsculas, como PORTAL. |
| Issue type | Bug. Si tu proyecto no tiene el tipo Bug, usa el tipo que tu equipo usa para los defectos, como Task. |
Haz clic en Save settings.
Guarda el token
Pega el token del paso 1 en el campo API token y haz clic en Store token. Después el campo solo muestra los 4 últimos caracteres, para que veas qué token está guardado.
Prueba la conexión
Haz clic en Test connection. UAT Studio inicia sesión en Jira con tu token y comprueba el proyecto. Si todo va bien, ves Connected as <name> to project <project>, y OK junto a la última prueba.
Listo. Todos los proyectos de este espacio de trabajo pueden enviar ya incidencias a este proyecto de Jira.
Enviar incidencias a Jira
Una incidencia
Abre la incidencia. En Ticket in the development team's system, haz clic en Send to Jira.
Unos segundos después el ticket ya está en Jira. El número de ticket y un enlace aparecen en la incidencia, y el historial de la incidencia muestra cuándo se envió y quién lo hizo. Una incidencia ya vinculada no se puede enviar dos veces por error.
Todas las incidencias después del triaje
En Issues › Triage, toma una decisión sobre cada incidencia nueva. Cuando termines, UAT Studio cuenta las incidencias por corregir que aún no tienen ticket. Haz clic en Send 3 to Jira (o las que sean) para crear todos los tickets de una vez.
Qué contiene el ticket de Jira
- Título: el número y el título de la incidencia, como ISS-012: Quote PDF shows the wrong VAT rate.
- Descripción: lo que escribió el tester, el caso de prueba con el paso que falló y el resultado esperado, el entorno y quién la encontró.
- Prioridad según la gravedad, y las etiquetas
UATy el número de incidencia, para que puedas filtrar por ellas. - Un enlace de vuelta a la incidencia en UAT Studio, donde están las capturas de pantalla.
Las capturas de pantalla viajan con ella
Las capturas de pantalla y los archivos de la incidencia se adjuntan al ticket de Jira: hasta 10 archivos de 10 MB como máximo cada uno. Un archivo que no cabe se queda en UAT Studio, y el historial de la incidencia indica cuál.
Fusionar duplicados
Cuando fusionas en UAT Studio dos incidencias que tienen ticket, el ticket duplicado las sigue: recibe un comentario, el vínculo duplicates con el otro ticket y pasa a Done. Si tu flujo de trabajo no lo permite, UAT Studio te avisa y lo cierras tú en Jira. Si solo el duplicado tenía ticket, la incidencia que se queda lo hereda.
Cuando la corrección está lista en Jira
Cuando el desarrollador pasa el ticket a un estado de la categoría Done, la incidencia en UAT Studio pasa a Ready for retest y el tester recibe un correo para volver a probar. Cuando el ticket pasa a In Progress, la incidencia también. El estado en Jira se muestra junto al enlace del ticket.
Una nueva prueba fallida nunca se deshace: si el tester reabre la incidencia mientras el ticket sigue en Done, UAT Studio la deja abierta. Una incidencia cerrada sigue cerrada.
Solo, o al instante
Sin hacer nada, UAT Studio consulta el estado del ticket cada vez que un administrador abre las incidencias, y con el botón Update ticket status.
Al instante: deja que Jira avise a UAT Studio cuando un ticket cambia. Necesitas permiso para crear una regla de automatización en el proyecto de Jira.
- En UAT Studio, en Connections, dentro de la conexión con Jira, haz clic en Create webhook address y copia la dirección. Solo se muestra una vez.
- En Jira, abre el proyecto y ve a Project settings › Automation › Create rule.
- Disparador: Work item transitioned (en versiones antiguas de Jira: Issue transitioned). Deja From y To vacíos.
- Acción: Send web request. Web request URL: la dirección que copiaste. Method POST. Web request body: Issue data (Jira format).
- Llama a la regla UAT Studio status y actívala.
Quién puede hacer qué
Si algo sale mal
| Ves | Qué hacer |
|---|---|
| No se acepta el token o la dirección de correo | La dirección de correo debe ser la de la cuenta de Atlassian que creó el token. Revisa si hay errores tipográficos, o crea un token nuevo y guárdalo otra vez. |
| No se encontró el proyecto … | Comprueba la clave del proyecto y que la cuenta de Jira puede ver el proyecto. |
| El envío falla por el tipo de incidencia | El proyecto no tiene ningún tipo con ese nombre. Consulta los tipos en tu proyecto de Jira y rellena el correcto en Issue type. |
| Antes funcionaba, ahora no | Probablemente el token ha caducado o se ha revocado. Crea uno nuevo y guárdalo; lo demás sigue igual. |
| El estado no vuelve | Abre las incidencias como administrador o haz clic en Update ticket status. Con una dirección de webhook: comprueba que la regla de automatización está activada y mira su registro de auditoría en Jira; en Connections ves cuándo llegó el último mensaje. |
| No aparece el botón Send to Jira | Solo lo ven los administradores, y solo cuando la conexión está en On y tiene un token guardado. |
| Las conexiones no forman parte de tu plan | Las conexiones se incluyen en Team, Business, Partner y Enterprise, y como complemento en Project. Tu administrador puede cambiar de plan en Plan & billing. |
¿Sigues atascado? Escribe a [email protected] con el mensaje que ves. Nunca nos envíes el token.
¿Usas Azure DevOps? Consulta Conectar UAT Studio con Azure DevOps. Todas las guías: Ayuda de UAT Studio.
Cómo tratamos tu token
- El token va una sola vez de tu navegador a nuestro servidor, por una conexión cifrada.
- Se guarda cifrado (AES-256). La clave para descifrarlo se guarda aparte de la base de datos, así que una copia de la base de datos por sí sola no sirve de nada.
- Nadie puede volver a leer el token: ni en la app ni a través del soporte.
- UAT Studio usa el token solo para probar la conexión, crear los tickets que envías (con sus archivos), leer el estado de esos tickets y cerrar un ticket duplicado después de una fusión. No lee nada más de tu Jira.
- Elimina la conexión o revoca el token en Atlassian y el acceso termina al instante.