uip tm testsets

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.

uip tm testsets create

Create an empty test set in a project. Use testcases add afterwards to populate it.

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

uip tm testsets list

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.

uip tm testsets update

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

uip tm testsets delete

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

uip tm testsets list-testcases

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

uip tm testsets run

Run a test set and return its ExecutionId immediately. The test set itself must already be configured with a package and folder — either by authoring inside Test Manager's web UI, or by hand via the REST API. Run does not block; pair it with uip tm wait in 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:

The returned Status reflects the state at launch (typically Running); it does not mean the run has succeeded. To get the run outcome, block on uip tm wait and then read uip tm report get. Exit-code behavior for the combined launch-and-wait flow is documented on uip tm executions. See the Related section below for the wait and report references.

Relacionado

• testcases — create and link the test cases that populate a test set.
• executions — list and retry executions once a test set has been run.
• 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.