uip tm testcases

uip tm testcases manages test cases within a Test Manager project: create, list, update, delete, link or unlink an Orchestrator automation, inspect historical results, and add or remove test cases from a test set. This page also documents uip tm testcaselogs list-assertions, which reads the assertion artifacts attached to a single test case log produced by a run.

A test case is the unit of authorship. It becomes runnable once it is linked to a package entry point with testcases link-automation, and it runs as part of a test set (see testsets).

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

uip tm testcases create

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.

uip tm testcases list

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

uip tm testcases update

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

uip tm testcases delete

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 list-automations

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

uip tm testcases add

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

uip tm testcases remove

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.
• testsets — group test cases into a runnable suite.
• executions — execution-level views of test case logs (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.