UiPath Documentation
uipath-cli
latest
false
Important :
Ce contenu a été traduit à l'aide d'une traduction automatique. La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.

Guide de l'utilisateur de UiPath CLI

Ensembles de tests uip tm

uip tm testsets gère les ensembles de test: l'unité exécutable dans Test Manager. Un ensemble de tests est un groupe ordonné de cas de test lancés sous forme de commande unique et suivis comme une seule exécution. Chaque appel testsets run renvoie un ExecutionId que les autres uip tm verbes (wait, executions, report, result, attachment) prennent en tant qu'entrée.

Synthèse

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]

Tous les verbes respectent les options globales et les codes de sortie standard. Chaque verbe accepte -t, --tenant <name> et --log-level <level> (par défaut Information).

Création d'ensembles de tests uip tm

Créez un ensemble de tests vide dans un projet.

Arguments

Aucun

Options

  • --project-key <key> (obligatoire) : propriétaire du projet.
  • --name <name> (obligatoire) : nom de l’ensemble de tests.
  • --description <text> — description forme libre. La valeur par défaut est vide.

Exemple

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"

Format des données

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

liste des ensembles de tests uip tm

Répertoriez les ensembles de tests dans un projet.

Arguments

Aucun

Options

  • --project-key <key> (obligatoire) : projet à répertorier.
  • --filter <text> — recherche sur le nom du serveur.

Exemple

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

Format des données

{
  "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 est l'UUID interne — nécessaire par executions list --test-set-id.

mise à jour des ensembles de tests uip tm

Renommez un ensemble de tests ou modifiez sa description. Au moins une des propriétés --name ou --description doit être fournie.

Arguments

Aucun

Options

  • --project-key <key> (obligatoire) : propriétaire du projet.
  • --test-set-key <key> (obligatoire) : clé d’ensemble de tests (par exemple, DEMO:10).
  • --name <name> — nouveau nom.
  • --description <text> — nouvelle description.

Exemple

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

Format des données

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

Suppression d'ensembles de tests uip tm

Supprimez un ensemble de tests par sa clé.

Arguments

Aucun

Options

  • --project-key <key> (obligatoire) : propriétaire du projet.
  • --test-set-key <key> (obligatoire) : clé d’ensemble de tests (par exemple, DEMO:10).
  • -y, --yes — ignorer l'invite de confirmation. Requis dans les environnements non interactifs.

Exemple

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

Format des données

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

uip tm ensembles de tests liste-testcases

Répertorie les cas de test affectés à un ensemble de test.

Arguments

Aucun

Options

  • --project-key <key> (obligatoire) : propriétaire du projet.
  • --test-set-key <key> (obligatoire) — ensemble de tests à inspecter.
  • --limit <n> — nombre maximum de résultats par page. La valeur par défaut est 50.
  • --offset <n> — nombre de résultats à ignorer. La valeur par défaut est 0.

Exemple

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

Format des données

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

Exécution des ensembles de tests uip tm

Exécutez un ensemble de tests et renvoyez son ExecutionId. L'exécution ne bloque pas; associez-le à uip tm wait dans les scripts.

Arguments

Aucun

Options

  • --project-key <key> (obligatoire) : propriétaire du projet.
  • --test-set-key <key> (obligatoire) — ensemble de tests à exécuter.
  • --execution-type <type> (obligatoire) — quels cas de test exécuter. Un de:
    • automated — cas de test automatisés uniquement.
    • manual — cas de test manuels uniquement.
    • mixed — à la fois automatisé et manuel.
    • none — aucun filtre de type.
  • --async — renvoie immédiatement après la mise en file d'attente sans attendre la confirmation.

Exemples

# 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

Format des données

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

--execution-type est obligatoire — les erreurs CLI si omises. Le Status renvoyé reflète l’état au lancement; pour obtenir le résultat de l'exécution, bloquez uip tm wait puis lisez uip tm report get.

  • cas de test : permet de créer et de lier les cas de test qui remplissent un ensemble de test.
  • exécutions — répertorier et réessayer les exécutions une fois qu'un ensemble de test a été exécuté.
  • attendre — bloquer jusqu'à ce qu'un ExecutionId renvoyé atteigne un état terminal.
  • rapport, résultat, pièce jointe — artefacts post-exécution.

Voir également

Cette page vous a-t-elle été utile ?

Connecter

Besoin d'aide ? Assistance

Vous souhaitez apprendre ? UiPath Academy

Vous avez des questions ? UiPath Forum

Rester à jour