# El panel de Probara en Jira

> Qué ven los usuarios de Jira sobre Probara en una incidencia de Jira, quién puede verlo y cómo vincular casos de prueba desde Jira.

Cada incidencia de Jira de un sitio conectado puede mostrar un panel **Probara**. Da a quienes
trabajan en Jira (desarrolladores, responsables de producto) la parte de Probara de esa incidencia
sin salir de Jira: qué casos de prueba la cubren y cómo se ejecutaron la última vez, y qué defectos
están vinculados a ella. **Los usuarios de Jira no necesitan una cuenta de Probara** para verlo.

El panel viene con la aplicación Probara for Jira; no hay que instalar nada más. Se da por hecho que
hay un sitio de Jira conectado; consulta [Integración con Jira Cloud](https://docs.probara.net/es/guides/integrations/jira/).
El panel está en inglés, como el resto de la aplicación dentro de Jira.

## Qué muestra el panel

Abre una incidencia de Jira y selecciona **Probara** entre las aplicaciones de la incidencia. El panel
muestra:

- **Coverage** (cobertura): el estado de los casos de prueba activos vinculados a la incidencia, con un
  recuento por resultado. **Failing** significa que un caso que la cubre falló la última vez que se
  ejecutó; **Passing** significa que todos los casos que la cubren pasaron la última vez que se
  ejecutaron; **In progress** significa que ninguno falló, pero hay casos sin probar, bloqueados u
  omitidos; **Not covered** significa que ningún caso de prueba activo está vinculado;
- **Test cases** (casos de prueba): cada caso vinculado con su identificador, título, último
  resultado, ejecución y cuándo se ejecutó. Los casos archivados aparecen con una marca y no se
  cuentan. Al seleccionar un título se abre el caso en Probara (Jira pregunta antes de salir);
- **Defects** (defectos): cada defecto vinculado con su identificador, título y estado.

El panel muestra hasta 50 casos de prueba y 50 defectos; una nota indica cuándo Probara tiene más. La
cobertura cuenta los primeros 1000 casos de prueba vinculados; a partir de ahí, el panel lo indica y
remite a Probara.

Cuando el panel no tiene nada que mostrar, explica por qué:

| Mensaje                                                                 | Significado                                                                                |
| ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| «This Jira site is not connected to Probara» (sitio no conectado)       | No hay ninguna organización de Probara conectada, o su plan no incluye integraciones       |
| «This Jira project is not shared with Probara» (proyecto no compartido) | El sitio está conectado, pero este proyecto de Jira no está entre sus proyectos permitidos |

Ninguno de los dos mensajes revela a qué organización está conectado el sitio, si lo está.

## Quién puede ver y cambiar qué

**Decide Jira, no Probara.** Cada vez que se carga el panel, Probara pregunta a Jira, con la propia
cuenta de Jira de quien lo mira, qué puede hacer esa persona en esta incidencia.

| En el panel                                    | Necesita, en Jira                             |
| ---------------------------------------------- | --------------------------------------------- |
| Ver los datos del panel                        | Permiso para ver el proyecto de la incidencia |
| Buscar, vincular y desvincular casos de prueba | Permiso para editar la incidencia             |

Probara recuerda un «sí» durante aproximadamente un minuto por persona e incidencia, así que un
permiso que quitas en Jira puede tardar hasta un minuto en dejar de mostrar los datos. Vincular y
desvincular siempre vuelven a preguntar a Jira.

## Qué pueden ver los usuarios de Jira

> **Privacidad.** En cada proyecto de Jira que comparte la conexión, **todos los que Jira deja ver una
> incidencia ven todos los datos de Probara vinculados a ella**, incluidos los de proyectos de
> Probara de los que no son miembros.

Esos datos son el nombre de la organización, los identificadores y títulos de los casos de prueba, el
estado de sus últimos resultados, los nombres y fechas de las ejecuciones, y los identificadores,
títulos y estados de los defectos. No incluyen el detalle de los pasos, los comentarios, los adjuntos
ni nada que no esté vinculado a la incidencia.

Controlas esta exposición desde Probara:

- Los **proyectos de Jira permitidos** del sitio conectado deciden en qué proyectos de Jira el panel
  muestra datos. Una lista vacía comparte todos los proyectos. Consulta
  [Elegir qué proyectos de Jira puede usar Probara](https://docs.probara.net/es/guides/integrations/jira/#elegir-qué-proyectos-de-jira-puede-usar-probara).
- Las **vinculaciones** deciden qué proyectos de Probara pueden vincularse a un proyecto de Jira: las
  propias de cada proyecto o, para un proyecto sin ninguna, la
  [vinculación predeterminada](https://docs.probara.net/es/guides/integrations/jira/#definir-una-vinculación-predeterminada-para-la-organización)
  de la organización.

Comparte solo los proyectos de Jira cuyo público pueda ver estos datos.

## Vincular casos de prueba desde Jira

Quienes pueden editar la incidencia ven **Link test cases** (vincular casos de prueba):

1. Selecciona **Link test cases**.
2. Busca por título o escribe un identificador de caso de prueba como `WEB-12`.
3. Elige hasta 20 casos; los que ya cubren la incidencia aparecen como **Already linked** (ya
   vinculado).
4. Selecciona el botón de vincular (por ejemplo **Link 3 test cases**). Un resumen indica cuántos se
   vincularon, cuántos ya lo estaban y cuántos no se encontraron.

Solo se pueden vincular casos de prueba de proyectos de Probara vinculados al proyecto de Jira de la
incidencia, y no los de proyectos archivados. Para quitar uno, selecciona **Unlink** (desvincular) en
su fila y confirma; el caso sigue en Probara. Los vínculos con defectos no se pueden cambiar desde el
panel.

Los vínculos hechos desde Jira cuentan igual que los hechos en Probara: aparecen en las **Incidencias de Jira**
del caso de prueba, en la siguiente versión de cualquier
[informe de trazabilidad](https://docs.probara.net/es/guides/integrations/jira-traceability/), y en la
[Actividad del workspace](https://docs.probara.net/es/guides/workspace/activity/) como hechos por el sistema, con la cuenta de
Jira.

## Solución de problemas

| Ves                                                                              | Qué hacer                                                                                                                                                                                                                                                         |
| -------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| «You don't have permission to see Probara data for this issue.»                  | Jira no te deja ver el proyecto de esta incidencia. Pídeselo a un administrador de Jira.                                                                                                                                                                          |
| No aparece **Link test cases**, o «You need permission to edit this Jira issue…» | No puedes editar esta incidencia en Jira. Pide el permiso, o vincula el caso desde Probara.                                                                                                                                                                       |
| «This Jira project is not mapped to a Probara project…»                          | Un propietario o administrador lo vincula en **Configuración del proyecto › Jira** de un proyecto de Probara, o en la [vinculación predeterminada](https://docs.probara.net/es/guides/integrations/jira/#definir-una-vinculación-predeterminada-para-la-organización) de la organización. |
| Un caso de prueba que esperas «could not be found» (no se encontró)              | Su proyecto de Probara no está vinculado a este proyecto de Jira, o el proyecto está archivado.                                                                                                                                                                   |
| «The connection to Probara needs attention.»                                     | Un administrador de Jira abre **Configuración de Jira › Apps › Probara**; consulta la solución de problemas de la conexión en [Integración con Jira Cloud](https://docs.probara.net/es/guides/integrations/jira/).                                                                        |
| «Too many requests. Try again in a moment.»                                      | El panel tiene un límite por persona y por sitio. Espera y selecciona **Try again**.                                                                                                                                                                              |