# Trazabilidad con Jira > Vincula casos de prueba a historias y épicas de Jira, y crea informes de trazabilidad cuyas versiones guardan una instantánea de los requisitos que cubren. 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](https://docs.probara.net/es/guides/integrations/jira/). 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](https://docs.probara.net/es/guides/integrations/github/#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](https://docs.probara.net/es/guides/integrations/jira-panel/) | ## 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](https://docs.probara.net/es/developers/api/traceability-reports/). Los asistentes de IA usan las herramientas de trazabilidad de la [referencia de herramientas MCP](https://docs.probara.net/es/developers/mcp-tools/): `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](https://docs.probara.net/es/guides/integrations/jira/#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](https://docs.probara.net/es/guides/integrations/jira/#definir-una-vinculación-predeterminada-para-la-organización) 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. |