Ejecuciones de uip tm

Sintaxis y opciones para `ejecuciones de uip tm`, que enumera, filtra y reintenta ejecuciones de prueba, e inspecciona los registros de casos de prueba de una ejecución finalizada.

uip tm executions inspecciona y manipula las ejecuciones de prueba: los objetos producidos por uip tm testsets run. Estos verbos enumeran las ejecuciones para un conjunto de pruebas, enumeran los registros de casos de prueba de una ejecución finalizada, vuelven a ejecutar una ejecución existente por ID y reintentan solo los casos fallidos en su lugar.

El comando que inicia una ejecución es uip tm testsets run, que devuelve un ExecutionId. Cada verbo de esta página toma ese ID (o lo deriva del contexto).

Sinopsis

uip tm executions list --project-key <key> [--test-set-id <uuid>] [--filter <text>] [--status <status>] [--execution-type <type>] [--execution-finished-interval <interval>] [--limit <n>] [--offset <n>]
uip tm executions list-filtered --project-key <key> [--test-set-id <uuid>] [--status <status>] [--execution-type <type>] [--execution-finished-interval <interval>] [--updated-by <userId>] [--search <text>] [--labels <labels...>] [--test-execution-ids <ids...>] [--sort-by <expr>] [--limit <n>] [--offset <n>]
uip tm executions testcaselogs list --execution-id <uuid> --project-key <key> [--only-failed] [--filter <text>] [--results <results...>] [--statuses <statuses...>] [--duration-period <period>] [--limit <n>] [--offset <n>]
uip tm executions run --project-key <key> --execution-id <uuid> --execution-type <type> [--test-case-log-ids <ids...>] [--async]
uip tm executions retry --execution-id <uuid> (--project-key <key> | --test-set-key <key>) [--execution-type <type>]
uip tm executions get-stats --execution-id <uuid> --project-key <key>

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

Nota:

--log-level no está disponible de forma uniforme en esta página. retry, testcaselogs list, list y list-filtered lo aceptan. get-stats y run no aceptan ningún marcador.

lista de ejecuciones de uip tm

Enumera las ejecuciones asociadas a un conjunto de pruebas. --test-set-id es opcional: omítelo para enumerar las ejecuciones en todos los conjuntos de pruebas del proyecto.

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Obligatorio. Proyecto propietario.
--test-set-id <uuid>	UUID del conjunto de pruebas (el campo Id de testsets list, no TestSetKey).
--filter <text>	Buscar ejecuciones por nombre.
--status <status>	Filtrar por un solo estado de ejecución. Los valores aceptados provienen del SDK TestExecutionStatus enum: ejecuta --help para el conjunto actual.
--execution-type <type>	Filtrar por un solo tipo de ejecución (automated, manual, mixed, none).
--execution-finished-interval <interval>	Filtrar por qué tan recientemente finalizó la ejecución. Los valores aceptados provienen de la enumeración SDK TestExecutionFinishedInterval.
--limit <n>	Tamaño de la página. El valor predeterminado es 50.
--offset <n>	Resultados para omitir. El valor predeterminado es 0.

Ejemplo

uip tm executions list \
  --project-key DEMO \
  --test-set-id a1b2c3d4-0000-0000-0000-000000000001 \
  --limit 2

Forma de datos

{
  "Code": "ExecutionsList",
  "Data": [
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000001",
      "Name": "Nightly Run 2025-04-15",
      "Status": "Passed"
    },
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000002",
      "Name": "Nightly Run 2025-04-14",
      "Status": "Failed"
    }
  ]
}

Ejecuciones de uip tm filtradas por lista

Enumera las ejecuciones utilizando filtros avanzados del lado del servidor. Nota: --status y --execution-type son marcadores singulares de valor único. El filtrado del intervalo de fechas se realiza a través de --execution-finished-interval, no de marcadores de fecha.

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Obligatorio. Proyecto propietario.
--test-set-id <uuid>	Limita los resultados a un solo UUID del conjunto de pruebas.
--status <status>	Filtrar por un solo estado de ejecución. Los valores aceptados provienen del SDK TestExecutionStatus enum: ejecuta --help para el conjunto actual.
--execution-type <type>	Filtrar por un solo tipo de ejecución (automated, manual, mixed, none).
--execution-finished-interval <interval>	Filtrar por qué tan recientemente finalizó la ejecución. Los valores aceptados provienen de la enumeración SDK TestExecutionFinishedInterval.
--updated-by <userId>	Filtrar por el ID de usuario que actualizó la ejecución por última vez.
--search <text>	Búsqueda de texto libre sobre nombres de ejecución y metadatos.
--labels <labels...>	Nombres de etiquetas separados por espacios por los que filtrar.
--test-execution-ids <ids...>	UUID de ejecución separados por espacios que se incluirán.
--sort-by <expr>	Expresión de ordenación (nombre del campo, opcionalmente con el sufijo :asc o :desc).
--limit <n>	Tamaño de la página. El valor predeterminado es 50.
--offset <n>	Resultados para omitir. El valor predeterminado es 0.

Ejemplo

uip tm executions list-filtered \
  --project-key DEMO \
  --status Failed \
  --execution-type automated \
  --limit 10

Forma de datos

{
  "Code": "ExecutionsListFiltered",
  "Data": [
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000002",
      "Name": "Nightly Run 2025-04-14",
      "Status": "Failed",
      "ExecutionType": "automated"
    }
  ]
}

Lista de registros de casos de prueba de ejecuciones de uip tm

Enumera los registros de casos de prueba producidos por una sola ejecución. Cada registro es una ejecución de un caso de prueba, con resultado, estado y tiempo.

Argumentos

Nada.

Opciones

Marca	Descripción
--execution-id <uuid>	Obligatorio. Ejecución que se va a inspeccionar.
--project-key <key>	Obligatorio. Proyecto propietario.
--only-failed	Mostrar solo registros fallidos.
--filter <text>	Buscar registros por nombre.
--results <results...>	Lista de resultados separados por espacios por los que filtrar (del SDK Result enum, por ejemplo Passed, Failed).
--statuses <statuses...>	Lista separada por espacios de estados de ejecución por los que filtrar (del SDK TestCaseLogExecutionStatus enum).
--duration-period <period>	Filtrar por cuánto tiempo hace que se ejecutó el registro (desde la enumeración DurationPeriod del SDK, por ejemplo last7Days).
--limit <n>	Tamaño de la página. El valor predeterminado es 50.
--offset <n>	Resultados para omitir. El valor predeterminado es 0.

Ejemplo

uip tm executions testcaselogs list \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO \
  --only-failed

Forma de datos

{
  "Code": "ExecutionTestCaseLogs",
  "Data": [
    {
      "Id": "c3d4e5f6-0000-0000-0000-000000000001",
      "TestCaseName": "Login flow",
      "Status": "Finished",
      "Result": "Failed"
    }
  ]
}

Cada Id es un UUID de registro de casos de prueba. Envíalo a uip tm testcaselog list-assertions para ver por qué un registro de caso de prueba se marcó como Failed.

ejecuciones de uip tm

Vuelve a ejecutar una ejecución existente por su ID. Esto no es lo mismo que iniciar una nueva ejecución: se reproduce dentro del mismo registro de ejecución, apuntando a todos los casos de prueba o a un subconjunto específico.

Nota:

Para iniciar una nueva ejecución, utiliza uip tm testsets run en su lugar.

Argumentos

Nada.

Opciones

Marca	Descripción
--project-key <key>	Obligatorio. Proyecto propietario.
--execution-id <uuid>	Obligatorio. ID de la ejecución existente que se va a volver a ejecutar.
--execution-type <type>	Obligatorio. Qué casos de prueba ejecutar (automated, manual, mixed, none).
--test-case-log-ids <ids...>	UUID de registro de casos de prueba separados por espacios. Cuando se proporcionan, solo se vuelven a ejecutar esos registros específicos.
--async	Regrese inmediatamente después de la cola sin esperar el reconocimiento.

Ejemplos

# re-run the entire execution
uip tm executions run \
  --project-key DEMO \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --execution-type automated

# re-run specific failed logs only
uip tm executions run \
  --project-key DEMO \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --execution-type automated \
  --test-case-log-ids c3d4e5f6-0000-0000-0000-000000000001 c3d4e5f6-0000-0000-0000-000000000002

Forma de datos

{
  "Code": "ExecutionRun",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Succeeded"
  }
}

Status: "Succeeded" aquí refleja que se ha aceptado la solicitud de ejecución, no que se hayan superado los casos de prueba: se devuelve de la misma manera tanto si --async está establecido como si no. Comprueba el resultado real de aprobación/error con get-stats o wait.

reintento de ejecuciones de uip tm

Reintentar solo los casos de prueba fallidos de una ejecución completada, en su lugar. El comando obtiene las estadísticas de la ejecución y se niega a continuar a menos que la ejecución esté en un estado terminal. Si no hay casos fallidos, sale 0 con un mensaje. El reintento reutiliza el mismo ID de ejecución; no crea uno nuevo.

Argumentos

Nada.

Opciones

Marca	Descripción
--execution-id <uuid>	Obligatorio. Ejecución para reintentar.
--project-key <key>	Proyecto propietario. Se requiere esto o --test-set-key.
--test-set-key <key>	Clave del conjunto de pruebas (por ejemplo, DEMO:42); la clave del proyecto se deriva del prefijo.
--execution-type <type>	Tipo de ejecución para el reintento: automated (predeterminado), manual, mixed o none.

Ejemplo

uip tm executions retry \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO

Forma de datos: cuando hay fallos para reintentar

{
  "Code": "ExecutionRetry",
  "Data": {
    "ExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Running",
    "StartTime": "2025-04-15T10:30:00Z",
    "RetriedCount": 3
  }
}

Forma de datos: cuando no hay fallos para reintentar

{
  "Code": "ExecutionRetry",
  "Data": {
    "Message": "Execution 'a1b2c3d4-0000-0000-0000-000000000001' has no failed test cases to retry."
  }
}

Ejecuciones de uip tm get-stats

Obtenga una ejecución de prueba por ID con todos sus campos de ejecución más los recuentos agregados de aprobado/fallido/ninguno. Úsalo cuando necesites el registro de ejecución sin procesar con estadísticas, por ejemplo, para comprobar si una ejecución ha finalizado antes de report get llamar, o para extraer datos de tiempo y cobertura para informes externos.

Argumentos

Nada.

Opciones

Marca	Descripción
--execution-id <uuid>	Obligatorio. UUID de ejecución de prueba. Obtener esto de uip tm testsets run o uip tm testcases run.
--project-key <key>	Obligatorio. Clave de proyecto de Test Manager (por ejemplo, DEMO).

Ejemplo

uip tm executions get-stats \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO

Forma de datos

{
  "Code": "ExecutionStats",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Nightly Run 2025-04-15",
    "Description": "Smoke + regression suite",
    "Status": "Finished",
    "ExecutionType": "automated",
    "Source": "Manual",
    "SourceDetails": "",
    "ProjectId": "00000000-0000-0000-0000-000000000abc",
    "TestSetId": "a1b2c3d4-0000-0000-0000-000000000010",
    "TestSetObjKey": "DEMO:10",
    "TestSetScheduleId": "",
    "BatchExecutionKey": "",
    "Passed": 8,
    "Failed": 2,
    "None": 0,
    "Duration": 3600000,
    "RunId": 12,
    "EnforceExecutionOrder": false,
    "EnableCoverage": false,
    "IsRunningAutomated": false,
    "HasTestsFromMultipleAutomationProjects": false,
    "RemoteControlAccess": "Disabled",
    "ExecutionStart": "2025-04-15T10:00:00Z",
    "ExecutionFinished": "2025-04-15T11:00:00Z",
    "ReportingDate": "2025-04-15T11:00:00Z",
    "FolderKey": "11111111-2222-3333-4444-555555555555",
    "Created": "2025-04-15T09:55:00Z",
    "CreatedBy": "11111111-2222-3333-4444-555555555555",
    "Updated": "2025-04-15T11:00:00Z",
    "UpdatedBy": "11111111-2222-3333-4444-555555555555",
    "AutopilotForRobotsSettings": { "Enabled": false },
    "OrderedExecutionSettings": { "Enabled": false },
    "VideoRecordingSettings": { "Enabled": false }
  }
}

Campos clave:

• Passed, Failed, None: recuentos de registros de casos de prueba agregados para la ejecución.
• Duration: duración total de la ejecución en milisegundos.
• Status — el estado de ejecución. Cuando Finished, los recuentos Passed/Failed/None son finales.
• IsRunningAutomated — true mientras los casos de prueba automatizados aún se envían a los robots.

Nota:

get-stats devuelve el registro de ejecución sin procesar con recuentos. Para obtener un resumen formateado con mensajes de error por caso de prueba, utiliza uip tm report get en su lugar.

Códigos de salida

El patrón de CI estándar es un proceso de tres pasos:

1. Iniciar : uip tm testsets run devuelve un ExecutionId y sale de 0.
2. Bloquear : uip tm wait sondea hasta que la ejecución alcanza un estado terminal. Sale de 0 cuando finaliza, 2 en tiempo de espera, 1 en caso de error.
3. Veredicto : uip tm report get lee Passed / Failed cuenta. Tu script falla la compilación explícitamente.

id=$(uip tm testsets run \
  --test-set-key DEMO:10 \
  --execution-type automated \
  --output-filter .Data.ExecutionId)

if ! uip tm wait --execution-id "$id" --project-key DEMO --timeout 1800; then
  code=$?
  [ "$code" -eq 2 ] && { echo "timed out" >&2; exit 2; }
  echo "wait failed ($code)" >&2; exit "$code"
fi

failed=$(uip tm report get \
  --execution-id "$id" --project-key DEMO --output-filter .Data.Failed)
[ "$failed" -gt 0 ] && { echo "$failed test(s) failed" >&2; exit 1; }
echo "all passed"

Relacionado

• ejecución de conjuntos de pruebas : inicia una ejecución.
• esperar : bloquea hasta que una ejecución alcanza un estado terminal.
• informe, resultado, archivo adjunto : artefactos posteriores a la ejecución.
• casos de prueba : testcaselog list-assertions convierte un registro fallido en detalles por aserción.

Ver también

• Descripción general de Test Manager
• Códigos de salida
• Patrones de scripting