conjuntos de testes uip tm

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 que você pode executar com um comando e rastrear 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> [--folder-key <uuid>] [--filter <text>]
uip tm testsets update --test-set-key <key> [--name <name>] [--description <text>]
uip tm testsets delete --test-set-key <key>
uip tm testsets list-testcases --test-set-key <key>
uip tm testsets run --test-set-key <key> [--execution-type <type>] [--input-path <file>]

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).

Os verbos do conjunto de testes que levam --test-set-key derivam o projeto proprietário do prefixo da chave (por exemplo DEMO:10 → projeto DEMO), então, --project-key é necessário apenas em create e list.

criação de conjuntos de testes do uip tm

Crie um conjunto de testes vazio em um projeto. Use testcases add em seguida para preenchê-lo.

Argumentos

Nenhum.

Opções

• --project-key <key> (necessário) — possuindo projeto.
• --name <name> necessá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. As páginas da CLI através de resultados automaticamente.

Argumentos

Nenhum.

Opções

• --project-key <key> (necessário) — projeto à lista.
• --folder-key <uuid> restrinja a conjuntos de testes associados a essa pasta do Orchestrator. Aplicado no lado do cliente após a busca.
• --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",
      "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001",
      "Id": "a1b2c3d4-0000-0000-0000-000000000010"
    }
  ]
}

Id é o UUID interno — necessário, por exemplo, por execution 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

• (necessário) — chave do conjunto --test-set-key <key> testes (por exemplo DEMO:10).
• --name <name> novo nome.
• --description <text> nova descrição.

Exemplo

uip tm testsets update \
  --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

• --test-set-key <key> necessário) — chave do conjunto de testes.

Exemplo

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

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

• --test-set-key <key> necessário) — conjunto de teste para inspecionar.

Exemplo

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

Formato dos dados

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

testes de conjuntos de uip tm executados

Execute um conjunto de testes e retorne seu ExecutionId imediatamente. O próprio conjunto de testes já deve estar configurado com um pacote e pasta — criando dentro da interface gráfica da Web do Test Manager ou manualmente usando a API REST. Executar não bloqueia; emparelhá-lo com uip tm wait em scripts.

Argumentos

Nenhum.

Opções

• --test-set-key <key> necessário) — teste definido para ser executado. A chave do projeto é derivada do prefixo.
• — --execution-type <type> casos de teste executar. Um destes:
  • automated padrão) — apenas casos de teste automatizados.
  • manual apenas casos de teste manuais.
  • — mixed automatizado quanto manual.
  • none sem filtro de tipo.
• --input-path <file> — caminho para um arquivo JSON de substituições de parâmetros. O arquivo deve conter uma matriz em forma de [{"name":"Param","type":"String","value":"v"}]. As substituições são correspondidas com as definições de parâmetro atuais do conjunto de testes por name (e, quando presente, type), sem diferenciação entre maiúsculas e minúsculas. Se o servidor não relatar definições de parâmetros, as entradas serão enviadas como estão.

Exemplos

# simplest
uip tm testsets run --test-set-key DEMO:10

# with parameter overrides and manual execution
uip tm testsets run \
  --test-set-key DEMO:10 \
  --execution-type mixed \
  --input-path ./params.json

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:

O Status retornado reflete o estado no lançamento (normalmente Running); isso não significa que a execução foi bem-sucedida. Para obter o resultado da execução, bloqueie em uip tm wait e depois leia uip tm report get. O comportamento do código de saída para o fluxo combinado de iniciar e aguardar está documentado em uip tm executions. Consulte a seção Relacionada abaixo para as referências wait e report .

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 — Padrões compatíveis com CI para iniciar e verificar execuções.