Ejecuciones de uip tm

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>] [--limit <n>] [--offset <n>]
uip tm executions list-filtered --project-key <key> [--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>] [--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. Cada verbo acepta -t, --tenant <name> y --log-level <level> (predeterminado Information).

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

• --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> : busca ejecuciones por nombre.
• --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 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

• --project-key <key> (obligatorio) : proyecto propietario.
• --status <status> : filtrar por un único estado de ejecución. Los valores aceptados provienen del enum SDK TestExecutionStatus . Ejecuta --help para ver 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 del enum 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 para 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 a 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": "ExecutionsFilteredList",
  "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

• --execution-id <uuid> (obligatorio) : ejecución para inspeccionar.
• --project-key <key> (obligatorio) : proyecto propietario.
• --only-failed : muestra solo los registros fallidos.
• --filter <text> : buscar registros por nombre.
• --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 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

• --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 : volver inmediatamente después de la cola sin esperar a la confirmación.

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": {
    "ExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Running",
    "StartTime": "2025-04-15T10:30:00Z"
  }
}

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

• --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 su ID con recuentos agregados de aprobado/fallo/ninguno. Utilízalo para leer el veredicto final de una ejecución finalizada sin obtener el informe completo.

Argumentos

Nada.

Opciones

• --execution-id <uuid> (obligatorio) : UUID de ejecución de prueba.
• --project-key <key> (obligatorio) : proyecto propietario.

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",
    "Status": "Finished",
    "ExecutionType": "automated",
    "Passed": 8,
    "Failed": 2,
    "None": 0,
    "ExecutionStart": "2025-04-15T10:00:00Z",
    "ExecutionFinished": "2025-04-15T11:00:00Z"
  }
}

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 \
  --project-key DEMO \
  --test-set-key DEMO:10 \
  --execution-type automated \
  --output-filter .Data.ExecutionId)

if ! uip tm wait --execution-id "$id" --project-key DEMO --timeout 1800000; 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