Casos de prueba de uip tm

Sintaxis y opciones para `uip tm testcases`, que gestiona los casos de prueba, incluida la creación, la lista, la actualización, la eliminación, las automatizaciones de enlaces y la gestión del registro de casos de prueba.

uip tm testcases gestiona los casos de prueba dentro de un proyecto de Test Manager: crea, enumera, actualiza, elimina, vincula o desvincula una automatización de Orchestrator, inspecciona los resultados históricos y añade o elimina casos de prueba de un conjunto de pruebas. También proporciona testcases run: una forma de ejecutar uno o más casos de prueba directamente desde un paquete de Orchestrator. Esta página también documenta uip tm testcaselog list-assertions, testcaselog start y testcaselog finish (registrado bajo testcaselog, singular), que leen artefactos de aserción y registran entradas de registro manuales para un registro de casos de prueba.

Un caso de prueba es la unidad de autoría. Se vuelve ejecutable una vez que se vincula a un punto de entrada de paquete con testcases link-automation. A continuación, se puede ejecutar un caso de prueba como parte de un conjunto de pruebas (consulta Conjuntos de pruebas) o directamente a través de testcases run.

ADVERTENCIA:

Nunca ejecutes testcases link-automation en un caso de prueba creado por uip tm pack para un proyecto de Playwright. Los casos de prueba de Playwright se vinculan automáticamente durante la ingestión del pack-time; ejecutar link-automation en ellos manualmente sigue el proceso de vinculación de RPA y corrompe esa asociación. Si empaquetaste con --no-create-test-cases, utiliza el flujo Seleccionar automatización en la IU de Test Manager en su lugar.

Sinopsis

uip tm testcases create --project-key <key> --name <name> [--description <text>] [--version <version>]
uip tm testcases list --project-key <key> [--filter <text>]
uip tm testcases list-result-history --project-key <key> --test-case-id <uuid> [--filter <text>] [--only-failed] [--results <results...>] [--statuses <statuses...>] [--duration-period <period>] [--top <number>] [--skip <number>]
uip tm testcases update --project-key <key> --test-case-key <key> [--name <name>] [--description <text>] [--pre-condition <text>] [--post-condition <text>]
uip tm testcases delete --project-key <key> --test-case-key <key> [-y]
uip tm testcases link-automation --project-key <key> --test-case-key <key> --folder-key <uuid> --package-name <name> --test-name <name>
uip tm testcases link-package --project-key <key> --folder-key <uuid> [--package-name <name>] [--test-name <name...>] [--dry-run]
uip tm testcases unlink-automation --project-key <key> --test-case-key <key>
uip tm testcases list-automations --project-key <key> [--folder-key <uuid>] [--package-name <name>]
uip tm testcases list-testsets --project-key <key> --test-case-key <key>
uip tm testcases run --project-key <key> --test-case-id <uuid...> --name <name> --execution-type <type> [--async] [--folder-key <uuid>] [--runtime-type <type>] [--robot-user-key <uuid>] [--machine-key <uuid>] [--host-machine-name <name>] [--service-user-name <name>] [--test-set-packages <json>]
uip tm testcases add --test-set-key <key> (--test-case-keys <keys...> | --labels <labels...> [--limit <count>])
uip tm testcases remove --test-set-key <key> --test-case-keys <keys> [-y]
uip tm testcases list-steps --project-key <key> --test-case-id <uuid>

uip tm testcases steps list --project-key <key> --test-case-id <uuid>
uip tm testcases steps get --project-key <key> --step-id <uuid>
uip tm testcases steps add --project-key <key> --test-case-id <uuid> [--description <text>] [--expected-result <text>] [--action-type <type>] [--clipboard-data <text>] [--order-no <n>] [--step <json>...]
uip tm testcases steps update --project-key <key> --step-id <uuid> [--description <text>] [--expected-result <text>] [--action-type <type>] [--clipboard-data <text>]
uip tm testcases steps move --project-key <key> --step-id <uuid> --target-position <n>
uip tm testcases steps delete --project-key <key> --step-id <uuid> [-y]

uip tm testcaselog list-assertions --project-key <key> --test-case-log-id <uuid>

uip tm testcaselog start --project-key <key> --execution-id <uuid> --test-case-id <uuid> [--run-id <number>]
uip tm testcaselog finish --project-key <key> --execution-id <uuid> --test-case-id <uuid> --result <result> --has-error <boolean> --executed-by <email> [--detail-link <url>] [--run-id <number>] [--is-post-condition-met <boolean>] (--step-logs <json> | --step-logs-file <path>)

Importante:

list-assertions, start y finish están registrados bajo uip tm testcaselog (singular). uip tm testcaselogs list-assertions y uip tm testcaselogs start/finish no existen como comandos.

Todos los verbos respetan las opciones globales y los códigos de salida estándar.

Nota:

--log-level <level> (predeterminado: Information) está disponible en create, list, list-result-history, update, delete, link-automation, link-package, unlink-automation, list-automations, list-testsets, add y remove. No existe en run, en ningún subcomando steps (incluido el alias list-steps) o testcaselog start/finish/list-assertions.

creación de casos de prueba de uip tm

Crea un nuevo caso de prueba dentro de un proyecto.

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Obligatorio. Proyecto propietario.
--name <name>	Obligatorio. Nombre del caso de prueba.
--description <text>	Descripción de forma libre. El valor predeterminado es vacío.
--version <version>	Cadena de versión del caso de prueba. El valor predeterminado es 1.0.0.

Ejemplo

uip tm testcases create \
  --project-key DEMO \
  --name "Login smoke" \
  --description "Logs in and out"

Forma de datos

{
  "Code": "TestCaseCreate",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Login smoke",
    "Description": "Logs in and out",
    "Version": "1.0.0"
  }
}

TestCaseKey (el identificador público PROJECT:N ) es lo que pasas a otros verbos. El Id interno (UUID) es necesario para list-result-history y list-testsets.

lista de casos de prueba de uip tm

Enumera todos los casos de prueba en un proyecto. La CLI pagina los resultados automáticamente.

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Obligatorio. Proyecto a lista.
--filter <text>	Filtrar por nombre o clave (búsqueda en el servidor).

Ejemplo

uip tm testcases list --project-key DEMO --filter login

Forma de datos

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

uip tm testcases lista-resultados-historial

Enumera los registros de casos de prueba históricos para un solo caso de prueba. Toma el --test-case-id (UUID) interno: busca el UUID a través de testcases list o de una salida TestCaseCreate anterior.

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Obligatorio. Proyecto propietario.
--test-case-id <uuid>	Obligatorio. UUID de caso de prueba interno.
--filter <text>	Buscar registros de casos de prueba por nombre.
--only-failed	Atajo para "mostrar solo registros fallidos" (valor predeterminado: false).
--results <results...>	Resultados separados por espacios para incluir. Los valores aceptados provienen de la enumeración SDK Result.
--statuses <statuses...>	Estados de ejecución separados por espacios. Los valores aceptados provienen de la enumeración SDK TestCaseLogExecutionStatus.
--duration-period <period>	Filtrar por depósito de duración. Los valores aceptados provienen de la enumeración SDK DurationPeriod.
--top <number>	Tamaño de la página. El valor predeterminado es 50.
--skip <number>	Resultados para omitir. El valor predeterminado es 0.

Nota:

Los valores aceptados exactos para --results, --statuses y --duration-period se generan en tiempo de ejecución a partir de las enumeraciones del SDK de Test Manager enviadas con la versión de la herramienta instalada. Ejecuta uip tm testcases list-result-history --help para ver el conjunto actual.

Ejemplo

uip tm testcases list-result-history \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --only-failed

Forma de datos

{
  "Code": "TestCaseResultHistory",
  "Data": [
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000001",
      "Result": "Failed",
      "Status": "Finished",
      "ExecutionEnd": "2025-04-15T12:00:00Z"
    }
  ]
}

actualización de casos de prueba de uip tm

Cambia el nombre de un caso de prueba o cambia su descripción, condición previa o condición posterior. Al menos uno de estos campos es obligatorio.

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Obligatorio. Proyecto propietario.
--test-case-key <key>	Obligatorio. Clave del caso de prueba (por ejemplo, DEMO:1).
--name <name>	Nuevo nombre.
--description <text>	Nueva descripción.
--pre-condition <text>	Nueva condición previa: lo que debe ser verdadero antes de ejecutar la prueba.
--post-condition <text>	Nueva condición posterior: lo que debería ser verdadero después de ejecutar la prueba.

Ejemplo

uip tm testcases update \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --name "Login smoke (2026)"

Forma de datos

{
  "Code": "TestCaseUpdate",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Name": "Login smoke (2026)",
    "Description": "Logs in and out",
    "PreCondition": "User account exists",
    "PostCondition": "User is logged out",
    "Result": "Updated"
  }
}

eliminación de casos de prueba de uip tm

Eliminar un caso de prueba por su clave.

Argumentos

Nada.

Opciones

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

Ejemplo

uip tm testcases delete \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --yes

Forma de datos

{
  "Code": "TestCaseDelete",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Result": "Deleted"
  }
}

automatización de enlaces de casos de prueba de uip tm

Vincula un punto de entrada del paquete de Orchestrator a un caso de prueba. Esto es lo que hace que el caso de prueba sea ejecutable dentro de un conjunto de pruebas. Internamente, el comando resuelve el nombre para mostrar de la carpeta desde --folder-key, busca el punto de entrada del paquete coincidente por nombre y luego almacena la vinculación en el caso de prueba. Para los casos de prueba de Playwright creados por pack, consulta la advertencia anterior.

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Obligatorio. Proyecto propietario.
--test-case-key <key>	Obligatorio. Caso de prueba para vincular.
--folder-key <uuid>	Obligatorio. UUID de la carpeta de Orchestrator (de uip or folders list).
--package-name <name>	Obligatorio. Identificador de paquete de Orchestrator (por ejemplo, InvoiceTests).
--test-name <name>	Obligatorio. El nombre del caso de prueba dentro del paquete (el nombre del punto de entrada).

Ejemplo

uip tm testcases link-automation \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name InvoiceTests \
  --test-name SmokeTest

Forma de datos

{
  "Code": "TestCaseLinkAutomation",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "PackageName": "InvoiceTests",
    "PackageSource": "Shared",
    "TestName": "SmokeTest",
    "Result": "Linked"
  }
}

Paquete de enlaces de casos de prueba de UIP tm

Crea y vincula un caso de prueba para cada prueba en un paquete de Orchestrator, en una llamada: la contraparte masiva de link-automation, que vincula un caso de prueba existente a una automatización. De forma predeterminada, vincula cada prueba que expone la carpeta; Ámbitalo a un paquete con --package-name, o a pruebas específicas con --test-name. Cada prueba crea un nuevo caso de prueba (Action: "Created") o reutiliza uno ya vinculado a esa automatización (Action: "Reused").

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Obligatorio. Proyecto propietario.
--folder-key <uuid>	Obligatorio. UUID de la carpeta de Orchestrator (de uip or folders list).
--package-name <name>	Vincular solo pruebas de este paquete (coincidencia exacta que no distingue entre mayúsculas y minúsculas). Omita vincular cada prueba que expone la carpeta.
--test-name <name...>	Vincula solo estas pruebas (no distingue entre mayúsculas y minúsculas, repetible). Omite vincularlos todos.
--dry-run	Vista previa de qué casos de prueba se crearían, reutilizarían y vincularían, sin escribir nada.

Ejemplos

# Create and link a test case for every test in one Orchestrator package
uip tm testcases link-package \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name InvoiceTests

# Preview what would be created and linked, without writing
uip tm testcases link-package \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name InvoiceTests \
  --dry-run

# Link only two named tests out of the package
uip tm testcases link-package \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name InvoiceTests \
  --test-name SmokeTest RegressionTest

Forma de datos

{
  "Code": "TestCaseLinkPackage",
  "Data": [
    {
      "TestName": "SmokeTest",
      "PackageName": "InvoiceTests",
      "PackageVersion": "1.0.2",
      "TestCaseKey": "DEMO:7",
      "TestCaseId": "a1b2c3d4-0000-0000-0000-000000000007",
      "Action": "Created"
    },
    {
      "TestName": "RegressionTest",
      "PackageName": "InvoiceTests",
      "PackageVersion": "1.0.2",
      "TestCaseKey": "DEMO:3",
      "TestCaseId": "a1b2c3d4-0000-0000-0000-000000000003",
      "Action": "Reused"
    }
  ]
}

Con --dry-run, Code es TestCaseLinkPackageDryRun en su lugar, los valores Action se convierten en WouldCreate/WouldReuse, y TestCaseKey/TestCaseId son cadenas vacías, ya que en realidad no se ha escrito nada.

desvinculación de automatización de casos de prueba de uip tm

Elimina la vinculación de automatización de un caso de prueba. Después de desvincularse, el caso de prueba ya no es ejecutable hasta que se vuelva a vincular.

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Obligatorio. Proyecto propietario.
--test-case-key <key>	Obligatorio. Caso de prueba para desvincular.

Ejemplo

uip tm testcases unlink-automation \
  --project-key DEMO \
  --test-case-key DEMO:1

Forma de datos

{
  "Code": "TestCaseUnlinkAutomation",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Result": "Unlinked"
  }
}

uip tm casos de prueba lista-automatizaciones

Enumera los puntos de entrada de prueba disponibles en una carpeta de Orchestrator. Utilízalo para descubrir los valores --package-name / --test-name para pasar a link-automation.

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Obligatorio. Proyecto propietario (utilizado para determinar el ámbito de la búsqueda).
--folder-key <uuid>	UUID de la carpeta de Orchestrator. Omita buscar en la fuente del tenant en lugar de en una carpeta.
--package-name <name>	Filtra la lista a un paquete (coincidencia exacta que no distingue entre mayúsculas y minúsculas, no una búsqueda de subcadena).

Ejemplo

uip tm testcases list-automations \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001

Forma de datos

{
  "Code": "TestAutomationsList",
  "Data": [
    {
      "PackageName": "InvoiceTests",
      "TestName": "SmokeTest",
      "PackageVersion": "1.0.2"
    }
  ]
}

uip tm testcases list-testsets

Enumera cada conjunto de pruebas que contiene un caso de prueba determinado.

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Obligatorio. Proyecto propietario.
--test-case-key <key>	Obligatorio. Clave del caso de prueba (por ejemplo, DEMO:1).

Ejemplo

uip tm testcases list-testsets \
  --project-key DEMO \
  --test-case-key DEMO:1

Forma de datos

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

ejecución de casos de prueba de uip tm

Ejecuta uno o más casos de prueba directamente desde un paquete de Orchestrator, sin crear primero un conjunto de pruebas. testcases run inicia una ejecución y devuelve el registro de ejecución. Para obtener más información sobre esta capacidad, consulta Ejecutar casos de prueba sin un conjunto de pruebas en la documentación de Test Manager.

Nota:

testcases run es síncrono de forma predeterminada: se bloquea hasta que se confirma el registro de ejecución. Para volver inmediatamente después de poner en cola, pasa --async. Para bloquear hasta que finalice la ejecución, canaliza el Id devuelto a uip tm wait.

Cuándo utilizar testcases run frente a testsets run

• testcases run para ejecutar casos de prueba bajo demanda directamente desde un paquete.
• Usa testsets run para ejecutar un grupo de casos de prueba nombrados y seleccionados que se gestionan a lo largo del tiempo en Test Manager.

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Clave de proyecto de Test Manager (por ejemplo, DEMO). Opcional si es derivable del contexto.
--test-case-id <uuid...>	Obligatorio. Uno o más UUID de casos de prueba para ejecutar, separados por espacios. Obtener UUID de testcases list.
--execution-type <type>	Obligatorio. Tipo de ejecución: automated, manual, mixed o none.
--name <name>	Nombre para mostrar de la ejecución.
--async	Regrese inmediatamente después de la cola, sin esperar a que el servidor confirme que se ha iniciado la ejecución. Omita esperar a que el registro de ejecución se cree completamente antes de regresar.
--folder-key <uuid>	Carpeta de Orchestrator en la que se ejecutará. Obligatorio cuando los casos de prueba están vinculados a automatizaciones en una carpeta específica.
--runtime-type <type>	Anulación del tipo de runtime de UiPath Robot. Valores aceptados: nonProduction, attended, unattended, rpaDeveloper, studioX, headless, rpaDeveloperPro, testAutomation, automationCloud, serverless, automationKit, serverlessTestAutomation, automationCloudTestAutomation, attendedStudioWeb, hosting, assistantWeb, processOrchestration, agentService, appTest, performanceTest, businessRule, caseManagement.
--robot-user-key <uuid>	Clave de usuario de robot para el destino de ejecución.
--machine-key <uuid>	Clave de máquina para el destino de ejecución.
--host-machine-name <name>	Nombre de la máquina host para el destino de ejecución.
--service-user-name <name>	Nombre de usuario de servicio para el destino de ejecución.
--test-set-packages <json>	Matriz JSON de anulaciones de paquetes: [{"packageName":"Pkg","version":"1.0.0"}].

Ejemplos

# Simplest — run a single test case (blocks until execution record is created)
uip tm testcases run \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --execution-type automated \
  --name "Login smoke run"

# Run multiple test cases asynchronously, then wait for completion
id=$(uip tm testcases run \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 a1b2c3d4-0000-0000-0000-000000000002 \
  --execution-type automated \
  --name "Smoke run" \
  --async \
  --output-filter Id)

uip tm wait --execution-id "$id" --project-key DEMO --timeout 900
uip tm report get --execution-id "$id" --project-key DEMO

# Full override — specify folder, runtime, machine, and package version
uip tm testcases run \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --execution-type automated \
  --name "Smoke run" \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --runtime-type unattended \
  --machine-key 33333333-4444-5555-6666-777777777777 \
  --test-set-packages '[{"packageName":"InvoiceTests","version":"1.0.2"}]'

Forma de datos

{
  "Code": "TestCaseRun",
  "Data": {
    "Id": "b2c3d4e5-0000-0000-0000-000000000001",
    "Name": "Login smoke run",
    "ProjectId": "00000000-0000-0000-0000-000000000abc",
    "TestSetId": "a1b2c3d4-0000-0000-0000-000000000010",
    "TestSetObjKey": "DEMO:10",
    "Status": "Running",
    "ExecutionType": "automated",
    "Source": "Manual",
    "RunId": 1,
    "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001",
    "ExecutionStart": "2025-04-15T10:30:00Z",
    "EnableCoverage": false,
    "EnforceExecutionOrder": false,
    "AutopilotForRobotsSettings": { "Enabled": false },
    "OrderedExecutionSettings": { "Enabled": false },
    "VideoRecordingSettings": { "Enabled": false }
  }
}

Campos clave:

• Id : pasar a uip tm wait, report get, result download, attachment download.
• Status: "Running" : es posible que la ejecución aún no se haya enviado.
• Source: "Manual" : todas las ejecuciones testcases run se etiquetan como desencadenadas manualmente.

Flujo de trabajo de extremo a extremo: paquete a resultados

# 1. Discover your project key
uip tm project list --output json

# 2. Find the test case UUIDs you want to run
uip tm testcases list --project-key DEMO --filter "login" --output json

# 3. Find the folder that holds your package
uip or folders list --output json

# 4. Link the test case to the automation entry point
uip tm testcases link-automation \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name InvoiceTests \
  --test-name SmokeTest

# 5. Run the test cases directly
id=$(uip tm testcases run \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --execution-type automated \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --name "PR #42 smoke" \
  --output-filter Id)

# 6. Block until done (timeout in seconds — 15 minutes here)
uip tm wait \
  --execution-id "$id" \
  --project-key DEMO \
  --timeout 900

# 7. Read the result
uip tm report get --execution-id "$id" --project-key DEMO

# 8. Download JUnit XML for CI
uip tm result download \
  --execution-id "$id" \
  --project-key DEMO \
  --result-path ./junit.xml

# 9. Download screenshots and logs
uip tm attachment download \
  --execution-id "$id" \
  --project-key DEMO \
  --only-failed \
  --result-path ./attachments

añadir casos de prueba de uip tm

Añade casos de prueba a un conjunto de pruebas existente, ya sea por claves explícitas o por etiqueta. Pase exactamente uno de --test-case-keys o --labels.

Argumentos

Nada.

Opciones

Marca	Descripción
--test-set-key <key>	Obligatorio. Clave de objeto del conjunto de pruebas (por ejemplo, DEMO:42).
--test-case-keys <keys...>	Claves de casos de prueba para añadir, separadas por espacios (por ejemplo, DEMO:1 DEMO:2). También se aceptan valores separados por comas. Mutuamente exclusivo con --labels.
--labels <labels...>	Nombres de etiquetas separados por espacios. Añade cada caso de prueba en el proyecto que lleva al menos una de las etiquetas, incluidas las etiquetas PW_Tag_*, PW_Project_*, PW_Suite_* y PW_File_* aplicadas por pack en la ingestión. Mutuamente exclusivo con --test-case-keys.
--limit <count>	Número máximo de casos de prueba coincidentes con etiquetas para añadir. Solo es válido con --labels. Predeterminado a todas las coincidencias.

Ejemplos

# add by explicit keys
uip tm testcases add \
  --test-set-key DEMO:42 \
  --test-case-keys DEMO:1 DEMO:2

# add every test case carrying one of the given labels
uip tm testcases add \
  --test-set-key DEMO:42 \
  --labels PW_Tag_smoke PW_Project_chromium

Forma de datos

{
  "Code": "TestSetAddTestCases",
  "Data": {
    "TestSetKey": "DEMO:42",
    "Added": "DEMO:1, DEMO:2",
    "Result": "Added"
  }
}

Al añadir por --labels, la respuesta también incluye MatchedLabels:

{
  "Code": "TestSetAddTestCases",
  "Data": {
    "TestSetKey": "DEMO:42",
    "Added": "DEMO:3, DEMO:4, DEMO:7",
    "MatchedLabels": "PW_Tag_smoke, PW_Project_chromium",
    "Result": "Added"
  }
}

eliminar casos de prueba de uip tm

Elimina uno o más casos de prueba de un conjunto de pruebas.

Argumentos

Nada.

Opciones

Marca	Descripción
--test-set-key <key>	Obligatorio. Clave de objeto del conjunto de pruebas (por ejemplo, DEMO:42).
--test-case-keys <keys>	Obligatorio. Claves de casos de prueba separadas por comas para eliminar (por ejemplo, DEMO:1,DEMO:2).
-y, --yes	Omite la solicitud de confirmación. Necesario en entornos no interactivos.

Ejemplo

uip tm testcases remove \
  --test-set-key DEMO:42 \
  --test-case-keys DEMO:1,DEMO:2 \
  --yes

Forma de datos

{
  "Code": "TestSetRemoveTestCases",
  "Data": {
    "TestSetKey": "DEMO:42",
    "Removed": "DEMO:1, DEMO:2",
    "Result": "Removed"
  }
}

UIP tm casos de prueba lista-pasos

Enumera los pasos de prueba manuales de un caso de prueba. Este es un alias para testcases steps list.

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Obligatorio. Clave de proyecto de Test Manager (por ejemplo, DEMO).
--test-case-id <uuid>	Obligatorio. UUID de caso de prueba interno.

Ejemplo

uip tm testcases list-steps \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001

Forma de datos

{
  "Code": "TestCaseStepsList",
  "Data": [
    {
      "Id": "d4e5f6a7-0000-0000-0000-000000000001",
      "TestCaseId": "a1b2c3d4-0000-0000-0000-000000000001",
      "OrderNo": 0,
      "ActionType": "Manual",
      "Description": "Open login page",
      "ExpectedResult": "Login form is displayed"
    }
  ]
}

pasos de casos de prueba de uip tm

testcases steps es un subgrupo que gestiona los pasos manuales individuales de un caso de prueba: enumerar, obtener, añadir, actualizar, mover y eliminar.

lista de pasos de casos de prueba de uip tm

Enumera los pasos de un caso de prueba en orden.

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Obligatorio. Clave de proyecto de Test Manager.
--test-case-id <uuid>	Obligatorio. UUID de caso de prueba interno.

Ejemplo

uip tm testcases steps list \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001

Forma de datos

{
  "Code": "TestCaseStepsList",
  "Data": [
    {
      "Id": "d4e5f6a7-0000-0000-0000-000000000001",
      "OrderNo": 0,
      "ActionType": "Manual",
      "Description": "Open login page",
      "ExpectedResult": "Login form is displayed"
    }
  ]
}

uip tm casos de prueba pasos obtener

Obtener un solo paso por su UUID.

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Obligatorio. Clave de proyecto de Test Manager.
--step-id <uuid>	Obligatorio. UUID del paso de prueba (de steps list).

Ejemplo

uip tm testcases steps get \
  --project-key DEMO \
  --step-id d4e5f6a7-0000-0000-0000-000000000001

Forma de datos

{
  "Code": "TestStepGet",
  "Data": {
    "Id": "d4e5f6a7-0000-0000-0000-000000000001",
    "OrderNo": 0,
    "ActionType": "Manual",
    "Description": "Open login page",
    "ExpectedResult": "Login form is displayed"
  }
}

uip tm casos de prueba pasos añadir

Añade uno o más pasos a un caso de prueba. Utilice marcadores en línea para un solo paso o ( --step <json> ) para varios a la vez.

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Obligatorio. Clave de proyecto de Test Manager.
--test-case-id <uuid>	Obligatorio. Caso de prueba al que añadir pasos.
--description <text>	Descripción del paso (modo de un solo paso).
--expected-result <text>	Resultado esperado (modo de un solo paso).
--action-type <type>	Tipo de acción de paso (modo de un solo paso).
--clipboard-data <text>	Datos de prueba a copiar para el paso (modo de un solo paso).
--order-no <n>	posición de inserción basada en 0; omitir anexar al final (modo de un solo paso).
--step <json>	Un paso como objeto JSON ({"description":"...","expectedResult":"..."}). Repita para añadir varios pasos.

Ejemplos

# single step
uip tm testcases steps add \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --description "Open login page" \
  --expected-result "Login form is displayed"

# multiple steps
uip tm testcases steps add \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --step '{"description":"Open login page","expectedResult":"Login form is shown"}' \
  --step '{"description":"Enter credentials","clipboardData":"[e-mail]"}' \
  --step '{"description":"Click submit","expectedResult":"Dashboard loads"}'

Forma de datos

{
  "Code": "TestStepAdd",
  "Data": {
    "AddedCount": 1,
    "Steps": [
      {
        "Id": "d4e5f6a7-0000-0000-0000-000000000001",
        "TestCaseId": "a1b2c3d4-0000-0000-0000-000000000001",
        "OrderNo": 0,
        "ActionType": "",
        "Description": "Open login page",
        "ExpectedResult": "Login form is displayed",
        "ClipboardData": ""
      }
    ]
  }
}

Añadir pasos no es atómico: si un paso en un lote de varios pasos --step falla, los pasos anteriores permanecen creados. El mensaje de error informa de cuántos se han realizado correctamente para que puedas inspeccionar con steps list y reintentar solo el resto.

Actualización de pasos de casos de prueba de uip tm

Actualice la descripción de un paso, el resultado esperado, el tipo de acción o los datos del portapapeles. Se debe proporcionar al menos uno de estos campos.

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Obligatorio. Clave de proyecto de Test Manager.
--step-id <uuid>	Obligatorio. UUID del paso de prueba.
--description <text>	Nueva descripción.
--expected-result <text>	Nuevo resultado esperado.
--action-type <type>	Nuevo tipo de acción.
--clipboard-data <text>	Nuevos datos del portapapeles.

Ejemplo

uip tm testcases steps update \
  --project-key DEMO \
  --step-id d4e5f6a7-0000-0000-0000-000000000001 \
  --expected-result "Dashboard is shown"

Forma de datos

{
  "Code": "TestStepUpdate",
  "Data": {
    "StepId": "d4e5f6a7-0000-0000-0000-000000000001",
    "Result": "Updated"
  }
}

uip tm casos de prueba pasos mover

Mueve un paso a una nueva posición en el orden de los casos de prueba.

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Obligatorio. Clave de proyecto de Test Manager.
--step-id <uuid>	Obligatorio. UUID del paso de prueba.
--target-position <n>	Obligatorio. Nueva posición basada en 0 (0 = primera). Coincide con el campo OrderNo de steps list.

Ejemplo

uip tm testcases steps move \
  --project-key DEMO \
  --step-id d4e5f6a7-0000-0000-0000-000000000001 \
  --target-position 2

Forma de datos

{
  "Code": "TestStepMove",
  "Data": {
    "StepId": "d4e5f6a7-0000-0000-0000-000000000001",
    "TargetPosition": 2,
    "Result": "Moved"
  }
}

uip tm casos de prueba pasos eliminar

Eliminar un paso de un caso de prueba. Esto es permanente.

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Obligatorio. Clave de proyecto de Test Manager.
--step-id <uuid>	Obligatorio. UUID del paso de prueba.
-y, --yes	Obligatorio. Confirme esta operación irreversible.

Ejemplo

uip tm testcases steps delete \
  --project-key DEMO \
  --step-id d4e5f6a7-0000-0000-0000-000000000001 \
  --yes

Forma de datos

{
  "Code": "TestStepDelete",
  "Data": {
    "StepId": "d4e5f6a7-0000-0000-0000-000000000001",
    "Result": "Deleted"
  }
}

uip tm testcaselog list-assertions

Enumera las aserciones registradas para un solo registro de caso de prueba. Cada ejecución de un caso de prueba produce exactamente un registro de caso de prueba; sus aserciones son las comprobaciones individuales que registró la automatización. Este verbo muestra por qué un registro de casos de prueba está marcado como Failed.

Este verbo está registrado bajo testcaselog (singular), junto con testcaselog start y testcaselog finish a continuación, no bajo testcases o testcaselogs (plural). uip tm testcaselogs list-assertions no existe.

Argumentos

Nada.

Opciones

Marca	Descripción
--test-case-log-id <uuid>	Obligatorio. UUID de registro de casos de prueba. Consíguelo de uip tm executions testcaselogs list o uip tm testcases list-result-history.
--project-key <key>	Obligatorio. Proyecto propietario.

Ejemplo

uip tm testcaselog list-assertions \
  --test-case-log-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO

Forma de datos

{
  "Code": "TestCaseLogAssertions",
  "Data": [
    { "Message": "Title contains 'Welcome'", "Succeeded": true },
    { "Message": "Button 'Login' visible", "Succeeded": false }
  ]
}

inicio de registro de caso de prueba de uip tm

Inicia una ejecución de caso de prueba dentro de una ejecución de prueba existente. Utilizado por automatizaciones e integraciones para registrar ejecuciones de casos de prueba manuales o mixtas; la mayoría de los usuarios no llaman a esto directamente.

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Obligatorio. Proyecto propietario.
--execution-id <uuid>	Obligatorio. La ejecución de prueba en la que se ejecuta el caso de prueba.
--test-case-id <uuid>	Obligatorio. UUID interno del caso de prueba que se está registrando.
--run-id <number>	ID de ejecución contra el que grabar. Omite buscarlo automáticamente desde el RunId actual de la ejecución.

Ejemplo

uip tm testcaselog start \
  --project-key DEMO \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --test-case-id b2c3d4e5-0000-0000-0000-000000000001

Forma de datos

{
  "Code": "TestCaseLogStart",
  "Data": {
    "Id": "c3d4e5f6-0000-0000-0000-000000000001",
    "TestCaseId": "b2c3d4e5-0000-0000-0000-000000000001",
    "ProjectId": "00000000-0000-0000-0000-000000000abc",
    "TestExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Result": "None",
    "BusinessResult": "None",
    "OriginalResult": "None",
    "Status": "Running",
    "ExecutionType": "manual",
    "HasError": false,
    "ExecutionStart": "2025-04-15T10:30:00Z",
    "ExecutionEnd": null,
    "ExecutedBy": "[e-mail]",
    "RunId": 1,
    "Updated": "2025-04-15T10:30:00Z"
  }
}

Id es el UUID del registro del caso de prueba: pásalo a uip tm teststeplog list o testcaselog list-assertions una vez finalizada la ejecución. La respuesta completa incluye muchos más campos (AutomationId, JobKey, PreCondition, PostCondition y otros) en su mayoría vacíos en el momento de inicio; aquí solo se muestran los campos relevantes para el seguimiento del progreso.

uip tm testcaselog finish

Finaliza una ejecución de caso de prueba iniciada con testcaselog start, registrando el resultado general y (opcionalmente) cada resultado de paso en una llamada.

Importante:

No hay ningún marcador --test-case-log-id o --info en este comando. finish vuelve a identificar la ejecución a través de --execution-id + --test-case-id (el mismo par pasado a start), no por el UUID de registro start devuelto.

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Obligatorio. Proyecto propietario.
--execution-id <uuid>	Obligatorio. La ejecución de prueba pasó a testcaselog start.
--test-case-id <uuid>	Obligatorio. El caso de prueba pasado a testcaselog start.
--result <result>	Obligatorio. Resultado general (del enum Result del SDK, por ejemplo Passed, Failed).
--has-error <boolean>	Obligatorio. Marcar la ejecución como con error (true/false).
--executed-by <email>	Obligatorio. Correo electrónico del usuario que ejecutó la prueba.
--detail-link <url>	URL con detalles de ejecución adicionales.
--run-id <number>	ID de ejecución contra el que grabar. Omite buscarlo automáticamente desde el RunId actual de la ejecución.
--is-post-condition-met <boolean>	Marca si se cumplió la condición posterior.
--step-logs <json>	Matriz JSON de objetos de registro de pasos para grabar para la ejecución de este caso de prueba. Mutuamente exclusivo con --step-logs-file.
--step-logs-file <path>	Ruta a un archivo JSON con la misma forma que --step-logs. Mutuamente exclusivo con --step-logs.

Ejemplos

# finish with step results inline
uip tm testcaselog finish \
  --project-key DEMO \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --test-case-id b2c3d4e5-0000-0000-0000-000000000001 \
  --result Passed \
  --has-error false \
  --executed-by [e-mail] \
  --is-post-condition-met true \
  --step-logs '[{"id":"3fa85f64-0000-0000-0000-000000000001","testStepId":"d4e5f6a7-0000-0000-0000-000000000001","result":"Passed","orderNo":1,"hasError":false,"hasAttachment":false}]'

# finish with step results loaded from a file
uip tm testcaselog finish \
  --project-key DEMO \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --test-case-id b2c3d4e5-0000-0000-0000-000000000001 \
  --result Failed \
  --has-error true \
  --executed-by [e-mail] \
  --step-logs-file ./step-logs.json

Forma de datos

{
  "Code": "TestCaseLogFinish",
  "Data": {
    "Id": "c3d4e5f6-0000-0000-0000-000000000001",
    "TestCaseId": "b2c3d4e5-0000-0000-0000-000000000001",
    "ProjectId": "00000000-0000-0000-0000-000000000abc",
    "TestExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Result": "Passed",
    "BusinessResult": "Passed",
    "OriginalResult": "Passed",
    "Status": "Finished",
    "ExecutionType": "manual",
    "HasError": false,
    "ExecutionStart": "2025-04-15T10:30:00Z",
    "ExecutionEnd": "2025-04-15T10:31:00Z",
    "ExecutedBy": "[e-mail]",
    "RunId": 1,
    "IsPostConditionMet": true,
    "Updated": "2025-04-15T10:31:00Z"
  }
}

Relacionado

• pack : empaqueta un proyecto de Playwright y vincula automáticamente sus casos de prueba en el momento de la ingestión; no utilices link-automation en los casos de prueba que crea.
• proyecto : ámbito que posee cada caso de prueba.
• conjuntos de pruebas : agrupa los casos de prueba en una suite ejecutable.
• ejecuciones : vistas en el nivel de ejecución de los registros de casos de prueba.
• informe : resumen de una ejecución, con casos fallidos y texto de aserción.

Ver también

• Descripción general de Test Manager
• uip or folders list : origen de --folder-key para link-automation y list-automations.
• uip or packages : cómo se registran los paquetes de Orchestrator y los puntos de entrada.