# Revisión de casos de prueba

> Envía a revisión los casos de prueba nuevos y los cambios en los existentes, y apruébalos, edítalos, recházalos o fusiónalos desde la sección Revisión.

La **revisión de casos de prueba** permite que tu equipo compruebe los casos nuevos y los cambios en
los existentes antes de que lleguen al repositorio. En lugar de guardar, el autor envía el caso a
revisión; el repositorio conserva el caso tal como estaba hasta que se fusiona la solicitud de
revisión.

La revisión de casos de prueba está disponible en los planes **Pro** y **Enterprise** (y durante la prueba gratuita).

## Activar la revisión

Abre la **Configuración** del proyecto y la pestaña **Repositorio**. Activa **Revisión activada** y
elige cómo funcionan las revisiones en el proyecto. Mientras la revisión esté desactivada, el resto de
las opciones se ocultan y no tienen efecto.

| Opción                                                     | Qué hace                                                                                                                                                                           |
| ---------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **La revisión es obligatoria**                             | Cada caso nuevo y cada cambio en un caso deben enviarse a revisión. Si está desactivada, los autores pueden guardar directamente o enviar a revisión.                              |
| **Permitir que el autor fusione**                          | El autor de una solicitud de revisión puede fusionarla cuando tenga las aprobaciones necesarias, aunque no tenga permiso para revisar casos de prueba.                             |
| **Aprobaciones necesarias**                                | Cuántas aprobaciones necesita una solicitud para poder fusionarse. `0` significa que no hay mínimo.                                                                                |
| **Fusión automática**                                      | Fusiona una solicitud en cuanto alcanza las aprobaciones necesarias, salvo que un revisor haya pedido cambios. Requiere al menos 1 aprobación necesaria.                           |
| **Revisores predeterminados**                              | Se asignan a cada nueva solicitud de revisión del proyecto. Solo se pueden añadir miembros con acceso al proyecto que puedan revisar casos de prueba.                              |
| **Solo los casos aprobados pueden añadirse a ejecuciones** | Las ejecuciones solo admiten casos de prueba con el estado de revisión **Aprobado**. Consulta [Solo casos aprobados en las ejecuciones](#solo-casos-aprobados-en-las-ejecuciones). |

Cualquiera que pueda abrir el proyecto puede ver estas opciones. El **Propietario** y los
**Administradores** de la organización, y el propietario del proyecto, pueden cambiarlas. Cada cambio
queda registrado en el registro de actividad. Un revisor predeterminado que deja la organización,
pierde el acceso al proyecto o pasa a un rol que no puede revisar casos de prueba deja de asignarse.

## Los botones del formulario del caso de prueba

Los botones al pie del formulario de un caso nuevo o de la edición de un caso siguen la configuración
del proyecto:

| Configuración del proyecto                                    | Botones                                                                    |
| ------------------------------------------------------------- | -------------------------------------------------------------------------- |
| Revisión desactivada (o un plan sin revisión)                 | **Cancelar**, **Guardar y crear otro**, **Guardar**                        |
| Revisión activada, **La revisión es obligatoria** desactivada | **Cancelar**, **Guardar y crear otro**, **Enviar a revisión**, **Guardar** |
| Revisión activada, **La revisión es obligatoria** activada    | **Cancelar**, **Enviar a revisión**                                        |

**Guardar y crear otro** solo aparece en un caso nuevo.

### Dónde se aplica la revisión obligatoria

Cuando la revisión es obligatoria, la regla también cubre las otras vías por las que un caso llega al
repositorio:

| De dónde viene el cambio                                                               | Qué ocurre                                                                                                                                                                                                                                   |
| -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **+ Crear caso rápido** en el repositorio                                              | El caso nuevo se envía a revisión con los revisores por defecto del proyecto, y la confirmación muestra el ID de la solicitud.                                                                                                               |
| El panel de detalle de un caso                                                         | Sus campos no se pueden editar en el lugar. Haz clic en **Editar caso** para abrir el formulario y enviar tu cambio a revisión.                                                                                                              |
| [Importar un archivo](https://docs.probara.net/es/guides/import-test-cases/#cuando-el-proyecto-exige-revisión) | No se escribe ningún caso: cada caso nuevo se convierte en una solicitud **Caso nuevo** y cada caso reemplazado en una solicitud **Cambio**. Un caso que ya tiene una solicitud abierta se omite y aparece en la lista.                      |
| La [API](https://docs.probara.net/es/developers/api-reference/) y el [servidor MCP](https://docs.probara.net/es/developers/mcp/)       | Crear un caso, o guardar un caso completo, abre una solicitud de revisión en su lugar. Las demás ediciones directas (pasos, valores de campos personalizados, restaurar una versión, convertir o desvincular pasos compartidos) se rechazan. |
| **Duplicar**, y copiar casos o suites al proyecto                                      | Se rechaza.                                                                                                                                                                                                                                  |
| **Archivar** en el panel de un caso, y **Eliminar** en la barra de selección           | Los casos no se archivan: cada uno recibe una solicitud **Archivar caso**. Consulta [Archivar y eliminar mediante revisión](#archivar-y-eliminar-mediante-revisión).                                                                         |
| Eliminar un caso desde la API o el servidor MCP                                        | El caso no se elimina: se abre una solicitud **Eliminar caso**.                                                                                                                                                                              |
| Restaurar un caso desde la papelera                                                    | Se aplica al momento: devuelve el caso tal como estaba.                                                                                                                                                                                      |
| Eliminar una suite con sus casos                                                       | Se rechaza mientras la suite o alguna de sus subsuites tenga un caso sin archivar. Archiva primero sus casos mediante revisión; una suite vacía, o con solo casos archivados, se elimina.                                                    |

Un caso conserva su contenido hasta que se fusiona una solicitud para él.

Los casos sincronizados desde Git no se revisan aquí. El pull request que cambia su archivo `.feature` es su revisión, así que su escenario es de solo lectura en Probara. Consulta [Sincronizar archivos .feature desde Git](https://docs.probara.net/es/guides/syncing-feature-files-from-git/).

## Enviar un caso a revisión

1. Completa el caso o haz tus cambios en uno existente.
2. Haz clic en **Enviar a revisión**.
3. Elige los revisores. La lista empieza con los revisores predeterminados del proyecto; nunca eres
   revisor de tu propia solicitud.
4. Haz clic en **Enviar a revisión** en el diálogo.

La solicitud recibe un ID como `RV-3`, que aparece en la confirmación, y se abre su página. Un caso
nuevo todavía no aparece en el repositorio y un caso existente conserva su contenido actual: los cambios propuestos se
aplican cuando se fusiona la solicitud.

Las imágenes que añadas a los pasos viajan con la solicitud y se conservan mientras siga abierta.

## Pedir la revisión de casos tal como están

También puedes pedir a los revisores que aprueben casos que no quieres cambiar, por ejemplo para
aprobar casos escritos antes de activar la revisión:

- En el repositorio, selecciona casos y haz clic en **Enviar a revisión** en la barra de selección.
- En el panel de detalle de un caso, haz clic en el botón **Solicitar revisión**. Aparece en los
  casos cuyo estado de revisión es **Sin revisar**.

Elige los revisores una sola vez (la lista empieza con los revisores por defecto del proyecto) y haz
clic en **Enviar a revisión**. Cada caso recibe su propia solicitud, de tipo **Revisar versión
actual**. Su página muestra el caso tal como está en lugar de una lista de cambios. Fusionarla marca
el caso como **Aprobado** sin cambiar el caso ni añadir una versión a su historial. Si mientras tanto
alguien guarda el caso directamente, la solicitud no se puede fusionar hasta que se actualice su
propuesta.

Los casos que ya tienen una solicitud abierta y los casos archivados no se envían; la confirmación
los indica.

## Archivar y eliminar mediante revisión

Archivar y eliminar un caso de prueba también pueden pasar por revisión:

- Cuando la revisión es obligatoria, **Archivar** en el panel de un caso y **Eliminar** en la barra
  de selección del repositorio envían el archivado a revisión: cada caso recibe una solicitud
  **Archivar caso** con los revisores por defecto del proyecto y sigue activo, **En revisión**,
  hasta que se fusiona la solicitud. Eliminar un caso desde la API o el servidor MCP abre una
  solicitud **Eliminar caso**.
- Cuando la revisión es opcional, el panel de un caso también ofrece **Enviar archivado a revisión**
  junto a **Archivar**: elige los revisores y el archivado espera su aprobación.

Una solicitud **Archivar caso** o **Eliminar caso** no tiene cambios que comparar: su página nombra el
caso y lo muestra tal como está ahora. No se puede editar. Fusionarla archiva o elimina
definitivamente el caso; rechazarla deja el caso como estaba. Si el caso se guardó, o se archivó,
después de crear la solicitud, no se puede fusionar: recházala y envíala de nuevo.

## Una solicitud abierta por caso

Un caso de prueba solo puede tener una solicitud de revisión abierta a la vez. Enviar otro cambio para
el mismo caso se rechaza con un mensaje que indica la solicitud abierta: envía tu cambio cuando esa
solicitud se fusione o se rechace.

Si alguien guardó el caso después de que abrieras el formulario, el envío a revisión se rechaza igual
que un guardado: vuelve a cargar el caso y haz tu cambio sobre su versión actual.

## La sección Revisión

La barra lateral del proyecto siempre muestra **Revisión** en **Casos**. Con la revisión activada,
al lado aparece el número de solicitudes pendientes de tu revisión. Si tu plan no incluye la
revisión de casos, **Revisión** muestra los planes que la incluyen. Si la revisión está desactivada
en el proyecto, la sección lo indica y enlaza a la configuración de **Repositorio**; las solicitudes
abiertas antes de desactivarla siguen en la lista y todavía se pueden decidir. La sección lista las solicitudes de revisión del
proyecto en cuatro pestañas: **Abierta**, **Asignadas a mí**, **Fusionada** y **Rechazada**. Cada
solicitud muestra su ID, su título y su tipo (**Caso nuevo**, **Cambio**, **Revisar versión
actual**, **Archivar caso** o **Eliminar caso**), el caso que cambia, su autor, sus revisores (pasa el cursor sobre un avatar para ver quién es; abre la solicitud para ver sus decisiones), y sus aprobaciones frente a
las necesarias. Usa **Agregar filtro** para ver solo las solicitudes de un **Autor**, con un
**Revisor** o de un **Tipo**. El tipo **Cambio** también incluye las solicitudes **Revisar versión
actual**.

### Asignadas a mí

**Asignadas a mí** lista las solicitudes abiertas en las que eres revisor y que esperan tu decisión:
las que aún no aprobaste ni en las que pediste cambios, y aquellas cuya propuesta se editó después de
tu decisión. La columna **Mi decisión** muestra tu postura en cada una. Activa **Incluir las
solicitudes que ya decidí** para ver también las solicitudes abiertas que ya aprobaste o en las que
pediste cambios.

Haz clic en una solicitud para abrirla. Su página muestra los cambios propuestos frente al caso tal
como está ahora (en un caso nuevo, el caso propuesto completo), los revisores con sus decisiones y
notas, cuántas aprobaciones tiene y sus comentarios. Cualquiera que pueda abrir el proyecto puede
ver las solicitudes de revisión.

**Rechazar** y **Editar** están arriba de la página. **Fusionar**, **Aprobar** y **Pedir cambios**
están en el panel junto a los cambios, encima de los revisores.

## Revisar una solicitud

Lo que puedes hacer en una solicitud depende de quién eres:

| Eres                                                       | Acciones                                                               |
| ---------------------------------------------------------- | ---------------------------------------------------------------------- |
| Un miembro que puede revisar casos de prueba (no el autor) | **Fusionar**, **Aprobar**, **Pedir cambios**, **Editar**, **Rechazar** |
| El autor, con **Permitir que el autor fusione** activado   | **Fusionar**, **Editar**, **Rechazar**                                 |
| El autor                                                   | **Editar**, **Rechazar**                                               |

**Editar** no aparece en una solicitud **Archivar caso** o **Eliminar caso**.

- **Aprobar** indica que estás de acuerdo con los cambios. No hace falta que seas un revisor asignado:
  aprobar o pedir cambios te añade como revisor.
- **Quitar aprobación** reemplaza a **Aprobar** cuando ya aprobaste la propuesta actual. Retira tu
  aprobación, así una aprobación dada por error deja de contar, sin tener que pedir cambios.
- **Pedir cambios** indica que quieres más cambios antes de fusionar la solicitud. Puedes añadir una
  nota, que se muestra con tu decisión. Las notas admiten formato e imágenes.
- **Editar** abre el formulario del caso con los cambios propuestos, para que los cambies tú. Al
  guardar se reemplaza la propuesta.
- **Rechazar** descarta la solicitud después de que lo confirmes. El caso queda como estaba y los
  cambios propuestos, con las imágenes que añadieron, se descartan. Una solicitud rechazada no se
  puede reabrir.
- **Fusionar** aplica los cambios al repositorio: se crea el caso nuevo o se actualiza el caso.

Mientras una solicitud está abierta, su autor y cualquier miembro que pueda revisar casos de prueba
pueden cambiar quién la revisa: haz clic en **Editar revisores**, junto a **Revisores**. Los revisores
nuevos reciben una notificación; un revisor que quitas pierde su decisión.

**Fusionar** está disponible cuando la solicitud tiene las aprobaciones que exige el proyecto, o desde
el principio si el proyecto no exige ninguna. Hasta entonces el botón está desactivado y debajo se
indica por qué. Tu propia aprobación nunca cuenta en una solicitud que enviaste tú.

Un caso actualizado por una fusión muestra esa versión como **Fusionada desde revisión** en su pestaña
**Historial**.

### Decidir sobre varias solicitudes a la vez

En las pestañas **Abierta** y **Asignadas a mí**, selecciona solicitudes con sus casillas y elige
**Aprobar**, **Pedir cambios** o **Rechazar** en la parte inferior de la página. Para pedir cambios o
rechazar hace falta un comentario: se muestra en cada solicitud seleccionada, junto con tu decisión o
como motivo del rechazo. Cada solicitud se trata como si actuaras solo sobre ella: las solicitudes en
las que no puedes actuar, como las tuyas, se omiten y se indican en la confirmación, y una aprobación
puede fusionar una solicitud cuando la **Fusión automática** está activada.

Al rechazar una sola solicitud también puedes añadir una nota; se muestra en la solicitud.

### Editar reinicia las aprobaciones

Las aprobaciones y las peticiones de cambios pertenecen a la versión de la propuesta sobre la que se
dieron. Cuando alguien edita la propuesta, las decisiones anteriores siguen a la vista como
**Desactualizada** pero ya no cuentan: la solicitud necesita sus aprobaciones de nuevo.

### Cuando el caso cambia mientras tanto

Si alguien guarda el caso después de crear la solicitud, la solicitud muestra un aviso y **Fusionar**
queda bloqueado, para que la fusión nunca sobrescriba cambios que los revisores no vieron. Haz clic en
**Editar** y guarda la propuesta: pasa a estar hecha sobre el caso tal como está ahora, y se puede
volver a revisar y fusionar.

### Fusión automática

Con la **Fusión automática** activada, la aprobación que lleva una solicitud a las aprobaciones
necesarias la fusiona en el momento, siempre que ningún revisor haya pedido cambios sobre la propuesta
actual. Si la fusión no puede hacerse, por ejemplo porque el caso cambió mientras tanto, la solicitud
sigue abierta con la aprobación. Si la fusión falla por otro motivo, la aprobación queda registrada
igualmente y te avisamos de que la fusión automática falló; vuelve a fusionar la solicitud desde su
página.

### Desactivar la revisión

Desactivar **Revisión activada** impide enviar solicitudes nuevas, pero las abiertas se conservan: se
pueden seguir revisando, fusionando o rechazando desde la sección **Revisión**.

## Estado de revisión

Cada caso de prueba tiene un estado de revisión, que aparece como una etiqueta en la cabecera del
caso y como un icono en su fila del repositorio mientras la revisión está activada en el proyecto:

| Estado          | Significado                                                              |
| --------------- | ------------------------------------------------------------------------ |
| **Sin revisar** | El caso nunca pasó por una revisión, o se cambió directamente después.   |
| **En revisión** | Hay una solicitud de revisión abierta para el caso.                      |
| **Aprobado**    | El contenido actual del caso se fusionó desde una solicitud de revisión. |

El estado cambia solo:

- Un caso que creas directamente queda **Sin revisar**; un caso creado al fusionar una solicitud de
  **Caso nuevo** queda **Aprobado**.
- Enviar un cambio a revisión deja el caso **En revisión**; fusionarlo lo deja **Aprobado**.
- Rechazar una solicitud devuelve el caso al estado que tenía antes de enviarse a revisión.
- Guardar el caso directamente con cambios, restaurar una versión anterior desde su **Historial** o
  importar encima de él lo deja de nuevo **Sin revisar**. Guardarlo sin cambiar nada mantiene su
  estado. Una copia hecha con **Duplicar** empieza **Sin revisar**.
- Fusionar una solicitud **Archivar caso** archiva el caso y conserva el estado que tenía antes de la
  solicitud.

Para encontrar casos por estado, añade el filtro **Estado de revisión** en la barra de filtros del
repositorio, o usa el campo `reviewStatus` en una [consulta](https://docs.probara.net/es/guides/pql-reference/).

## Solo casos aprobados en las ejecuciones

Con **Solo los casos aprobados pueden añadirse a ejecuciones** activada, una ejecución solo admite
casos de prueba con el estado de revisión **Aprobado**:

- Los casos que eliges tú, en el diálogo **Nueva ejecución** o al añadir casos a una ejecución, deben
  estar todos aprobados. El selector de casos muestra solo los casos aprobados, y el diálogo señala
  cualquier caso seleccionado sin aprobar para que puedas quitarlo.
- Cuando una ejecución toma los casos de un plan de pruebas o de la ejecución que repites, los casos
  sin aprobar quedan fuera y se te indica cuántos.

La opción solo tiene efecto mientras **Revisión activada** está activada. Los resultados que
envían las herramientas de CI no se ven afectados: registran pruebas que ya se ejecutaron.

## Comentarios en una solicitud

Debajo de los cambios propuestos, cada solicitud tiene un hilo de **Comentarios** que funciona como
los comentarios de un caso de prueba: escribe, responde, fija un comentario y
escribe **@** para mencionar a alguien. Cualquiera que pueda abrir el proyecto puede leer los
comentarios; los miembros y roles superiores pueden escribirlos. El hilo sigue abierto después de
fusionar o rechazar la solicitud, para que la conversación detrás de un cambio se quede con él.

## Cuando se elimina un caso de prueba

Eliminar un caso de prueba conserva sus solicitudes de revisión y sus comentarios. Su solicitud
abierta, si la tiene, se rechaza automáticamente, muestra **Rechazada porque se eliminó su caso de
prueba** y se avisa a sus participantes. Cada solicitud sobre el caso lo sigue nombrando, como **Caso eliminado** seguido
del ID y el título del caso.

## Notificaciones de revisión

Las solicitudes de revisión avisan a las personas involucradas desde el grupo **Revisión** de tus
[preferencias de notificaciones](https://docs.probara.net/es/guides/notifications/):

| Preferencia                                    | Te avisamos cuando                                                                                                    |
| ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| Revisiones de pruebas que me asignaron         | Te nombran revisor de una solicitud, al enviarla (incluidos los revisores predeterminados) o al cambiar sus revisores |
| Decisiones en revisiones en las que participo  | Alguien aprueba, pide cambios, rechaza o fusiona la solicitud, incluida una fusión automática                         |
| Ediciones de revisiones en las que participo   | Alguien edita la propuesta                                                                                            |
| Comentarios en revisiones en las que participo | Alguien comenta en la solicitud                                                                                       |
| Nueva mención en un comentario                 | Un comentario de una solicitud te menciona, o la edición de un comentario te añade                                    |

Participas en una solicitud cuando eres su autor, uno de sus revisores (aprobar o pedir cambios te
convierte en uno) o has comentado en ella.

Las acciones masivas envían un solo aviso para todo el lote en lugar de uno por solicitud: enviar
varios casos a revisión le dice a cada revisor a cuántas revisiones lo asignaron, y abre **Asignadas
a mí**; decidir sobre varias solicitudes a la vez le dice a cada participante, por ejemplo, que Ana
aprobó 12 solicitudes de revisión, y abre la lista de Revisión. Las acciones sobre una sola solicitud
mantienen su propio aviso. Cuando un comentario te menciona, recibes solo la mención,
no también el aviso del comentario. Nunca te avisamos de tus propias acciones, y solo de proyectos que
todavía puedes abrir.

Por defecto, las filas de asignación, decisión y mención te llegan en la app y por correo; las
ediciones y los comentarios, solo en la app.
