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>] [--playwright-projects <names...>] [--wait [--timeout <seconds>] [--poll-interval <seconds>]]
uip tm testsets playwright-context --test-set-key <key>

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.
--folder-key <uuid>	Filtra pela chave da pasta do Orchestrator (de uip or folders list).
--filter <text>	Pesquisa no lado do servidor sobre o nome.
--include-last-execution	Adicione o status e o carimbo de data/hora da execução mais recente a cada conjunto de testes (consulte LastExecutionStatus/LastExecutionAt abaixo). Custa uma pesquisa extra por conjunto de testes.

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 executions list --test-set-id. Com --include-last-execution, cada entrada também recebe LastExecutionStatus e LastExecutionAt (ambas strings vazias se o conjunto de testes nunca tiver sido executado).

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:.
--playwright-projects <names...>	Defina o escopo da execução para um ou mais projetos do Playground empacotados por uip tm pack (separados por espaço, por exemplo, regression smoke). A seleção persiste no conjunto de testes, portanto, execuções posteriores do mesmo conjunto de testes não precisam repeti-la.
--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.

Observação:

--playwright-projects é uma opção oculta ( omitida --help de) — ela existe e funciona, mas a superfície do sinalizador pode mudar antes que a capacidade de execução subjacente do Test Manager Playwight seja anunciada de forma geral. Aplica-se apenas a um conjunto de testes cujos casos de teste vêm todos de um único pacote Playwright; em qualquer outro conjunto de testes, a execução prossegue usando os padrões playwright.config do pacote e o sinalizador é efetivamente ignorado.

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

# Scope a run to specific Playwright projects (hidden option, see note above)
uip tm testsets run \
  --test-set-key DEMO:10 \
  --playwright-projects regression smoke

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.

testes do uip tm playground-contexto

Verifique a resolução do Playwright de um conjunto de testes: se todos os casos de teste vêm de um único pacote Playwright e quais nomes de projetos do Playwright estão disponíveis e foram selecionados no momento. Oculto de --help (mesma idade de --playwright-projects de run), mas real e funcional. Use-o para descobrir os nomes --playwright-projects válidos antes de chamar run, exatamente como a própria opção de run o texto aponta aqui.

Argumentos

Nenhum.

Opções

Bandeira	Description
--test-set-key <key>	Obrigatório. Chave do objeto do conjunto de testes (por exemplo DEMO:42).
--log-level <level>	InformationPadrão.

Exemplo

uip tm testsets playwright-context --test-set-key DEMO:42

Formato dos dados

{
  "Code": "TestSetPlaywrightContext",
  "Data": {
    "TestSetKey": "DEMO:42",
    "IsPlaywright": true,
    "PackageIdentifier": "my-playwright-suite",
    "Version": "1.2.0",
    "AvailablePlaywrightProjects": "chromium, firefox, webkit",
    "SelectedPlaywrightProjects": "chromium"
  }
}

Quando o conjunto de testes não é um conjunto Playwight de pacote único (RPA, misto, manual ou nenhum pacote único), IsPlaywright é false e a resposta carrega um campo Details: "Not a Playwright test set (RPA, mixed, manual, or no single package). Run it without --playwright-projects." — os quatro Os campos específicos do Playground são omitidos nesse caso. AvailablePlaywrightProjects/SelectedPlaywrightProjects são strings associadas por vírgulas, não arrays.

Relacionado

• empacotar — empacota um projeto Playwight e produz os nomes de escopo --playwright-projects usados acima.
• 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