Esperar UIP TTM

uip tm wait uma execução de teste até que ela atinja um estado terminal (Passed, Failed, Cancelled, etc.) e, em seguida, imprima um resumo de uma linha. Use-a para transformar o uip tm testsets run assíncrono em uma etapa de bloqueio em um pipeline de CI.

wait está registrado como um verbo de nível superior sob tm, não como um recurso — invoque-o como uip tm wait, não uip tm executions wait.

Resumo

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

Recebe as opções globais. Consulte a seção Códigos de saída abaixo para obter o comportamento específico do domínio no tempo limite.

Esperar UIP TTM

Bloquear até que a execução determinada atinja um estado terminal, pesquisando o Test Manager uma vez a cada 60 segundos.

Argumentos

Nenhum.

Opções

• --execution-id <uuid> necessário) — execução para aguardar. Obtenha-o de uip tm testsets run.
• --project-key <key> — proprietário do projeto. Ou isso ou --test-set-key é necessário.
• --test-set-key <key> chave do conjunto de testes (por exemplo DEMO:42); a chave do projeto é derivada do prefixo.
• --timeout <seconds> — máximo de segundos para esperar. O padrão é 1800 (30 minutos). Transmita 0 para aguardar indefinidamente.
• -t, --tenant <name> substitua o tenant da sessão ativa para esta chamada.
• --log-level <level> — debug, info, warn, error. O padrão é Information.

Exemplo

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

Formato dos dados — quando a execução atinge um estado terminal antes do tempo limite:

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

pode ser qualquer relatório do Test Manager Passed Status Failed, Cancelled). "Atingiu um estado terminal" é o sinal de sucesso para wait — o verbo sai 0 independentemente de os testes dentro da execução serem aprovados ou falhados. Para ramificar em aprovação/falha, leia a saída report get após o retorno de wait .

Códigos de saída

wait segue os códigos de saída padrão para 0, 1 e 3, com uma reutilização específica do domínio de 2:

Código de saída	Significado
0	A execução atingiu um estado terminal dentro do tempo limite.
1	Falha na pesquisa (erros de API repetidos, interrupção, anulação) — consulte o campo para Message detalhes.
2	Tempo esgotado. O tempo limite decorrido antes que a execução atingsse um estado terminal.
3	Erro de validação (valor de sinalizador incorreto, opção obrigatória ausente).

O código de saída 2 é específico do domínio. O contrato da CLI compartilhada reserva 2 para AuthenticationError, mas wait reutiliza-o para o tempo limite, para que os scripts possam distinguir " demorou muito" de "a pesquisa realmente falhou" sem analisar o texto. Consulte Comportamento do código de saída em executions para obter o padrão completo.

Script pattern

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 testes — produz o ExecutionId para aguardar.
• relatório — resumo a ser lido quando wait retornar 0.
• resultado — Exportação XML JUnit.
• Nova tentativa de execuções — execute novamente os casos com falha de uma execução concluída.

Veja também

• Visão geral do Test Manager
• Códigos de saída — contrato compartilhado.
• Padrões de script — o pipeline iniciar-aguardar-verificar.