Casos de prueba parametrizados

Un caso parametrizado se ejecuta una vez por cada combinación de los valores de sus parámetros. Un caso con Sitio (EU, US, APAC) y Navegador (Chrome, Firefox, Safari) crea 9 casos de ejecución en una ejecución. Si añades al mismo caso un grupo de 2 filas, crea 18. Cada caso de ejecución tiene sus propios valores, estado, intentos, notas y adjuntos.

Ruta rápida

Abre el caso en el editor y ve a Parámetros. Elige Añadir parámetro simple, Añadir grupo o Añadir parámetro compartido.
Escribe ${nombre} donde vaya un valor: en el título, en una descripción, en una condición o en un paso. Los casos Gherkin también pueden escribir <nombre>.
Elige Revisar combinaciones debajo de los parámetros para ver cuántas combinaciones genera el caso. Desmarca la casilla de cada combinación que no deba ejecutarse.
Guarda el caso. Una ejecución que lo incluya crea un caso de ejecución por cada combinación que quede.

Para cambiar los parámetros de un caso más adelante, ábrelo, selecciona Editar en su sección Parámetros, haz los cambios y selecciona Guardar. Cancelar, o salir del caso con cambios sin guardar, los descarta.

Parámetros simples y grupos

Un parámetro simple tiene un nombre y una lista de valores. Un grupo tiene una etiqueta y columnas. Cada fila de un grupo contiene un valor por columna, y los valores de una fila se usan juntos. Usa un grupo cuando varios valores deben cambiar a la vez, como una condición de red formada por VPN, cookies y HTTPS.

Tipo	Qué contiene	Ejemplo
Simple	Un nombre y de 1 a 100 valores	`Sitio`: EU, US, APAC
Grupo	Una etiqueta, de 2 a 20 columnas y de 1 a 1.024 filas	`Red`, columnas VPN y Cookies, filas `activa` / `habilitadas` y `inactiva` / `deshabilitadas`
Compartido	Una referencia a un parámetro compartido, simple o grupo (ver abajo)	`Navegador`, de la biblioteca de la organización

Las reglas para nombres y etiquetas son estas:

Un nombre de parámetro tiene de 1 a 50 caracteres y puede escribirse como una pregunta, por ejemplo ¿Usa HTTPS?. No puede contener {, }, <, >, $ ni |. Los espacios al inicio y al final se quitan al guardar.
Los nombres distinguen mayúsculas de minúsculas: Sitio y sitio son dos parámetros. Un nombre es único dentro del caso, entre parámetros simples y columnas de grupo.
Una etiqueta de grupo tiene de 1 a 50 caracteres y no puede empezar ni terminar con un espacio.
Un valor tiene hasta 500 caracteres. Un valor simple no puede estar en blanco, y un mismo valor no puede repetirse dentro de un parámetro simple. Una celda de grupo puede estar vacía. Una misma fila no puede repetirse dentro de un grupo.

En el editor, el nombre de un parámetro se escribe sin llaves (Navegador). Las llaves van en el marcador de un paso (${Navegador}).

Arrastra el asa de un parámetro, de un valor simple o de una fila de grupo para moverlo, o enfoca el asa y pulsa las flechas. Cada columna de un grupo también se mueve por su cuenta: al mover uno de sus valores cambia qué valores comparten fila, así que las filas del grupo quedan emparejadas de otra forma. Quita una columna de grupo con la × de su encabezado. La × aparece solo mientras el grupo tenga más de dos columnas.

Cuántas combinaciones genera un caso

Probara multiplica el número de valores de cada parámetro simple por el número de filas de cada grupo. Un grupo cuenta una sola vez, por su número de filas, sin importar cuántas columnas tenga. El resumen del editor muestra el mismo producto como fórmula, por ejemplo 3 × 3 = 9 combinaciones, y añade el número de combinaciones excluidas cuando hay alguna.

3 sitios × 3 navegadores = 9 combinaciones.
Los mismos dos parámetros simples más un grupo de 2 filas: 9 × 2 = 18 combinaciones.
Un caso sin parámetros tiene una sola combinación.

Límite	Valor
Nombres de parámetro en un caso, incluidos los de los parámetros compartidos	20
Longitud de un nombre o de una etiqueta de grupo	50 caracteres
Longitud de un valor o de una celda de grupo	500 caracteres
Valores en un parámetro simple	100
Columnas en un grupo	De 2 a 20
Filas en un grupo	1.024
Combinaciones en un caso, antes de las exclusiones	1.024
Casos de ejecución en una ejecución, contando cada combinación	5.000

Probara rechaza un guardado que supere un límite del caso e indica el número que alcanzó. También rechaza crear una ejecución, o añadir casos a una ejecución, que tendría más de 5.000 casos de ejecución. El mensaje indica el total que alcanzaría la ejecución.

Parámetros compartidos

Un parámetro compartido es un parámetro simple o un grupo que defines una sola vez y usas en muchos casos. Al crearlo con Nuevo parámetro compartido, Disponible en define su alcance:

Este proyecto: el parámetro pertenece a un solo proyecto.
Organización: el parámetro está disponible en todos los proyectos. Desmarca Habilitar para todos los proyectos para elegir los proyectos que pueden usarlo.

Encuentra la biblioteca en Parámetros compartidos, en la barra lateral, junto a Pasos compartidos. Muestra cada parámetro con su tipo, una vista previa de sus valores, su alcance y cuántos casos lo usan. Selecciona un nombre para abrir la página del parámetro.

Para usar uno en un caso, elige Añadir parámetro compartido en el editor del caso. Escribe en la búsqueda para filtrar la lista por nombre y elige un parámetro con el ratón o con las flechas e Intro desde la búsqueda: la vista previa junto a la lista muestra sus valores, o las filas de un grupo. Elige Añadir parámetro para añadirlo.

En esa página, Editar valores convierte los valores en campos; Guardar valores conserva los cambios y Cancelar los descarta. Edita los valores igual que en un caso: pulsa Intro en el campo del valor para añadir un valor, y mueve un valor, una fila o los valores de una columna arrastrando su controlador, o enfocándolo y pulsando las flechas. Una columna de grupo se quita con su × mientras el grupo tenga más de dos columnas. Para cambiar el nombre, elige Renombrar en el menú de la página o en el menú de la fila en la biblioteca.

Quién puede cambiar qué:

Un parámetro de proyecto necesita el permiso para editar casos de prueba.
Un parámetro de organización necesita el permiso que gestiona los pasos compartidos de la organización y el plan que incluye los pasos compartidos de la organización. Consulta Pasos compartidos.
En un plan que ha perdido ese derecho, los casos que ya usan un parámetro de organización lo conservan. Crear o editar uno, y añadirlo a un caso que todavía no lo usa, requiere un plan de pago. Eliminar un parámetro nunca lo bloquea el plan.

Editar un parámetro compartido cambia todos los casos que lo usan. Cada uno de esos casos recibe una nueva versión, y sus combinaciones excluidas que ya no coinciden con ninguna combinación se descartan. Las ejecuciones no cambian: cada caso de ejecución conserva los valores con los que se creó hasta que apliques la última versión (consulta Ejecuciones).

La pestaña Usado en lista los proyectos cuyos casos usan el parámetro, con cuántos casos hay en cada uno.

Al eliminar un parámetro compartido se pregunta qué pasa con esos casos:

Convertir en copias locales: cada caso conserva su propia copia de los valores.
Quitar de todos los casos: los valores salen de todos los casos que usan el parámetro.

En un caso, Crear copia local convierte una referencia compartida en la copia propia de ese caso. El parámetro compartido y los demás casos no cambian.

Restaurar una versión anterior de un caso cuyo parámetro compartido se eliminó añade los valores de ese parámetro al caso como parámetros normales, y la restauración muestra un mensaje con el nombre del parámetro.

Marcadores

Un marcador lee el valor de un parámetro para la combinación que representa un caso de ejecución.

${nombre} funciona en el título, la descripción, las precondiciones, las postcondiciones y en cada campo de paso: acción, datos y resultado esperado. También funciona en los pasos que vienen de un paso compartido.
Los casos Gherkin leen además <nombre>, que es la sintaxis propia de Cucumber. Funciona en los mismos campos, incluidas las Data Tables y los Doc Strings.
Si el caso no tiene un parámetro con ese nombre, Probara lee el grupo de configuración de la ejecución con ese nombre. Si existen los dos, gana el parámetro.
Un marcador sin valor se queda tal como está. El editor lo avisa y lo nombra.

Para un caso titulado Inicia sesión en ${Sitio} con ${Navegador}, el caso de ejecución de EU y Chrome se titula Inicia sesión en EU con Chrome.

Combinaciones excluidas

Algunas combinaciones nunca deben ejecutarse. Elige Revisar combinaciones debajo de los parámetros y desmarca la casilla de una combinación para excluirla. Vuelve a marcarla para incluirla de nuevo. Una combinación excluida no crea ningún caso de ejecución.

Un caso conserva al menos una combinación. Probara rechaza un guardado que las excluya todas.
Cuando cambias o mueves un valor, renombras un parámetro o eliminas uno, las exclusiones que ya no coinciden con ninguna combinación se descartan al guardar.
Para dejar una combinación fuera de una sola ejecución, quita ese caso de ejecución de la ejecución. El caso no cambia.

Configuraciones y parámetros

Las configuraciones y los parámetros multiplican el trabajo, en niveles distintos:

	Configuraciones	Parámetros
Qué describen	Dónde se ejecuta toda la ejecución: navegador, sistema operativo o dispositivo	Los datos que usa un caso
Qué multiplican	Ejecuciones: una por cada combinación de valores de configuración	Casos de ejecución dentro de una ejecución: uno por cada combinación de parámetros
Dónde se definen	En las configuraciones del plan de pruebas	En el caso

Un plan con 4 combinaciones de configuración y un caso con 3 combinaciones crea 4 ejecuciones, y cada una contiene 3 casos de ejecución de ese caso. Usa una configuración cuando el entorno cambie lo que significa la prueba. Usa un parámetro cuando los datos cambien lo que comprueba el caso. Un valor de grupo de configuración también rellena un marcador que el caso no tenga como parámetro.

Ejecuciones

Crear una ejecución. En la selección de casos, un caso parametrizado muestra × N junto a su nombre, donde N es su número de combinaciones. La selección muestra el total de casos de ejecución que creará.

La lista de la ejecución. Una ejecución tiene una fila por cada caso de ejecución. Cada fila muestra sus valores junto al título, por ejemplo Browser: Chrome · Site: EU; cuando no caben, pasa el cursor sobre el contador +N o enfócalo para verlos todos. La búsqueda encuentra el título del caso y el nombre y el valor de sus parámetros, sin distinguir mayúsculas de minúsculas.

El panel del caso de ejecución. Abre un caso de ejecución para ver sus pestañas:

Ejecución empieza con una sección Combinación que lista los valores con los que se ejecuta ese caso de ejecución, y luego muestra sus pasos, con los valores ya sustituidos.
Reintentos lista sus intentos. Elige Solo los mismos valores para mostrar solo los intentos que se ejecutaron con los mismos valores.
Combinaciones lista los demás casos de ejecución del mismo caso en esa ejecución, con su estado y sus valores.

Aplicar la última versión. Cuando un caso cambia después de entrar en una ejecución, la ejecución muestra Caso actualizado. Aplicar la última versión actualiza ese caso de ejecución a la última versión del caso, si su combinación todavía existe. Probara rechaza la actualización en dos casos:

La combinación ya no existe en la última versión: “La combinación de este caso de ejecución ya no existe en la última versión del caso. Quita el caso de ejecución o vuelve a agregar el caso a la ejecución para obtener sus combinaciones actuales.”
El intento actual ya tiene resultados de pasos. Sus pasos se mantienen como se ejecutaron, y reintentar el caso inicia un nuevo intento.

Aplicar la última versión a todos los casos pendientes actualiza todos los casos que puede y nombra los que omite: los que ya tienen resultados de pasos, los asignados a otra persona y los que perdieron su combinación.

Volver a añadir un caso. Añadir un caso que ya está en una ejecución crea los casos de ejecución de las combinaciones que la ejecución todavía no tiene. Los intentos de los casos de ejecución que quitaste no se asocian a los nuevos.

Resultados. Cada caso de ejecución tiene sus propios intentos, notas y adjuntos. El estado de un caso en una ejecución es el peor de sus casos de ejecución, en este orden: Fallido, Bloqueado, Reintentar, Sin probar, Omitido y Aprobado. La matriz de cobertura, el último resultado del caso, los paneles de Jira y de defectos, y el progreso de un plan de pruebas usan ese estado. El progreso de una ejecución cuenta casos de ejecución.

Importación, exportación y Gherkin

Los archivos CSV, XLSX, JSON y XML incluyen parámetros y combinaciones excluidas. Un archivo .feature incluye los parámetros de un Scenario Outline como su tabla Examples. Consulta Importar casos de prueba, el recorrido de importación CSV y Casos de prueba Gherkin.

Versiones y actividad

Los parámetros y las combinaciones excluidas forman parte de la versión de un caso. El historial de versiones y la comparación de versiones muestran los parámetros añadidos, eliminados y renombrados, los valores y filas cambiados, un nuevo orden y las exclusiones modificadas. El registro de actividad muestra un cambio hecho a través de un parámetro compartido como hecho mediante ese parámetro.

API, CI y MCP

La API lee y escribe parameters y excludedCombinations en los casos de prueba, y lista las combinaciones de un caso en GET /api/v1/projects/{projectId}/test-cases/{caseUlid}/combinations. Consulta la referencia de la API.
Los informes de CI envían los parámetros de cada resultado. Los nombres que el caso declara eligen el caso de ejecución con esos valores, y Probara añade un caso de ejecución que falte. Un nombre que el caso no declara se queda en el resultado para mostrarlo. Los reporters marcan sus propios valores, como el proyecto, el navegador o el intento de reintento, como contexto: se muestran en el resultado y nunca crean un parámetro. Consulta Integraciones de CI.
MCP: un identificador visible de caso de prueba para un caso con varios casos de ejecución en una misma ejecución se rechaza, y el rechazo lista hasta 25 de ellos, salvo que la llamada nombre uno mediante sus parameters o su ULID de caso de ejecución. Consulta la referencia de herramientas MCP.