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 enumera qué conjuntos de pruebas contienen un caso de prueba. Esta página también documenta uip tm testcaselog list-assertions, que lee los artefactos de aserción adjuntos a un único registro de caso de prueba, y los verbos testcaselog start / testcaselog finish utilizados por las automatizaciones para registrar entradas de registro manuales.

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>] [--precondition <text>] [--postcondition <text>]
uip tm testcases list --project-key <key> [--filter <text>] [--limit <n>] [--offset <n>]
uip tm testcases list-result-history --project-key <key> --test-case-id <uuid> [--limit <n>] [--offset <n>]
uip tm testcases update --project-key <key> --test-case-key <key> [--name <name>] [--description <text>] [--precondition <text>] [--postcondition <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> --automation-id <uuid>
uip tm testcases unlink-automation --project-key <key> --test-case-key <key>
uip tm testcases list-automations --folder-key <uuid> [--package-name <name>]
uip tm testcases list-testsets --project-key <key> --test-case-id <uuid>
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>
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 --execution-id <uuid> --test-case-id <uuid> [--execution-type <type>]
uip tm testcaselog finish --test-case-log-id <uuid> [--info <text>]

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.
• --precondition <text> — texto de condición previa. El valor predeterminado es vacío.
• --postcondition <text> — texto de condición posterior. El valor predeterminado es vacío.

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

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.

Argumentos

Nada.

Opciones

• --project-key <key> (requerido) — proyecto a listar.
• --filter <text> : filtrar por nombre o clave (búsqueda en el servidor).
• --limit <n> — tamaño de la página. El valor predeterminado es 50.
• --offset <n> : resultados a omitir. El valor predeterminado es 0.

Ejemplo

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

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

• --project-key <key> (obligatorio) : proyecto propietario.
• --test-case-id <uuid> obligatorio) : UUID interno del caso de prueba.
• --limit <n> — tamaño de la página. El valor predeterminado es 50.
• --offset <n> : resultados a omitir. El valor predeterminado es 0.

Ejemplo

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

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. Se debe proporcionar al menos uno de estos campos.

Argumentos

Nada.

Opciones

• --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.
• --precondition <text> — nuevo texto de condición previa.
• --postcondition <text> — nuevo texto de condición posterior.

Ejemplo

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

Forma de datos

{
  "Code": "TestCaseUpdate",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Name": "Login smoke (2026)",
    "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 (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 una automatización de Orchestrator a un caso de prueba por su UUID de automatización. Esto es lo que hace que el caso de prueba sea ejecutable dentro de un conjunto de pruebas. Ejecuta testcases list-automations para descubrir el --automation-id para una carpeta determinada.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --test-case-key <key> (obligatorio) : caso de prueba para vincular.
• --automation-id <uuid> obligatorio) : UUID de la automatización de Orchestrator (punto de entrada del paquete). Obtener esto de uip tm testcases list-automations.

Ejemplo

uip tm testcases link-automation \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --automation-id f0f0f0f0-0000-0000-0000-000000000001

Forma de datos

{
  "Code": "TestCaseLinkAutomation",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "AutomationId": "f0f0f0f0-0000-0000-0000-000000000001",
    "Result": "Linked"
  }
}

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

• --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. Ejecuta esto para descubrir el valor --automation-id para pasar a link-automation.

Argumentos

Nada.

Opciones

• (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 \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001

Forma de datos

{
  "Code": "TestAutomationsList",
  "Data": [
    {
      "AutomationId": "f0f0f0f0-0000-0000-0000-000000000001",
      "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-id <uuid> obligatorio) : UUID interno del caso de prueba (no la clave PROJECT:N ). Obtenlo de testcases list o de una respuesta TestCaseCreate .

Ejemplo

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

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 una nueva ejecución para uno o más casos de prueba directamente, sin crear primero un conjunto de pruebas. La CLI crea un conjunto de pruebas temporal, lo ejecuta y devuelve el ExecutionId.

Argumentos

Nada.

Opciones

• --project-key <key> (obligatorio) : proyecto propietario.
• --test-case-id <uuid...> obligatorio) : uno o más UUID de casos de prueba para ejecutar (separados por espacios).
• --name <name> (obligatorio) : nombre para la nueva ejecución.
• --execution-type <type> (obligatorio) : qué casos de prueba ejecutar: automated, manual, mixed o none.
• --async : devuelve inmediatamente después de poner en cola sin sondeo.
• --folder-key <uuid> — Carpeta de Orchestrator en la que se ejecutará.
• --runtime-type <type> — tipo de runtime de robot (por ejemplo, Unattended).
• --robot-user-key <uuid> : usuario de robot para asignar.
• --machine-key <uuid> : máquina a asignar.
• --host-machine-name <name> : nombre de la máquina host.
• --service-user-name <name> — nombre de usuario del servicio.
• --test-set-packages <json> — Matriz JSON de anulaciones de paquetes: [{"packageName":"Pkg","version":"1.0.0"}].

Ejemplo

uip tm testcases run \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --execution-type automated \
  --name "Smoke run"

Forma de datos

{
  "Code": "TestCaseRun",
  "Data": {
    "ExecutionId": "b2c3d4e5-0000-0000-0000-000000000001",
    "Status": "Running",
    "StartTime": "2025-04-15T10:30:00Z"
  }
}

añadir casos de prueba de uip tm

Añade uno o más casos de prueba a un conjunto de pruebas existente.

Argumentos

Nada.

Opciones

• --test-set-key <key> (obligatorio) : clave del objeto del conjunto de pruebas (por ejemplo, DEMO:42).
• --test-case-keys <keys> (obligatorio) : claves de casos de prueba separadas por comas para añadir (por ejemplo, DEMO:1,DEMO:2).

Ejemplo

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

Forma de datos

{
  "Code": "TestSetAddTestCases",
  "Data": {
    "TestSetKey": "DEMO:42",
    "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.

Argumentos

Nada.

Opciones

• --test-set-key <key> (obligatorio) : clave del 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

• --project-key <key> (obligatorio) : proyecto propietario.
• --test-case-id <uuid> obligatorio) : UUID interno del caso de prueba.

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

• --project-key <key> (obligatorio) : proyecto propietario.
• --test-case-id <uuid> obligatorio) : UUID interno del caso de prueba.

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

• --project-key <key> (obligatorio) : proyecto propietario.
• --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

• --project-key <key> (obligatorio) : proyecto propietario.
• --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 que se copiarán 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": [
    {
      "Id": "d4e5f6a7-0000-0000-0000-000000000001",
      "OrderNo": 0,
      "Description": "Open login page",
      "ExpectedResult": "Login form is displayed"
    }
  ]
}

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

• --project-key <key> (obligatorio) : proyecto propietario.
• --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

• --project-key <key> (obligatorio) : proyecto propietario.
• --step-id <uuid> obligatorio) : UUID del paso de prueba.
• --target-position <n> (obligatorio) : nueva posición basada en 0 (0 = primero). 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

• --project-key <key> (obligatorio) : proyecto propietario.
• --step-id <uuid> obligatorio) : UUID del paso de prueba.
• -y, --yes : omite la solicitud de confirmación. Necesario en entornos no interactivos.

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 en testcaselog, 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 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

Señala el inicio de una entrada de registro de caso de prueba manual para un caso de prueba específico dentro de una ejecución.

Argumentos

Nada.

Opciones

• --execution-id <uuid> (obligatorio) : la ejecución en la que se ejecuta el caso de prueba.
• --test-case-id <uuid> obligatorio) : UUID interno del caso de prueba que se está registrando.
• --execution-type <type> : tipo de ejecución para la entrada de registro (por ejemplo, automated, manual). Opcional.

Ejemplo

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

Forma de datos

{
  "Code": "TestCaseLogStart",
  "Data": {
    "TestCaseLogId": "c3d4e5f6-0000-0000-0000-000000000001",
    "Status": "InProgress"
  }
}

uip tm testcaselog finish

Señala el final de una entrada de registro de caso de prueba iniciada manualmente.

Argumentos

Nada.

Opciones

• --test-case-log-id <uuid> (obligatorio) : el ID de registro devuelto por testcaselog start.
• --info <text> — mensaje de error o informativo opcional para adjuntar a la entrada de registro.

Ejemplo

uip tm testcaselog finish \
  --test-case-log-id c3d4e5f6-0000-0000-0000-000000000001 \
  --info "Login button not found on page"

Forma de datos

{
  "Code": "TestCaseLogFinish",
  "Data": {
    "TestCaseLogId": "c3d4e5f6-0000-0000-0000-000000000001",
    "Result": "Finished"
  }
}

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