uip tm testcases

uip tm testcases manages test cases within a Test Manager project: create, list, update, delete, link or unlink an Orchestrator automation, inspect historical results, and add or remove test cases from a test set. This page also documents uip tm testcaselogs list-assertions, which reads the assertion artifacts attached to a single test case log produced by a run.

A test case is the unit of authorship. It becomes runnable once it is linked to a package entry point with testcases link-automation, and it runs as part of a test set (see testsets).

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> [filters…]
uip tm testcases update --project-key <key> --test-case-key <key> [--name <name>] [--description <text>]
uip tm testcases delete --project-key <key> --test-case-key <key>
uip tm testcases link-automation --project-key <key> --test-case-key <key> --folder-key <uuid> --package-name <name> --test-name <name>
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 add --test-set-key <key> --test-case-keys <keys>
uip tm testcases remove --test-set-key <key> --test-case-keys <keys>

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

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).

uip tm testcases create

Crea un nuevo caso de prueba dentro de un proyecto.

Argumentos: ninguno.

Opciones:

• --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 solo es necesario para list-result-history.

uip tm testcases list

Enumera todos los casos de prueba en un proyecto. La CLI pagina los resultados automáticamente; no se exponen opciones de paginación en este verbo.

Argumentos: ninguno.

Opciones:

• --project-key <key> (requerido) — proyecto a listar.
• --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",
      "Version": "1.0.0",
      "Description": "Logs in and out"
    }
  ]
}

uip tm testcases list-result-history

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

Argumentos: ninguno.

Opciones:

• --project-key <key> (obligatorio) : proyecto propietario.
• --test-case-id <uuid> obligatorio) : UUID interno del caso de prueba.
• --filter <text> : busca registros de casos de prueba por nombre.
• --only-failed — atajo para "mostrar solo registros fallidos" (predeterminado false).
• --results <results...> — resultados separados por espacios a incluir. Los valores aceptados provienen del enum SDK Result .
• --statuses <statuses...> : estados de ejecución separados por espacios. Los valores aceptados provienen del enum SDK TestCaseLogExecutionStatus .
• --duration-period <period> : filtrar por depósito de duración. Los valores aceptados provienen del enum SDK DurationPeriod .
• --top <number> — tamaño de la página. El valor predeterminado es 50.
• --skip <number> : resultados a 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"
    }
  ]
}

uip tm testcases update

Cambia el nombre de un caso de prueba o cambia su descripción. Se requiere al menos uno de --name o --description ; de lo contrario, el comando falla con un error de validación.

Argumentos: ninguno.

Opciones:

• --project-key <key> (obligatorio) : proyecto propietario.
• --test-case-key <key> (obligatorio) : clave del caso de prueba (p. ej. DEMO:1).
• --name <name> — nuevo nombre.
• --description <text> — nueva descripción.

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",
    "Result": "Updated"
  }
}

uip tm testcases delete

Eliminar un caso de prueba por su clave.

Argumentos: ninguno.

Opciones:

• --project-key <key> (obligatorio) : proyecto propietario.
• --test-case-key <key> (obligatorio) : clave del caso de prueba (p. ej. DEMO:1).

Ejemplo:

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

Forma de datos:

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

uip tm testcases link-automation

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 --folder-key, busca el punto de entrada del paquete coincidente por nombre y luego almacena la vinculación en el caso de prueba. Los cuatro --folder-key, --package-name y --test-name deben resolverse en un punto de entrada concreto o el comando falla.

Argumentos: ninguno.

Opciones:

• --project-key <key> (obligatorio) : proyecto propietario.
• --test-case-key <key> (obligatorio) : caso de prueba para vincular.
• (obligatorio) : UUID de la carpeta --folder-key <uuid> Orchestrator (de uip or folders list).
• --package-name <name> (obligatorio) : identificador del paquete de Orchestrator (p. ej. 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"
  }
}

PackageSource es el nombre para mostrar de la carpeta resuelta desde --folder-key.

uip tm testcases unlink-automation

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

Argumentos: ninguno.

Opciones:

• --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 testcases list-automations

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: ninguno.

Opciones:

• --project-key <key> (obligatorio) : proyecto propietario (utilizado para determinar el ámbito de la búsqueda).
• (obligatorio) : UUID de la carpeta --folder-key <uuid> Orchestrator.
• --package-name <name> : filtra la lista a un paquete (coincidencia exacta sin distinción entre mayúsculas y minúsculas).

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: ninguno.

Opciones:

• --project-key <key> (obligatorio) : proyecto propietario.
• --test-case-key <key> (obligatorio) : clave del caso de prueba (p. ej. 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"
    }
  ]
}

uip tm testcases add

Añade uno o más casos de prueba a un conjunto de pruebas. CLI resuelve cada clave en su UUID interno y llama al punto final de asignación en una solicitud. Si se desconoce alguna clave, toda la llamada falla antes de realizar cualquier cambio.

Argumentos: ninguno.

Opciones:

• --test-set-key <key> (obligatorio) : conjunto de pruebas para modificar.
• --test-case-keys <keys> (obligatorio) : claves de casos de prueba separadas por comas (p. ej. DEMO:1,DEMO:2). Se ignoran los espacios en blanco alrededor de las comas.

Ejemplo:

uip tm testcases add \
  --test-set-key DEMO:10 \
  --test-case-keys DEMO:1,DEMO:2

Forma de datos:

{
  "Code": "TestCaseAdd",
  "Data": {
    "TestSetKey": "DEMO:10",
    "Added": "DEMO:1, DEMO:2",
    "Result": "Added"
  }
}

uip tm testcases remove

Elimina uno o más casos de prueba de un conjunto de pruebas. La misma semántica que testcases add pero llama al punto final de desasignación.

Argumentos: ninguno.

Opciones:

• --test-set-key <key> (obligatorio) : conjunto de pruebas para modificar.
• --test-case-keys <keys> obligatorio) : claves de casos de prueba separadas por comas para eliminar.

Ejemplo:

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

Forma de datos:

{
  "Code": "TestCaseRemove",
  "Data": {
    "TestSetKey": "DEMO:10",
    "Removed": "DEMO:1, DEMO:2",
    "Result": "Removed"
  }
}

uip tm testcaselogs 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 (Expect, VerifyExpression, etc.). Úsalo cuando quieras descubrir por qué un registro de casos de prueba está marcado como Failed.

Este verbo está registrado en testcaselogs, no en testcases, pero se documenta aquí porque lee artefactos de aserción para el registro de un caso de prueba.

Argumentos: ninguno.

Opciones:

• --test-case-log-id <uuid> obligatorio) : UUID de registro de casos de prueba. Consíguelo en uip tm executions testcaselogs list o en uip tm testcases list-result-history.
• --project-key <key> (obligatorio) : proyecto propietario.

Ejemplo:

uip tm testcaselogs 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 }
  ]
}

Relacionado

• proyecto : ámbito que posee cada caso de prueba.
• testsets — group test cases into a runnable suite.
• executions — execution-level views of test case logs (execution testcaselogs list).
• 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.
• uip or packages : cómo se registran los paquetes de Orchestrator y los puntos de entrada.