uip tm testsets

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.

uip tm testsets create

Create an empty test set in a project. Use testcases add afterwards to populate it.

Argumentos: ninguno.

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"
  }
}

uip tm testsets list

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

Argumentos: ninguno.

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.

uip tm testsets update

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

Argumentos: ninguno.

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"
  }
}

uip tm testsets delete

Eliminar un conjunto de pruebas por su clave.

Argumentos: ninguno.

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 testsets list-testcases

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

Argumentos: ninguno.

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"
    }
  ]
}

uip tm testsets run

Run a test set and return its ExecutionId immediately. The test set itself must already be configured with a package and folder — either by authoring inside Test Manager's web UI, or by hand via the REST API. Run does not block; pair it with uip tm wait in scripts.

Argumentos: ninguno.

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:

The returned Status reflects the state at launch (typically Running); it does not mean the run has succeeded. To get the run outcome, block on uip tm wait and then read uip tm report get. Exit-code behavior for the combined launch-and-wait flow is documented on uip tm executions. See the Related section below for the wait and report references.

Relacionado

• testcases — create and link the test cases that populate a test set.
• executions — list and retry executions once a test set has been run.
• 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.