esperar uip tm

uip tm wait sondea una ejecución de prueba hasta que alcanza un estado terminal (Passed, Failed, Cancelled, etc.) y luego imprime un resumen de una línea. Úsalo para convertir el uip tm testsets run asíncrono en un paso de bloqueo en un proceso de CI.

wait está registrado como un verbo de nivel superior en tm, no como un recurso; invócalo como uip tm wait, no uip tm executions wait.

Sinopsis

uip tm wait --execution-id <uuid> (--project-key <key> | --test-set-key <key>) [--timeout <seconds>]

Respeta las opciones globales. Consulta la sección Códigos de salida a continuación para ver el comportamiento específico del dominio en el tiempo de espera.

esperar uip tm

Bloquea hasta que la ejecución dada alcance un estado terminal, sondeando Test Manager una vez cada 60 segundos.

Argumentos

Nada.

Opciones

• --execution-id <uuid> (obligatorio) : ejecución a esperar. Obtenlo de uip tm testsets run.
• --project-key <key> — proyecto propietario. Se requiere esto o --test-set-key .
• --test-set-key <key> : clave del conjunto de pruebas (p. ej. DEMO:42); la clave del proyecto se deriva del prefijo.
• --timeout <seconds> : máximo de segundos de espera. El valor predeterminado es 1800 (30 minutos). Pase 0 para esperar indefinidamente.
• -t, --tenant <name> — anula el tenant de la sesión activa para esta llamada.
• --log-level <level> — debug, info, warn, error. El valor predeterminado es Information.

Ejemplo

uip tm wait \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO \
  --timeout 900

Forma de datos : cuando la ejecución alcanza un estado terminal antes del tiempo de espera:

{
  "Code": "WaitComplete",
  "Data": {
    "ExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Passed",
    "EndTime": "2025-04-15T10:32:11Z",
    "Duration": "00:02:11"
  }
}

Status puede ser cualquier informe de Test Manager de estado terminal (incluidos Passed, Failed, Cancelled). "Se ha alcanzado un estado terminal" es la señal de éxito para wait : el verbo sale 0 independientemente de si las pruebas dentro de la ejecución pasaron o fallaron. Para ramificar en aprobado/fallo, lee la salida report get después de que wait devuelva.

Códigos de salida

wait sigue los códigos de salida estándar para 0, 1 y 3, con una reutilización específica del dominio de 2:

Código de salida	Significado
0	La ejecución alcanzó un estado terminal dentro del tiempo de espera.
1	Error en el sondeo (errores de API repetidos, interrupción, cancelación): consulta el campo Message para obtener más información.
2	Se agotó el tiempo de espera. El tiempo de espera transcurrido antes de que la ejecución alcanzara un estado terminal.
3	Error de validación (valor de marcador incorrecto, falta la opción obligatoria).

El código de salida 2 es específico del dominio. El contrato CLI compartido reserva 2 para AuthenticationError, pero wait lo reutiliza para el tiempo de espera, de modo que los scripts puedan distinguir "tardó demasiado" de "el sondeo realmente falló" sin analizar el texto. Consulta Comportamiento del código de salida en executions para ver el patrón completo.

Patrón de script

if ! uip tm wait --execution-id "$id" --project-key DEMO --timeout 1800; then
  case $? in
    2) echo "timed out" >&2; exit 2 ;;
    *) echo "wait failed" >&2; exit 1 ;;
  esac
fi

Relacionado

• conjuntos de pruebas ejecutados : produce el ExecutionId a esperar.
• informe : resumen para leer una vez wait devuelve 0.
• resultado : exportación XML de JUnit.
• reintento de ejecuciones : vuelve a ejecutar los casos fallidos de una ejecución finalizada.

Ver también

• Descripción general de Test Manager
• Códigos de salida : contrato compartido.
• Patrones de scripting : el proceso de lanzamiento-espera-verificación.