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. Ele transforma 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 <ms>] [--poll-interval <ms>]

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 em um intervalo configurável.

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.
• — chave do conjunto DEMO:42 --test-set-key <key> ; a chave do projeto é derivada do prefixo.
• --timeout <ms> tempo máximo para esperar, em milissegundos. O padrão é 1800000 (30 minutos). Transmita 0 para aguardar indefinidamente.
• --poll-interval <ms> — com que frequência pesquisar o status de execução, em milissegundos. O padrão é 60000 (60 segundos).
• -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

# wait up to 15 minutes, polling every 30 seconds
uip tm wait \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO \
  --timeout 900000 \
  --poll-interval 30000

Formato dos dados — a execução atingiu o 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.

Padrão do script

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