UiPath Documentation
uipath-cli
latest
false
Importante :
Este conteúdo foi traduzido com auxílio de tradução automática. A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.

Guia do usuário da UiPath CLI

conjuntos de testes uip tm

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 --project-key <key> --test-set-key <key> --execution-type <type> [--async]
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 --project-key <key> --test-set-key <key> --execution-type <type> [--async]

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 conjuntos de testes do uip tm

Crie um conjunto de testes vazio em um projeto.

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

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

Exemplo

uip tm testsets list --project-key DEMO --filter smoke
uip tm testsets list --project-key DEMO --filter smoke

Formato dos dados

{
  "Code": "TestSetsList",
  "Data": [
    {
      "TestSetKey": "DEMO:10",
      "Name": "Smoke Suite",
      "Id": "a1b2c3d4-0000-0000-0000-000000000010"
    }
  ]
}
{
  "Code": "TestSetsList",
  "Data": [
    {
      "TestSetKey": "DEMO:10",
      "Name": "Smoke Suite",
      "Id": "a1b2c3d4-0000-0000-0000-000000000010"
    }
  ]
}

Id é o UUID interno — necessário por executions list --test-set-id.

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

  • --project-key <key> (necessário) — possuindo projeto.
  • --test-set-key <key> necessá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)"
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"
  }
}
{
  "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

  • --project-key <key> (necessário) — possuindo projeto.
  • --test-set-key <key> necessá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
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"
  }
}
{
  "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

  • --project-key <key> (necessário) — possuindo projeto.
  • --test-set-key <key> necessário) — conjunto de teste para inspecionar.
  • --limit <n> — número máximo de resultados por página. O padrão é 50.
  • --offset <n> — número de resultados a ignorar. O padrão é 0.

Exemplo

uip tm testsets list-testcases --project-key DEMO --test-set-key DEMO:10
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"
    }
  ]
}
{
  "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. Executar não bloqueia; emparelhá-lo com uip tm wait em scripts.

Argumentos

Nenhum.

Opções

  • --project-key <key> (necessário) — possuindo projeto.
  • --test-set-key <key> necessário) — teste definido para ser executado.
  • --execution-type <type> necessário) — quais casos de teste executar. Um destes:
    • automated apenas casos de teste automatizados.
    • manual apenas casos de teste manuais.
    • mixed automatizado quanto manual.
    • none sem filtro de tipo.
  • --async retorne imediatamente após a fila sem esperar confirmação.

Exemplos

# automated run (most common in CI)
uip tm testsets run \
  --project-key DEMO \
  --test-set-key DEMO:10 \
  --execution-type automated

# fire-and-forget
uip tm testsets run \
  --project-key DEMO \
  --test-set-key DEMO:10 \
  --execution-type automated \
  --async
# automated run (most common in CI)
uip tm testsets run \
  --project-key DEMO \
  --test-set-key DEMO:10 \
  --execution-type automated

# fire-and-forget
uip tm testsets run \
  --project-key DEMO \
  --test-set-key DEMO:10 \
  --execution-type automated \
  --async

Formato dos dados

{
  "Code": "TestSetRun",
  "Data": {
    "ExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "TestSetKey": "DEMO:10",
    "Status": "Running",
    "StartTime": "2025-04-15T10:30:00Z"
  }
}
{
  "Code": "TestSetRun",
  "Data": {
    "ExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "TestSetKey": "DEMO:10",
    "Status": "Running",
    "StartTime": "2025-04-15T10:30:00Z"
  }
}
Observação:

é --execution-type — os erros de CLI são omitidos. O Status retornado reflete o estado no lançamento; para obter o resultado da execução, bloqueie em uip tm wait e depois leia uip tm report get.

  • 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

Esta página foi útil?

Conectar

Precisa de ajuda? Suporte

Quer aprender? Academia UiPath

Tem perguntas? Fórum do UiPath

Fique por dentro das novidades