conjuntos de pruebas de uip tm

Sintaxis y opciones para `conjuntos de pruebas uip tm`, que gestiona las unidades ejecutables del conjunto de pruebas que producen ejecuciones rastreadas en Test Manager.

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 iniciados como un solo comando y rastreados 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> [--filter <text>]
uip tm testsets update --project-key <key> --test-set-key <key> [--name <name>] [--description <text>]
uip tm testsets delete --project-key <key> --test-set-key <key> [-y]
uip tm testsets list-testcases --project-key <key> --test-set-key <key> [--limit <n>] [--offset <n>]
uip tm testsets run --test-set-key <key> [--execution-type <type>] [--input-path <file>] [--playwright-projects <names...>] [--wait [--timeout <seconds>] [--poll-interval <seconds>]]
uip tm testsets playwright-context --test-set-key <key>

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

creación de conjuntos de pruebas de uip tm

Crea un conjunto de pruebas vacío en un proyecto.

Argumentos

Nada.

Opciones

Marca	Descripción
--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.

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Obligatorio. Proyecto a lista.
--folder-key <uuid>	Filter by Orchestrator folder key (from uip or folders list).
--filter <text>	Búsqueda del lado del servidor sobre el nombre.
--include-last-execution	Add the latest execution's status and timestamp to each test set (see LastExecutionStatus/LastExecutionAt below). Costs one extra lookup per test set.

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 is the internal UUID — needed by executions list --test-set-id. With --include-last-execution, each entry also gets LastExecutionStatus and LastExecutionAt (both empty strings if the test set has never run).

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

Marca	Descripción
--project-key <key>	Obligatorio. Proyecto propietario.
--test-set-key <key>	Obligatorio. Clave del conjunto de pruebas (por ejemplo, DEMO:10).
--name <name>	Nuevo nombre.
--description <text>	Nueva descripción.

Ejemplo

uip tm testsets update \
  --project-key DEMO \
  --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

Marca	Descripción
--project-key <key>	Obligatorio. Proyecto propietario.
--test-set-key <key>	Obligatorio. Clave del conjunto de pruebas (por ejemplo, DEMO:10).
-y, --yes	Omite la solicitud de confirmación. Necesario en entornos no interactivos.

Ejemplo

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

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

Marca	Descripción
--project-key <key>	Obligatorio. Proyecto propietario.
--test-set-key <key>	Obligatorio. Conjunto de pruebas para inspeccionar.
--limit <n>	Número máximo de resultados por página. El valor predeterminado es 50.
--offset <n>	Número de resultados que se omitirán. El valor predeterminado es 0.

Ejemplo

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

Forma de datos

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

conjuntos de pruebas de uip tm ejecutados

Ejecuta un conjunto de pruebas y devuelve su ExecutionId. De forma predeterminada, el comando se devuelve tan pronto como la ejecución se pone en cola. Pasa --wait para bloquear hasta que la ejecución alcance un estado terminal: esto combina los pasos de lanzamiento y espera en un solo comando.

Argumentos

Nada.

Opciones

Marca	Descripción
--test-set-key <key>	Obligatorio. Clave de objeto del conjunto de pruebas (por ejemplo, DEMO:42). La clave del proyecto se deriva del prefijo.
--execution-type <type>	Tipo de casos de prueba a ejecutar: automated (predeterminado), manual, mixed (tanto automatizado como manual) o none (sin filtro de tipo).
--input-path <file>	Ruta a un archivo JSON que contiene anulaciones de parámetros para la ejecución. Formato: [{"name":"Param","type":"String","value":"v"}].
--playwright-projects <names...>	Scope the run to one or more Playwright projects packaged by uip tm pack (space-separated, for example, regression smoke). The selection persists on the test set, so later runs of the same test set don't need to repeat it.
--wait	Bloquear hasta que la ejecución alcance un estado terminal (finished, cancelled). Cuando se omite, el comando vuelve inmediatamente después de la cola.
--timeout <seconds>	Máximo de segundos de espera para que finalice la ejecución (0 sin tiempo de espera). Requiere --wait.
--poll-interval <seconds>	Segundos entre comprobaciones de estado mientras se espera. Requiere --wait.

Nota:

--playwright-projects is a hidden option (omitted from --help) — it exists and works, but the flag surface may change before the underlying Test Manager Playwright execution capability is generally announced. It only applies to a test set whose test cases all come from a single Playwright package; on any other test set the run proceeds using the package's playwright.config defaults and the flag is effectively ignored.

Ejemplos

# Fire-and-forget — returns ExecutionId immediately
uip tm testsets run --test-set-key DEMO:10

# Block until done — no need for a separate uip tm wait call
uip tm testsets run \
  --test-set-key DEMO:10 \
  --wait

# Block with a timeout and custom poll interval
uip tm testsets run \
  --test-set-key DEMO:10 \
  --execution-type automated \
  --wait \
  --timeout 900 \
  --poll-interval 15

# Pass parameter overrides from a file
uip tm testsets run \
  --test-set-key DEMO:10 \
  --input-path ./params.json \
  --wait

# Scope a run to specific Playwright projects (hidden option, see note above)
uip tm testsets run \
  --test-set-key DEMO:10 \
  --playwright-projects regression smoke

Forma de datos

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

Nota:

Cuando se utiliza --wait, Status refleja el estado del terminal (Finished, Cancelled) en lugar de Running. El ExecutionId devuelto es el mismo en ambos casos y se puede pasar a uip tm report get, uip tm result download y uip tm attachment download.

uip tm testsets playwright-context

Probe a test set's Playwright resolution: whether every test case in it comes from a single Playwright package, and which Playwright project names are available and currently selected. Hidden from --help (same maturity gate as run's --playwright-projects), but real and functional — use it to discover the valid --playwright-projects names before calling run, exactly as run's own option text points back here.

Argumentos

Nada.

Opciones

Marca	Descripción
--test-set-key <key>	Required. Test set object key (e.g. DEMO:42).
--log-level <level>	Default Information.

Ejemplo

uip tm testsets playwright-context --test-set-key DEMO:42

Forma de datos

{
  "Code": "TestSetPlaywrightContext",
  "Data": {
    "TestSetKey": "DEMO:42",
    "IsPlaywright": true,
    "PackageIdentifier": "my-playwright-suite",
    "Version": "1.2.0",
    "AvailablePlaywrightProjects": "chromium, firefox, webkit",
    "SelectedPlaywrightProjects": "chromium"
  }
}

When the test set isn't a single-package Playwright set (RPA, mixed, manual, or no single package), IsPlaywright is false and the response instead carries one Details field: "Not a Playwright test set (RPA, mixed, manual, or no single package). Run it without --playwright-projects." — the four Playwright-specific fields above are omitted in that case. AvailablePlaywrightProjects/SelectedPlaywrightProjects are comma-joined strings, not arrays.

Relacionado

• pack : empaqueta un proyecto de Playwright y produce los nombres de ámbito --playwright-projects utilizados anteriormente.
• 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