conjuntos de pruebas de uip tm

uip tm testsets gestiona conjuntos de pruebas: la unidad ejecutable en Test Manager. Un conjunto de pruebas es un grupo ordenado de casos de prueba que puedes ejecutar con un comando y realizar un seguimiento como una sola ejecución. Cada llamada testsets run devuelve un ExecutionId que los otros verbos uip tm (wait, executions, report, result, attachment) toman como entrada.

Sinopsis

uip tm testsets create --project-key <key> --name <name> [--description <text>]
uip tm testsets list --project-key <key> [--folder-key <uuid>] [--filter <text>]
uip tm testsets update --test-set-key <key> [--name <name>] [--description <text>]
uip tm testsets delete --test-set-key <key>
uip tm testsets list-testcases --test-set-key <key>
uip tm testsets run --test-set-key <key> [--execution-type <type>] [--input-path <file>]

Todos los verbos respetan las opciones globales y los códigos de salida estándar. Cada verbo acepta -t, --tenant <name> y --log-level <level> (predeterminado Information).

Los verbos del conjunto de pruebas que toman --test-set-key derivan el proyecto propietario del prefijo de la clave (por ejemplo DEMO:10 → proyecto DEMO), por lo que --project-key solo es necesario en create y list.

creación de conjuntos de pruebas de uip tm

Crea un conjunto de pruebas vacío en un proyecto. Usa testcases add después para rellenarlo.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --name <name> (obligatorio) : nombre del conjunto de pruebas.
• --description <text> — descripción de forma libre. El valor predeterminado es vacío.

Ejemplo

uip tm testsets create \
  --project-key DEMO \
  --name "Smoke Suite" \
  --description "Core smoke tests"

Forma de datos

{
  "Code": "TestSetCreate",
  "Data": {
    "TestSetKey": "DEMO:10",
    "Name": "Smoke Suite",
    "Description": "Core smoke tests"
  }
}

lista de conjuntos de pruebas de uip tm

Enumerar conjuntos de pruebas en un proyecto. La CLI pagina los resultados automáticamente.

Argumentos

Nada.

Opciones

• --project-key <key> (requerido) — proyecto a listar.
• --folder-key <uuid> : restringir a los conjuntos de pruebas vinculados a esta carpeta de Orchestrator. Aplicado en el lado del cliente después de obtener.
• --filter <text> : búsqueda del lado del servidor sobre el nombre.

Ejemplo

uip tm testsets list --project-key DEMO --filter smoke

Forma de datos

{
  "Code": "TestSetsList",
  "Data": [
    {
      "TestSetKey": "DEMO:10",
      "Name": "Smoke Suite",
      "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001",
      "Id": "a1b2c3d4-0000-0000-0000-000000000010"
    }
  ]
}

Id es el UUID interno: necesario, por ejemplo, para execution list --test-set-id.

actualización de conjuntos de pruebas de uip tm

Cambia el nombre de un conjunto de pruebas o cambia su descripción. Se debe proporcionar al menos uno de --name o --description .

Argumentos

Nada.

Opciones

• --test-set-key <key> (obligatorio) : clave del conjunto de pruebas (p. ej. DEMO:10).
• --name <name> — nuevo nombre.
• --description <text> — nueva descripción.

Ejemplo

uip tm testsets update \
  --test-set-key DEMO:10 \
  --name "Smoke Suite (2026)"

Forma de datos

{
  "Code": "TestSetUpdate",
  "Data": {
    "TestSetKey": "DEMO:10",
    "Name": "Smoke Suite (2026)",
    "Description": "Core smoke tests",
    "Result": "Updated"
  }
}

eliminación de conjuntos de pruebas de uip tm

Eliminar un conjunto de pruebas por su clave.

Argumentos

Nada.

Opciones

• --test-set-key <key> (obligatorio) : clave del conjunto de pruebas.

Ejemplo

uip tm testsets delete --test-set-key DEMO:10

Forma de datos

{
  "Code": "TestSetDelete",
  "Data": {
    "TestSetKey": "DEMO:10",
    "Id": "a1b2c3d4-0000-0000-0000-000000000010",
    "Result": "Deleted"
  }
}

uip tm conjuntos de pruebas lista-casos de prueba

Enumera los casos de prueba asignados a un conjunto de pruebas.

Argumentos

Nada.

Opciones

• --test-set-key <key> obligatorio) : conjunto de pruebas para inspeccionar.

Ejemplo

uip tm testsets list-testcases --test-set-key DEMO:10

Forma de datos

{
  "Code": "TestSetTestCasesList",
  "Data": [
    {
      "TestCaseKey": "DEMO:1",
      "Name": "Login smoke",
      "Version": "1.0.0",
      "Description": "Logs in and out"
    }
  ]
}

conjuntos de pruebas de uip tm ejecutados

Ejecuta un conjunto de pruebas y devuelve su ExecutionId inmediatamente. El propio conjunto de pruebas ya debe estar configurado con un paquete y una carpeta, ya sea mediante la creación dentro de la IU web de Test Manager o manualmente a través de la API REST. Ejecutar no bloquea; emparejarlo con uip tm wait en scripts.

Argumentos

Nada.

Opciones

• --test-set-key <key> (obligatorio) : conjunto de pruebas para ejecutar. La clave del proyecto se deriva del prefijo.
• --execution-type <type> : qué casos de prueba ejecutar. Uno de:
  • automated predeterminado) : solo casos de prueba automatizados.
  • manual : solo casos de prueba manuales.
  • mixed : tanto automatizados como manuales.
  • none — sin filtro de tipo.
• --input-path <file> — ruta a un archivo JSON de anulaciones de parámetros. El archivo debe contener una matriz con forma de [{"name":"Param","type":"String","value":"v"}]. Las anulaciones se comparan con las definiciones de parámetros actuales del conjunto de pruebas por name (y, cuando está presente, type), sin distinguir entre mayúsculas y minúsculas. Si el servidor no informa de definiciones de parámetros, las entradas se envían tal cual.

Ejemplos

# simplest
uip tm testsets run --test-set-key DEMO:10

# with parameter overrides and manual execution
uip tm testsets run \
  --test-set-key DEMO:10 \
  --execution-type mixed \
  --input-path ./params.json

Forma de datos

{
  "Code": "TestSetRun",
  "Data": {
    "ExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "TestSetKey": "DEMO:10",
    "Status": "Running",
    "StartTime": "2025-04-15T10:30:00Z"
  }
}

Nota:

El Status devuelto refleja el estado en el lanzamiento (normalmente Running); no significa que la ejecución se haya realizado correctamente. Para obtener el resultado de la ejecución, bloquea en uip tm wait y luego lee uip tm report get. El comportamiento del código de salida para el flujo combinado de lanzar y esperar se documenta en uip tm executions. Consulta la sección Relacionado a continuación para las referencias wait y report .

Relacionado

• casos de prueba : crea y vincula los casos de prueba que rellenan un conjunto de pruebas.
• ejecuciones : enumera y reintenta las ejecuciones una vez que se ha ejecutado un conjunto de pruebas.
• esperar : bloquea hasta que un ExecutionId devuelto alcanza un estado terminal.
• informe, resultado, archivo adjunto : artefactos posteriores a la ejecución.

Ver también

• Descripción general de Test Manager
• Patrones de scripting : patrones compatibles con CI para lanzar y verificar ejecuciones.