casos de teste uip tm

uip tm testcases gerencia casos de teste dentro de um projeto do Test Manager: criar, listar, atualizar, excluir, vincular ou desvincular uma automação do Orchestrator, inspecionar resultados históricos e adicionar ou remover casos de teste de um conjunto de testes. Esta página também documenta uip tm testcaselogs list-assertions, que lê os artefatos de asserção anexados a um único log de caso de teste produzidos por uma execução.

Um caso de teste é a unidade de autoria. Ele se torna executável assim que é vinculado a um ponto de entrada do pacote com testcases link-automation e é executado como parte de um conjunto de testes (consulte conjuntos de testes).

Resumo

uip tm testcases create --project-key <key> --name <name> [--description <text>] [--version <version>]
uip tm testcases list --project-key <key> [--filter <text>]
uip tm testcases list-result-history --project-key <key> --test-case-id <uuid> [filters…]
uip tm testcases update --project-key <key> --test-case-key <key> [--name <name>] [--description <text>]
uip tm testcases delete --project-key <key> --test-case-key <key>
uip tm testcases link-automation --project-key <key> --test-case-key <key> --folder-key <uuid> --package-name <name> --test-name <name>
uip tm testcases unlink-automation --project-key <key> --test-case-key <key>
uip tm testcases list-automations --project-key <key> --folder-key <uuid> [--package-name <name>]
uip tm testcases list-testsets --project-key <key> --test-case-key <key>
uip tm testcases add --test-set-key <key> --test-case-keys <keys>
uip tm testcases remove --test-set-key <key> --test-case-keys <keys>

uip tm testcaselogs list-assertions --project-key <key> --test-case-log-id <uuid>

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

Criação de casos de teste do uip tm

Crie um novo caso de teste dentro de um projeto.

Argumentos

Nenhum.

Opções

• --project-key <key> (necessário) — possuindo projeto.
• --name <name> necessário) — nome do caso de teste.
• --description <text> descrição de forma livre. O padrão é vazio.
• --version <version> — string de versão do caso de teste. O padrão é 1.0.0.

Exemplo

uip tm testcases create \
  --project-key DEMO \
  --name "Login smoke" \
  --description "Logs in and out"

Formato dos dados

{
  "Code": "TestCaseCreate",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Login smoke",
    "Description": "Logs in and out",
    "Version": "1.0.0"
  }
}

TestCaseKey (o identificador PROJECT:N público) é o que você passa para outros verbos. O Id interno é necessário apenas para list-result-history.

lista de casos de teste uip tm

Listar todos os casos de teste em um projeto. As páginas da CLI por meio de resultados automaticamente; nenhuma opção de paginação é exposta neste verbo.

Argumentos

Nenhum.

Opções

• --project-key <key> (necessário) — projeto à lista.
• --filter <text> filtre por nome ou chave (pesquisa no lado do servidor).

Exemplo

uip tm testcases list --project-key DEMO --filter login

Formato dos dados

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

uip tm testcases list-result-history

Liste os logs históricos de casos de teste para um único caso de teste. Usa o --test-case-id interno (UUID), não a chave PROJECT:N — procure o UUID por meio de testcases list ou de uma saída TestCaseCreate anterior.

Argumentos

Nenhum.

Opções

• --project-key <key> (necessário) — possuindo projeto.
• --test-case-id <uuid> (necessário) — UUID do caso de teste interno.
• --filter <text> pesquise logs de casos de teste por nome.
• --only-failed atalho para "mostrar apenas logs com falha" (padrão false).
• --results <results...> resultados separados por espaço a serem incluídos. Os valores aceitos vêm do enum Result do SDK.
• --statuses <statuses...> — status de execução separados por espaço. Os valores aceitos vêm do enum TestCaseLogExecutionStatus do SDK.
• --duration-period <period> — filtrar por bucket de duração. Os valores aceitos vêm do enum DurationPeriod do SDK.
• --top <number> — tamanho da página. O padrão é 50.
• --skip <number> — resultados a ignorar. O padrão é 0.

Observação:

Os valores aceitos exatos para --results, --statuses e --duration-period são gerados no runtime a partir dos enums do SDK do Test Manager enviados com a versão da ferramenta instalada. Execute uip tm testcases list-result-history --help para ver o conjunto atual.

Exemplo

uip tm testcases list-result-history \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --only-failed

Formato dos dados

{
  "Code": "TestCaseResultHistory",
  "Data": [
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000001",
      "Result": "Failed",
      "Status": "Finished",
      "ExecutionEnd": "2025-04-15T12:00:00Z"
    }
  ]
}

atualização de casos de teste do uip tm

Renomear um caso de teste ou alterar sua descrição. Pelo menos um dos --name ou --description é necessário; caso contrário, o comando falhará com um erro de validação.

Argumentos

Nenhum.

Opções

• --project-key <key> (necessário) — possuindo projeto.
• --test-case-key <key> (necessário) — chave de caso de teste (por exemplo DEMO:1).
• --name <name> novo nome.
• --description <text> nova descrição.

Exemplo

uip tm testcases update \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --name "Login smoke (2026)"

Formato dos dados

{
  "Code": "TestCaseUpdate",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Name": "Login smoke (2026)",
    "Description": "Logs in and out",
    "Result": "Updated"
  }
}

exclusão de casos de teste do uip tm

Excluir um caso de teste por sua chave.

Argumentos

Nenhum.

Opções

• --project-key <key> (necessário) — possuindo projeto.
• --test-case-key <key> (necessário) — chave de caso de teste (por exemplo DEMO:1).

Exemplo

uip tm testcases delete --project-key DEMO --test-case-key DEMO:1

Formato dos dados

{
  "Code": "TestCaseDelete",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Result": "Deleted"
  }
}

uip tm testcases link-automation

Associe um ponto de entrada do pacote do Orchestrator a um caso de teste. É isso que torna o caso de teste executável dentro de um conjunto de testes.

Internamente, o comando resolve o nome de exibição da pasta de --folder-key, pesquisa o ponto de entrada do pacote correspondente por nome e, em seguida, armazena a associação no caso de teste. Todos os quatro de --folder-key, --package-name e --test-name devem ser resolvidos para um ponto de entrada concreto ou o comando falhará.

Argumentos

Nenhum.

Opções

• --project-key <key> (necessário) — possuindo projeto.
• --test-case-key <key> necessário) — caso de teste a ser vinculado.
• --folder-key <uuid> (necessário) — UUID da pasta do Orchestrator (de uip or folders list).
• --package-name <name> (obrigatório) — Identificador do pacote do Orchestrator (por exemplo InvoiceTests).
• --test-name <name> necessário) — o nome do caso de teste dentro do pacote (o nome do ponto de entrada).

Exemplo

uip tm testcases link-automation \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name InvoiceTests \
  --test-name SmokeTest

Formato dos dados

{
  "Code": "TestCaseLinkAutomation",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "PackageName": "InvoiceTests",
    "PackageSource": "Shared",
    "TestName": "SmokeTest",
    "Result": "Linked"
  }
}

PackageSource é o nome de exibição da pasta resolvida de --folder-key.

uip tm testcases unlink-automation

Remova a associação do ponto de entrada do pacote de um caso de teste. Após a desvinculação, o caso de teste não será mais executável até ser vinculado novamente.

Argumentos

Nenhum.

Opções

• --project-key <key> (necessário) — possuindo projeto.
• --test-case-key <key> (necessário) — caso de teste para desvincular.

Exemplo

uip tm testcases unlink-automation --project-key DEMO --test-case-key DEMO:1

Formato dos dados

{
  "Code": "TestCaseUnlinkAutomation",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Result": "Unlinked"
  }
}

uip tm testcases lista-automações

Liste os pontos de entrada de teste disponíveis em uma pasta do Orchestrator — use isso para descobrir os valores --package-name / --test-name para passar para link-automation.

Argumentos

Nenhum.

Opções

• --project-key <key> (exigido) — proprietário do projeto (usado para delimitar a pesquisa).
• --folder-key <uuid> (necessário) — UUID da pasta do Orchestrator.
• --package-name <name> filtre a lista para um pacote (correspondência exata sem diferenciação entre maiúsculas e minúsculas).

Exemplo

uip tm testcases list-automations \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001

Formato dos dados

{
  "Code": "TestAutomationsList",
  "Data": [
    {
      "PackageName": "InvoiceTests",
      "TestName": "SmokeTest",
      "PackageVersion": "1.0.2"
    }
  ]
}

uip tm testcases list-testsets

Liste cada conjunto de testes que contém um determinado caso de teste.

Argumentos

Nenhum.

Opções

• --project-key <key> (necessário) — possuindo projeto.
• --test-case-key <key> (necessário) — chave de caso de teste (por exemplo DEMO:1).

Exemplo

uip tm testcases list-testsets --project-key DEMO --test-case-key DEMO:1

Formato dos dados

{
  "Code": "TestCaseTestSetsList",
  "Data": [
    {
      "TestSetKey": "DEMO:10",
      "Name": "Smoke Suite",
      "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001"
    }
  ]
}

Adicionar casos de teste uip tm

Adicione um ou mais casos de teste a um conjunto de testes. A CLI resolve cada chave para seu UUID interno e chama o endpoint de atribuição em uma solicitação. Se alguma chave for desconhecida, toda a chamada falhará antes que qualquer alteração seja feita.

Argumentos

Nenhum.

Opções

• --test-set-key <key> necessário) — conjunto de teste a ser modificado.
• --test-case-keys <keys> (obrigatório) — chaves de casos de teste separadas por vírgulas (por exemplo DEMO:1,DEMO:2). O espaço em branco ao redor de vírgulas é ignorado.

Exemplo

uip tm testcases add \
  --test-set-key DEMO:10 \
  --test-case-keys DEMO:1,DEMO:2

Formato dos dados

{
  "Code": "TestCaseAdd",
  "Data": {
    "TestSetKey": "DEMO:10",
    "Added": "DEMO:1, DEMO:2",
    "Result": "Added"
  }
}

remoção de casos de teste uip tm

Remova um ou mais casos de teste de um conjunto de testes. Mesma semântica de testcases add , mas chama o endpoint de cancelamento de atribuição.

Argumentos

Nenhum.

Opções

• --test-set-key <key> necessário) — conjunto de teste a ser modificado.
• --test-case-keys <keys> necessário) — chaves de caso de teste separadas por vírgulas a serem removidas.

Exemplo

uip tm testcases remove \
  --test-set-key DEMO:10 \
  --test-case-keys DEMO:1,DEMO:2

Formato dos dados

{
  "Code": "TestCaseRemove",
  "Data": {
    "TestSetKey": "DEMO:10",
    "Removed": "DEMO:1, DEMO:2",
    "Result": "Removed"
  }
}

uip tm testcaselogs list-assertions

Liste as asserções gravadas para um único log de caso de teste. Cada execução de um caso de teste produz exatamente um log de caso de teste; suas asserções são as verificações individuais que a automação registrou (Expect, VerifyExpression, etc.). Use isso quando você quiser exibir por que um log de caso de teste está marcado Failed.

Esse verbo está registrado em testcaselogs, não em testcases, mas está documentado aqui porque ele lê artefatos de asserção para o log de um caso de teste.

Argumentos

Nenhum.

Opções

• --test-case-log-id <uuid> (necessário) — UUID do log do caso de teste. Obtenha-o de uip tm executions testcaselogs list ou uip tm testcases list-result-history.
• --project-key <key> (necessário) — possuindo projeto.

Exemplo

uip tm testcaselogs list-assertions \
  --test-case-log-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO

Formato dos dados

{
  "Code": "TestCaseLogAssertions",
  "Data": [
    { "Message": "Title contains 'Welcome'", "Succeeded": true },
    { "Message": "Button 'Login' visible", "Succeeded": false }
  ]
}

Relacionado

• projeto — escopo que possui cada caso de teste.
• testessets — agrupe casos de teste em um pacote executável.
• execuções — visualizações no nível da execução de logs de casos de teste (execution testcaselogs list).
• relatório — resumo de uma execução, com casos de falha e texto de asserção.

Veja também

• Visão geral do Test Manager
• uip or folders list — origem de --folder-key.
• uip or packages — como os pacotes e pontos de entrada do Orchestrator são registrados.