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> | --project-id <id>) --name <name> [--description <text>]
uip tm testsets list (--project-key <key> | --project-id <id>) [--folder-key <uuid>] [--filter <text>] [--include-last-execution]
uip tm testsets update --test-set-key <key> [--name <name>] [--description <text>]
uip tm testsets delete --test-set-key <key> --yes
uip tm testsets list-testcases [--project-key <key> | --project-id <id>] --test-set-key <key>
uip tm testsets run --test-set-key <key> [--execution-type <type>] [--input-path <file>] [--playwright-project <name>] [--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).

Verbs that take --project-key and --project-id need one of them. When both are given, --project-id wins and --project-key is ignored. Verbs that take only --test-set-key derive the project from the key's prefix (DEMO:10 → project DEMO). list-testcases also falls back to that prefix when neither project option is given.

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>	Test Manager project key (for example, DEMO). Ignored if --project-id is also given.
--project-id <id>	Test Manager project ID. Use instead of --project-key, and wins if both are given.
--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>	Test Manager project key (for example, DEMO). Ignored if --project-id is also given.
--project-id <id>	Test Manager project ID. Use instead of --project-key, and wins if both are given.
--folder-key <uuid>	Filtrar por clave de carpeta de Orchestrator (de uip or folders list).
--filter <text>	Búsqueda del lado del servidor sobre el nombre.
--include-last-execution	Añade el estado y la marca de tiempo de la última ejecución a cada conjunto de pruebas (ver LastExecutionStatus/LastExecutionAt a continuación). Cuesta una búsqueda adicional por conjunto de pruebas.

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 para executions list --test-set-id. Con --include-last-execution, cada entrada también obtiene LastExecutionStatus y LastExecutionAt (ambas cadenas vacías si el conjunto de pruebas nunca se ha ejecutado).

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
--test-set-key <key>	Required. Test set key (for example, DEMO:10). The project is derived from the prefix.
--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

Marca	Descripción
--test-set-key <key>	Required. Test set key (for example, DEMO:10). The project is derived from the prefix.
-y, --yes	Required. Confirms the irreversible deletion. The CLI never prompts; without --yes, the command fails.

Ejemplo

uip tm testsets delete --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>	Test Manager project key (for example, DEMO). Ignored if --project-id is also given.
--project-id <id>	Test Manager project ID. Use instead of --project-key, and wins if both are given.
--test-set-key <key>	Obligatorio. Conjunto de pruebas para inspeccionar.

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",
      "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. 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-project <name>	Playwright only. The one Playwright project to run (for example, chromium); at most one per execution. Requires a test set whose test cases all come from a single Playwright package. The selection is saved on the test set and reused by later runs. Omit it to use the playwright.config defaults. For the available names, refer to uip tm testsets playwright-context.
--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>	Maximum seconds to wait for the execution to finish (0 for no timeout). Requires --wait. Default: 1800.
--poll-interval <seconds>	Seconds between status checks while waiting. Requires --wait. Default: 60.

If the Playwright project selection fails, for example because the name is unknown or the test set isn't a single-package Playwright set, the command fails before it applies --input-path overrides or starts the execution.

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

# Run a Playwright test set against one project
uip tm testsets run \
  --test-set-key DEMO:10 \
  --playwright-project chromium

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.

conjuntos de pruebas de uip tm contexto-dramaturgo

Show the Playwright context of a test set: whether every test case in it comes from a single Playwright package, and which Playwright project names are available and currently selected. Use it to find the valid --playwright-project names before calling run.

Argumentos

Nada.

Opciones

Marca	Descripción
--test-set-key <key>	Required. Test set object key (for example, DEMO:42). The project is derived from the prefix.
--log-level <level>	Predeterminado 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"
  }
}

Cuando el conjunto de pruebas no es un conjunto de Playwright de un solo paquete (RPA, mixto, manual o ningún paquete único), IsPlaywright es false y la respuesta en su lugar lleva un campo Details: "Not a Playwright test set (RPA, mixed, manual, or no single package). Run it without --playwright-project." — los cuatro En ese caso, se omiten los campos específicos de Playwright. AvailablePlaywrightProjects/SelectedPlaywrightProjects son cadenas unidas por comas, no matrices.

Relacionado

• pack — packages a Playwright project, whose Playwright project names --playwright-project selects from.
• 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