Trazabilidad con Jira

La trazabilidad muestra qué requisitos (incidencias de Jira) cubren tus casos de prueba y cómo se ejecutaron por última vez. Vinculas los casos de prueba a las incidencias de Jira que verifican. Después creas un informe de trazabilidad a partir de los proyectos de Jira que elijas. Cada versión de un informe es una instantánea de sus requisitos en el momento en que se generó, con sus casos de prueba vinculados, sus últimos resultados y sus defectos.

Se necesita un sitio de Jira conectado a Probara y el plan Pro o Enterprise; consulta Integración con Jira Cloud. Sin una integración activa, la pantalla Trazabilidad muestra un aviso y no puedes crear informes. Los informes existentes siguen disponibles para consultarlos. Los issues de GitHub también pueden ser requisitos: consulta Trazabilidad con GitHub.

Quién puede hacer qué

Acción	Quién
Ver los informes, sus versiones y sus requisitos	Cualquiera que pueda abrir el proyecto
Crear, generar versiones, renombrar y eliminar informes y versiones	Miembros, administradores y propietarios (quien pueda editar casos de prueba)
Vincular y desvincular incidencias de Jira en casos de prueba	Miembros, administradores y propietarios (quien pueda editar casos de prueba)
Vincular y desvincular casos de prueba desde Jira	Usuarios de Jira que pueden editar la incidencia; consulta El panel de Probara en Jira

Vincular un caso de prueba a una incidencia de Jira

1. Abre el caso de prueba y ve a su pestaña Propiedades, o ábrelo en el editor completo. La sección Incidencias de Jira muestra las incidencias de Jira que cubre el caso.
2. Selecciona Vincular incidencia de Jira.
3. Escribe palabras del resumen de la incidencia para buscar en los proyectos de Jira vinculados a este proyecto, o pega una clave de incidencia como WEB-40.
4. Elige la incidencia. Aparece en Incidencias de Jira con su estado actual en Jira.

La incidencia recibe en Jira un enlace Probara que apunta al caso. Para quitar una incidencia, selecciona Desvincular y confirma: la incidencia sigue en Jira y el caso deja de contar para su cobertura. Los casos de prueba archivados conservan sus vínculos y se pueden seguir vinculando.

Solo puedes vincular incidencias de proyectos de Jira vinculados a este proyecto de Probara. Si una incidencia se movió en Jira, el proyecto en el que está ahora también debe estar vinculado.

Vincular muchos casos a la vez

1. En el Repositorio del proyecto, selecciona los casos de prueba.
2. En la barra de selección, elige Vincular a incidencia de Jira….
3. Elige la historia, épica u otra incidencia que cubren estos casos (busca o pega una clave).

Probara los vincula y lo resume en un solo mensaje: cuántos se vincularon, cuántos ya lo estaban y cuántos no se encontraron. Las selecciones grandes se envían en lotes de 200. Si algo falla a medias, el mensaje indica lo que se completó; al reintentar solo se envían los casos que aún no se procesaron.

Crear un informe

1. En la barra lateral del proyecto, selecciona Trazabilidad (en Casos). La entrada siempre está visible.
2. Selecciona Crear informe.
3. Escribe un Nombre del informe. Por defecto empieza como «Informe de trazabilidad» seguido de la fecha de hoy.
4. Elige uno o más Proyecto. La lista muestra los proyectos de Jira que permite cada sitio conectado, no solo los proyectos que este proyecto de Probara vincula.
5. Opcionalmente, elige Tipos de incidencia. Déjalo vacío para incluir todos los tipos de incidencia de los proyectos seleccionados.
6. Selecciona Crear informe. Probara guarda el informe e inicia su primera versión.

Un informe solo cubre los proyectos y tipos de incidencia que elegiste, así que un informe nuevo no incluye todo el sitio. Puede tener hasta 20 proyectos de Jira y 50 tipos de incidencia, y su nombre hasta 200 caracteres.

Generar versiones

Crear un informe genera la Versión 1. Para tomar una nueva instantánea con los mismos proyectos y tipos de incidencia, selecciona Generar nueva versión en el menú de la fila del informe o en la pantalla de la versión. Las versiones se numeran 1, 2, 3 y así sucesivamente; el número de una versión eliminada no se reutiliza.

La generación se ejecuta en segundo plano. Una versión muestra uno de estos estados:

Estado	Significado
En cola	Espera para empezar.
Generando	Probara está leyendo los requisitos de Jira.
Lista	La instantánea está completa.
Fallida	La generación se detuvo. No se conserva nada de la versión.

Puedes salir de la página mientras se genera una versión. La pantalla de la versión muestra Generando la instantánea y se actualiza sola hasta que la versión esté lista. Solo una versión lista muestra sus totales y sus requisitos.

Una versión lista no cambia nunca. Los cambios posteriores en Jira o en Probara no aparecen en ella; para ver el estado actual, genera una nueva versión. No puedes generar una versión mientras otra del mismo informe está en cola o generándose.

Una versión admite como máximo 5.000 requisitos. Una versión fallida muestra el motivo:

Motivo que se muestra	Qué hacer
La conexión de un proyecto seleccionado ya no está activa, o ya no permite el proyecto	Revisa la conexión de Jira en la configuración de integraciones. Si el proyecto ya no está permitido, crea un informe con los proyectos que sí lo estén.
Los filtros coinciden con más de 5.000 requisitos	Crea un informe con menos proyectos o tipos de incidencia.
No se pudo leer el gestor de incidencias	Espera unos minutos y genera una nueva versión.
Cualquier otro caso	Genera una nueva versión.

Gestionar informes y versiones

La pantalla Trazabilidad lista cada informe con sus proyectos de Jira, sus tipos de incidencia, su número de versiones y los recuentos de vinculados y sin vincular de su última versión. Selecciona un informe para ver sus versiones, con el estado, la fecha de generación y los recuentos de cada una. Selecciona una versión para consultarla.

Desde el menú de la fila de un informe puedes generar una nueva versión, renombrarlo o eliminarlo. Al eliminar un informe se eliminan todas sus versiones, y no se puede deshacer. Una versión se puede renombrar o eliminar por separado; al eliminar una, las demás se conservan. Si dejas vacío el nombre de una versión, vuelve a mostrarse como «Versión N».

Consultar una versión

Una versión se abre con un resumen de una línea: los proyectos de Jira que cubre, cuántos requisitos contiene y qué porcentaje tiene casos vinculados. Si cubre más de dos proyectos o repositorios, el resumen nombra los dos primeros; selecciona +N más para verlos todos. Usa el selector Versión para moverte entre las versiones del informe.

Los requisitos se dividen en dos pestañas:

• Vinculados lista los requisitos que vincula al menos un caso de prueba de este proyecto. Un caso vinculado cuenta aunque esté archivado; los casos archivados muestran la etiqueta Archivado.
• Sin vincular lista los requisitos que ningún caso de prueba vincula. Señalan huecos en las pruebas.

Cada requisito es una tarjeta. Su cabecera muestra la clave y el resumen de Jira (la clave abre la incidencia en Jira), el tipo, el estado y la Actualización en Jira, cuándo se actualizó por última vez en Jira. En pantallas estrechas, la actualización y el estado comparten una línea bajo el resumen.

En la pestaña Vinculados, una franja bajo la cabecera muestra Casos vinculados, con el total y, si alguno está obsoleto, cuántos están Sin actualizar. También muestra Defectos con el total, seguido de un chip por cada estado de defecto que tenga defectos, como Abierto 2. Abierto cuenta solo los defectos en estado Abierto, así que un defecto en progreso cuenta en En progreso.

Despliega una tarjeta con la flecha al final de su franja para ver sus casos en tres columnas: Estado del caso (el último resultado, o sin ejecutar), Caso de prueba (ID visible, título y cuándo se editó el caso por última vez) y Defecto. Cada defecto tiene una marca compacta que muestra su estado, seguida de su ID y su título. En pantallas estrechas, cada caso se convierte en un bloque: su estado y su caso de prueba comparten la primera línea, y sus defectos van debajo.

Un icono de obsoleto marca un caso cuyo requisito de Jira cambió después de la última edición del caso. Cuenta como edición cualquier cambio guardado en el caso, incluidos sus pasos y campos como las precondiciones; registrar un resultado del caso en una ejecución no. Probara lo calcula al generar la versión, así que los cambios posteriores no aparecen hasta que generes una nueva versión.

Cada requisito lista hasta 200 casos vinculados, y cada caso lista hasta 20 defectos. Los recuentos incluyen siempre todos.

Buscar y filtrar

La búsqueda encuentra requisitos por su clave de Jira (WEB-12, sin distinguir mayúsculas) o por palabras del título. Los filtros se combinan entre sí, y varios valores dentro de un mismo filtro coinciden con cualquiera de ellos:

Filtro	Mantiene los requisitos que	Pestaña
Estado del requisito	Están en la categoría Por hacer, En curso o Hecho en Jira	Ambas
Proyecto externo	Pertenecen al proyecto de Jira elegido	Ambas
Último resultado	Tienen un caso vinculado cuyo último resultado es Aprobado, Fallido, Bloqueado, Omitido o Sin ejecutar	Vinculados
Estado del defecto	Tienen un defecto vinculado Abierto, En curso, Resuelto o Cerrado	Vinculados

Cuando una pestaña tiene 10 requisitos o más, usa el paginador debajo de ellos para cambiar de página. Elige 10, 25, 50 o 100 requisitos por página.

Exportar CSV

Selecciona Exportar CSV para descargar los requisitos de la pestaña, la búsqueda y los filtros actuales. El archivo tiene una fila por requisito, con su clave, título, tipo, estado, categoría y fecha de actualización, sus casos vinculados y obsoletos, sus defectos en total y por cada estado, los IDs de sus casos vinculados y su URL en Jira. Incluye todos los requisitos de la versión que coinciden, y se abre correctamente en las aplicaciones de hojas de cálculo.

Automatizar

Los scripts y los trabajos de CI pueden crear y consultar informes con un token de API a través de la API de informes de trazabilidad. Los asistentes de IA usan las herramientas de trazabilidad de la referencia de herramientas MCP: list_traceability_sources, list_traceability_source_projects, list_traceability_source_issue_types, list_traceability_reports, create_traceability_report, generate_traceability_version, list_traceability_report_versions, get_traceability_version y list_traceability_version_requirements. Para vincular y desvincular se usan list_test_case_jira_issues, link_test_case_jira_issue y unlink_test_case_jira_issue. Consulta Automatizar con la API y MCP.

Solución de problemas

Mensaje o situación	Qué hacer
No aparece el botón Vincular incidencia de Jira	El proyecto todavía no vincula ningún proyecto de Jira, o tu plan no incluye integraciones.
«No hay ninguna integración activa» en la pantalla Trazabilidad	Conecta un sitio de Jira o una cuenta de GitHub en la configuración de integraciones. Los miembros ven un mensaje que pide a un administrador de la organización que lo conecte.
«La trazabilidad no está incluida en tu plan.»	La trazabilidad necesita el plan Pro o Enterprise.
«Uno de los proyectos seleccionados ya no está disponible. Revisa la selección.»	Un sitio conectado ya no permite ese proyecto. Vuelve a seleccionar los proyectos.
«Ya se está generando una versión de este informe.»	Espera a que esa versión esté lista y luego genera una nueva.
«Este proyecto de Jira no está vinculado a este proyecto de Probara.»	Un propietario o administrador lo vincula en Configuración del proyecto › Jira, o en la vinculación predeterminada si el proyecto no tiene una propia.
«Esta incidencia de Jira ya está vinculada a este caso de prueba.»	Nada que hacer.
«No puedes cambiar las incidencias de Jira de los casos de prueba.»	Tu rol no puede editar casos de prueba.
«Se muestran los primeros 200 casos vinculados.»	El requisito tiene más casos vinculados de los que muestra la lista; sus recuentos siguen incluyendo todos.