UIP TTM

uip tm a ferramenta Test Manager: gerencia projetos de teste, casos de teste, conjuntos de testes, execuções, resultados, relatórios e anexos em um tenant do UiPath Test Manager. Instale-o com uip tools install tm ou invoque uip tm … e deixe a instalação automática ser executada. Consulte Ferramentas ( plugins ) para ver o modelo de instalação e ferramentas uip para o comando que gerencia a instalação da ferramenta.

tm o prefixo do comando — nunca uip test-manager. Use a coluna commandPrefix de uip tools list para confirmar.

Recursos

Cada recurso tem sua própria página de referência. O verbo definido em cada página corresponde aos comandos registrados por uip tm — execute uip tm --help para confirmar a superfície completa em sua instalação.

Recurso	Finalidade
Projeto	Criar, listar, atualizar e excluir projetos do Test Manager; defina ou limpe a pasta do Orchestrator padrão.
Casos de teste	Criar, listar, atualizar, excluir casos de teste; vincular ou desvincular automações do Orchestrator; listar o histórico de resultados; listar conjuntos de testes que contêm um caso de teste; adicionar ou remover casos de teste de um conjunto de testes.
Conjuntos de Testes	Criar, listar, atualizar e excluir conjuntos de testes; listar casos de teste contidos; executar um conjunto de testes e retornar um ID de execução.
Execuções	Listar execuções para um conjunto de testes; listar logs de casos de teste para uma execução; repetir os casos de teste com falha de uma execução concluída.
Resultado	Baixe os resultados de uma execução de teste como um relatório XML JUnit.
Relatar	Obtenha um relatório resumido (contagens, taxa de aprovação, duração, casos com falha) para uma execução concluída.
anexo	Baixe anexos (capturas de tela, logs, arquivos) capturados pelos logs de casos de teste em uma execução.
Aguardar	Pesquisar uma execução de teste até que ela atinja um estado terminal; retorna um código de saída diferente de zero no tempo limite.

tm testcaselogs list-assertions reside na página de caso de teste — consulte casos de teste. Ele é registrado como um subcomando testcaselogs separado no runtime, mas documentado com casos de teste porque lê os artefatos de asserção anexados a um log de caso de teste.

Resumo

uip tm <resource> <verb> [options]

A saída padrão é --output json. Todos os verbos uip tm respeitam as quatro opções globais (--output, --output-filter, --log-level, --log-file).

Fluxo típico

Os recursos do Test Manager formam uma cadeia. Uma execução de CI completa normalmente percorre isso de ponta a ponta:

1. projeto — configuração única. Crie o projeto (ou reutilize um existente) e, opcionalmente, fixe uma pasta padrão do Orchestrator para que comandos posteriores possam --folder-key.
2. casos de teste — crie casos de teste e vincule cada um a um ponto de entrada do pacote do Orchestrator com testcases link-automation. Esta é a etapa que os torna executáveis.
3. testessets — agrupe casos de teste em um pacote executável com testsets create seguido de testcases add.
4. conjuntos de testes executados — inicie uma execução. Retorna um ExecutionId que cada comando downstream recebe como entrada.
5. aguarde — bloqueie o script até que a execução atinja um estado terminal (Passed, Failed, Cancelled). Use --timeout para limitar a espera.
6. relatório / resultado / anexo — após a execução: um resumo estruturado (report get), um arquivo XML JUnit para painéis de teste de CI (result download) e quaisquer artefatos capturados (attachment download).
7. nova tentativa de execuções — opcional: se a execução tiver falhas que podem ser escalonadas, execute novamente apenas os logs de casos de teste com falha no local.

O mesmo fluxo funciona ad-hoc em um terminal: cada verbo imprime um envelope JSON independente com os IDs de que a próxima etapa precisa.

Autenticação e escopo

Cada verbo uip tm resolve o contexto do tenant e do projeto por meio da sessão ativa. Consulte Autenticação para logon; o sinalizador --tenant / -t em cada verbo substitui o padrão da sessão para aquela chamada. O escopo do projeto é resolvido a partir de --project-key (ou derivados de --test-set-key em verbos no nível de execução que aceitam ambos).

Códigos de saída

Os códigos de saída da CLI padrão se aplicam a cada verbo. Um verbo adiciona comportamento específico do domínio:

• uip tm testsets run seguido de uip tm wait — consulte Códigos de saída na execução. wait sai de 2 no tempo limite, então um script pode se ramificar no tempo limite versus finalizar com falhas versus passar limpo sem analisar JSON. A própria detecção de falha de teste acontece por meio de report get ou result download, não por meio do código de saída do comando de execução.

Veja também

• Conceitos: como o UiPath CLI é organizado
• Sessões — como o contexto do tenant e do projeto são resolvidos.
• Padrões de script — ramificação do código de saída e filtragem JSON para CI.
• Formatos de saída — Envelope JSON e --output-filter.