conjuntos de testes uip tm

Sintaxe e opções para "uip tm testsets", que gerencia as unidades de conjunto de testes executáveis que produzem execuções rastreadas no Test Manager.

uip tm testsets gerencia conjuntos de testes: a unidade executável no Test Manager. Um conjunto de testes é um grupo ordenado de casos de teste iniciados como um único comando e rastreados como uma única execução. Cada chamada testsets run retorna um ExecutionId que os outros verbos uip tm (wait, executions, report, result, attachment) recebem como entrada.

Resumo

uip tm testsets create --project-key <key> --name <name> [--description <text>]
uip tm testsets list --project-key <key> [--filter <text>]
uip tm testsets update --project-key <key> --test-set-key <key> [--name <name>] [--description <text>]
uip tm testsets delete --project-key <key> --test-set-key <key> [-y]
uip tm testsets list-testcases --project-key <key> --test-set-key <key> [--limit <n>] [--offset <n>]
uip tm testsets run --test-set-key <key> [--execution-type <type>] [--input-path <file>] [--wait [--timeout <seconds>] [--poll-interval <seconds>]]

Todos os verbos honram as opções globais e os códigos de saída padrão. Todo verbo aceita --log-level <level> (padrão Information).

criação de conjuntos de testes do uip tm

Crie um conjunto de testes vazio em um projeto.

Argumentos

Nenhum.

Opções

Bandeira	Description
--project-key <key>	Obrigatório. Proprietário do projeto.
--name <name>	Obrigatório. Nome do conjunto de testes.
--description <text>	Descrição de forma livre. O padrão é vazio.

Exemplo

uip tm testsets create \
  --project-key DEMO \
  --name "Smoke Suite" \
  --description "Core smoke tests"

Formato dos dados

{
  "Code": "TestSetCreate",
  "Data": {
    "TestSetKey": "DEMO:10",
    "Name": "Smoke Suite",
    "Description": "Core smoke tests"
  }
}

lista de conjuntos de testes uip tm

Listar conjuntos de testes em um projeto.

Argumentos

Nenhum.

Opções

Bandeira	Description
--project-key <key>	Obrigatório. Projeto a listar.
--filter <text>	Pesquisa no lado do servidor sobre o nome.

Exemplo

uip tm testsets list --project-key DEMO --filter smoke

Formato dos dados

{
  "Code": "TestSetsList",
  "Data": [
    {
      "TestSetKey": "DEMO:10",
      "Name": "Smoke Suite",
      "Id": "a1b2c3d4-0000-0000-0000-000000000010"
    }
  ]
}

Id é o UUID interno — necessário por executions list --test-set-id.

atualização de conjuntos de testes uip tm

Renomeie um conjunto de testes ou altere sua descrição. Pelo menos --name ou --description deve ser fornecido.

Argumentos

Nenhum.

Opções

Bandeira	Description
--project-key <key>	Obrigatório. Proprietário do projeto.
--test-set-key <key>	Obrigatório. Chave do conjunto de testes (por exemplo, DEMO:10).
--name <name>	Novo nome.
--description <text>	Nova descrição.

Exemplo

uip tm testsets update \
  --project-key DEMO \
  --test-set-key DEMO:10 \
  --name "Smoke Suite (2026)"

Formato dos dados

{
  "Code": "TestSetUpdate",
  "Data": {
    "TestSetKey": "DEMO:10",
    "Name": "Smoke Suite (2026)",
    "Description": "Core smoke tests",
    "Result": "Updated"
  }
}

exclusão de testes uip tm

Excluir um conjunto de testes pela sua chave.

Argumentos

Nenhum.

Opções

Bandeira	Description
--project-key <key>	Obrigatório. Proprietário do projeto.
--test-set-key <key>	Obrigatório. Chave do conjunto de testes (por exemplo, DEMO:10).
-y, --yes	Ignore o prompt de confirmação. Necessário em ambientes não interativos.

Exemplo

uip tm testsets delete --project-key DEMO --test-set-key DEMO:10 --yes

Formato dos dados

{
  "Code": "TestSetDelete",
  "Data": {
    "TestSetKey": "DEMO:10",
    "Id": "a1b2c3d4-0000-0000-0000-000000000010",
    "Result": "Deleted"
  }
}

testes em conjunto com o uip tm lista-casosdeteste

Lista os casos de teste atribuídos a um conjunto de testes.

Argumentos

Nenhum.

Opções

Bandeira	Description
--project-key <key>	Obrigatório. Proprietário do projeto.
--test-set-key <key>	Obrigatório. Conjunto de testes para inspecionar.
--limit <n>	Número máximo de resultados por página. O padrão é 50.
--offset <n>	Número de resultados a serem ignorados. O padrão é 0.

Exemplo

uip tm testsets list-testcases --project-key DEMO --test-set-key DEMO:10

Formato dos dados

{
  "Code": "TestSetTestCasesList",
  "Data": [
    {
      "TestCaseKey": "DEMO:1",
      "Name": "Login smoke",
      "Description": "Logs in and out"
    }
  ]
}

testes de conjuntos de uip tm executados

Execute um conjunto de testes e retorne seu ExecutionId. Por padrão, o comando retorna assim que a execução é enfileirada. Passe --wait para bloquear até que a execução atinja um estado terminal — isso combina as etapas de início e espera em um comando.

Argumentos

Nenhum.

Opções

Bandeira	Description
--test-set-key <key>	Obrigatório. Chave do objeto do conjunto de testes (por exemplo, DEMO:42). A chave do projeto é derivada do prefixo.
--execution-type <type>	Tipo de casos de teste a serem executados: automated (padrão), manual, mixed (tanto automatizado quanto manual), ou none (sem filtro de tipo).
--input-path <file>	Caminho para um arquivo JSON que contém substituições de parâmetros para a execução. [{"name":"Param","type":"String","value":"v"}]Formato:.
--wait	Bloqueie até que a execução atinja um estado terminal (finished, cancelled). Quando omitido, o comando retorna imediatamente após o preenchimento da fila.
--timeout <seconds>	Máximo de segundos para aguardar a conclusão da execução (0 sem tempo limite). Requer --wait.
--poll-interval <seconds>	Segundos entre verificações de status enquanto aguarda. Requer --wait.

Exemplos

# Fire-and-forget — returns ExecutionId immediately
uip tm testsets run --test-set-key DEMO:10

# Block until done — no need for a separate uip tm wait call
uip tm testsets run \
  --test-set-key DEMO:10 \
  --wait

# Block with a timeout and custom poll interval
uip tm testsets run \
  --test-set-key DEMO:10 \
  --execution-type automated \
  --wait \
  --timeout 900 \
  --poll-interval 15

# Pass parameter overrides from a file
uip tm testsets run \
  --test-set-key DEMO:10 \
  --input-path ./params.json \
  --wait

Formato dos dados

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

Observação:

Quando --wait é usado, Status reflete o estado terminal (Finished, Cancelled) em vez de Running. O ExecutionId retornado é o mesmo em ambos os casos e pode ser passado para uip tm report get, uip tm result download e uip tm attachment download.

Relacionado

• casos de teste — criar e vincular os casos de teste que preenchem um conjunto de testes.
• execuções — listar e repetir execuções depois que um conjunto de testes tiver sido executado.
• Wait — bloqueie até que um ExecutionId retornado atinja um estado terminal.
• relatório, resultado, anexo — artefatos pós-execução.

Veja também

• Visão geral do Test Manager
• Padrões de script