execuções uip tm

uip tm executions inspeciona e manipula execuções de teste — os objetos produzidos por uip tm testsets run. Esses verbos listam execuções para um conjunto de testes, enumeram os logs de casos de teste de uma execução concluída, executam novamente uma execução existente por ID e tentam novamente apenas os casos com falha no local.

O comando que inicia uma execução é uip tm testsets run, que retorna um ExecutionId. Cada verbo nessa página leva esse ID (ou o deriva do contexto).

Resumo

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 os verbos honram as opções globais e os códigos de saída padrão. Cada verbo aceita -t, --tenant <name> e --log-level <level> (padrão Information).

lista de execuções uip tm

Liste as execuções associadas a um conjunto de testes. é --test-set-id — omita-o para listar execuções em todos os conjuntos de testes no projeto.

Argumentos

Nenhum.

Opções

• --project-key <key> (necessário) — possuindo projeto.
• --test-set-id <uuid> o conjunto de testes UUID (o campo Id de testsets list, não TestSetKey).
• --filter <text> pesquisar execuções por nome.
• --limit <n> — tamanho da página. O padrão é 50.
• --offset <n> — resultados a ignorar. O padrão é 0.

Exemplo

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

Formato dos dados

{
  "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"
    }
  ]
}

execuções uip tm filtradas por lista

Liste execuções usando filtros avançados no lado do servidor. Observação: --status e --execution-type são sinalizadores de valor único e único. A filtragem de intervalo de datas é feita por meio de --execution-finished-interval, não de sinalizadores de datas.

Argumentos

Nenhum.

Opções

• --project-key <key> (necessário) — possuindo projeto.
• --status <status> filtrar por um único status de execução. Os valores aceitos vêm do enum TestExecutionStatus do SDK. Execute --help para ver o conjunto atual.
• --execution-type <type> filtrar por um único tipo de execução (automated, manual, mixed, none).
• --execution-finished-interval <interval> — filtre por quão recentemente a execução foi finalizada. Os valores aceitos vêm do enum TestExecutionFinishedInterval do SDK.
• --updated-by <userId> — filtrar pelo ID do usuário que atualizou a execução pela última vez.
• — pesquisa de texto --search <text> sobre nomes de execução e metadados.
• --labels <labels...> — nomes de rótulos separados por espaço para filtrar.
• --test-execution-ids <ids...> UUIDs de execução separados por espaço a serem incluídos.
• --sort-by <expr> — expressão de classificação (nome do campo, sufixado opcionalmente com :asc ou :desc).
• --limit <n> — tamanho da página. O padrão é 50.
• --offset <n> — resultados a ignorar. O padrão é 0.

Exemplo

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

Formato dos dados

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

lista de execuções uip tm logs de caso de teste

Lista os logs de casos de teste produzidos por uma única execução. Cada log é uma execução de um caso de teste, carregando resultado, status e tempo.

Argumentos

Nenhum.

Opções

• --execution-id <uuid> necessário) — execução para inspecionar.
• --project-key <key> (necessário) — possuindo projeto.
• --only-failed — mostrar apenas logs com falha.
• --filter <text> pesquisar logs por nome.
• --limit <n> — tamanho da página. O padrão é 50.
• --offset <n> — resultados a ignorar. O padrão é 0.

Exemplo

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

Formato dos dados

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

Cada Id é um UUID de log de caso de teste. Feed-o para uip tm testcaselog list-assertions para ver por que um log de caso de teste foi marcado Failed.

execuções uip tm run

Execute novamente uma execução existente por seu ID. Isso não é o mesmo que iniciar uma nova execução — ela é repetida dentro do mesmo registro de execução, segmentando todos os casos de teste ou um subconjunto específico.

Observação:

Para iniciar uma nova execução, use uip tm testsets run em vez disso.

Argumentos

Nenhum.

Opções

• --project-key <key> (necessário) — possuindo projeto.
• --execution-id <uuid> necessário) — ID da execução existente a ser executada novamente.
• --execution-type <type> (necessário) — quais casos de teste executar (automated, manual, mixed, none).
• --test-case-log-ids <ids...> UUIDs de log de casos de teste separados por espaço. Quando fornecido, apenas esses logs específicos são executados novamente.
• --async retorne imediatamente após a fila sem esperar confirmação.

Exemplos

# 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

Formato dos dados

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

nova tentativa de execuções uip tm

Tentar novamente apenas os casos de teste com falha de uma execução concluída, no local. O comando busca as estatísticas da execução e se recusa a prosseguir, a menos que a execução esteja em um estado terminal. Se houver zero casos com falha, ele 0 com uma mensagem. A nova tentativa reutiliza o mesmo ID de execução; ele não cria um novo.

Argumentos

Nenhum.

Opções

• --execution-id <uuid> necessário) — execução para tentar novamente.
• --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.
• --execution-type <type> — tipo de execução para a nova tentativa: automated (padrão), manual, mixed ou none.

Exemplo

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

Formato dos dados — quando há falhas para tentar novamente

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

Formato dos dados — quando não há falhas para tentar novamente

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

execuções uip tm get-stats

Obtenha uma execução de teste pelo ID com contagens agregadas de aprovação/falha/nenhuma. Use isso para ler o veredicto de uma execução concluída sem buscar o relatório completo.

Argumentos

Nenhum.

Opções

• --execution-id <uuid> (necessário) — UUID de execução de teste.
• --project-key <key> (necessário) — possuindo projeto.

Exemplo

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

Formato dos dados

{
  "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 saída

O padrão de CI padrão é um pipeline de três etapas:

1. Iniciar — uip tm testsets run retorna um ExecutionId e sai de 0.
2. Bloquear — uip tm wait faz pesquisas até que a execução atinja um estado terminal. Sai 0 quando concluído, 2 no tempo limite, 1 em caso de falha.
3. Veredicto — uip tm report get lê Passed / Failed contagens. Seu script falha na compilação explicitamente.

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

• conjuntos de testes executados — inicie uma execução.
• Wait — bloqueie até que uma execução atinja um estado terminal.
• relatório, resultado, anexo — artefatos pós-execução.
• testcases — testcaselog list-assertions transforma um log com falha em detalhes por asserção.

Veja também

• Visão geral do Test Manager
• Códigos de saída
• Padrões de script