Revisión de casos de prueba

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.

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	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 y el servidor 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.
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.

Enviar un caso a revisión

Completa el caso o haz tus cambios en uno existente.
Haz clic en Enviar a revisión.
Elige los revisores. La lista empieza con los revisores predeterminados del proyecto; nunca eres revisor de tu propia solicitud.
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.

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:

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.