Casos de prueba de uip tm

uip tm testcases 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. Esta página también documenta uip tm testcaselogs list-assertions, que lee los artefactos de aserción adjuntos a un único registro de caso de prueba producido por una ejecución.

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 testcases link-automation y se ejecuta como parte de un conjunto de pruebas (consulta conjuntos de pruebas).

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

creación de casos de prueba de uip tm

Crea un nuevo caso de prueba dentro de un proyecto.

Argumentos

Nada.

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.

lista de casos de prueba de uip tm

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

Nada.

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 lista-resultados-historial

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

Nada.

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

actualización de casos de prueba de uip tm

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

Nada.

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

eliminación de casos de prueba de uip tm

Eliminar un caso de prueba por su clave.

Argumentos

Nada.

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

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

Nada.

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.

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

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

Nada.

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

• --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

Nada.

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

añadir casos de prueba de uip tm

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

Nada.

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

eliminar casos de prueba de uip tm

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

Nada.

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

Nada.

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.
• 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 (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.