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

Dernière mise à jour 20 mai 2026

uip tm testsets

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 que vous pouvez exécuter avec une seule commande et suivre 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> [--folder-key <uuid>] [--filter <text>]
uip tm testsets update --test-set-key <key> [--name <name>] [--description <text>]
uip tm testsets delete --test-set-key <key>
uip tm testsets list-testcases --test-set-key <key>
uip tm testsets run --test-set-key <key> [--execution-type <type>] [--input-path <file>]
uip tm testsets create --project-key <key> --name <name> [--description <text>]
uip tm testsets list --project-key <key> [--folder-key <uuid>] [--filter <text>]
uip tm testsets update --test-set-key <key> [--name <name>] [--description <text>]
uip tm testsets delete --test-set-key <key>
uip tm testsets list-testcases --test-set-key <key>
uip tm testsets run --test-set-key <key> [--execution-type <type>] [--input-path <file>]

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

Les verbes de l'ensemble de tests qui prennent --test-set-key dérivent le projet propriétaire du préfixe de la clé (par ex. DEMO:10 → projet DEMO), donc --project-key n'est requis que sur create et list.

uip tm testsets create

Create an empty test set in a project. Use testcases add afterwards to populate it.

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

uip tm testsets list

Répertoriez les ensembles de tests dans un projet. La CLI page automatiquement dans les résultats.

Arguments: aucun.

Options:

  • --project-key <key> (obligatoire) : projet à répertorier.
  • --folder-key <uuid> — restreindre aux ensembles de test liés à ce dossier Orchestrator. Appliquer côté client après la récupération.
  • --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",
      "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001",
      "Id": "a1b2c3d4-0000-0000-0000-000000000010"
    }
  ]
}
{
  "Code": "TestSetsList",
  "Data": [
    {
      "TestSetKey": "DEMO:10",
      "Name": "Smoke Suite",
      "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001",
      "Id": "a1b2c3d4-0000-0000-0000-000000000010"
    }
  ]
}

Id est l'UUID interne — nécessaire, par exemple, par execution list --test-set-id

uip tm testsets update

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:

  • --test-set-key <key> (obligatoire) — clé de l'ensemble de tests (par ex. DEMO:10).
  • --name <name> — nouveau nom.
  • --description <text> — nouvelle description.

Exemple :

uip tm testsets update \
  --test-set-key DEMO:10 \
  --name "Smoke Suite (2026)"
uip tm testsets update \
  --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"
  }
}

uip tm testsets delete

Supprimez un ensemble de tests par sa clé.

Arguments: aucun.

Options:

  • --test-set-key <key> (obligatoire) : clé d’ensemble de tests.

Exemple :

uip tm testsets delete --test-set-key DEMO:10
uip tm testsets delete --test-set-key DEMO:10

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 testsets list-testcases

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

Arguments: aucun.

Options:

  • --test-set-key <key> (obligatoire) — ensemble de tests à inspecter.

Exemple :

uip tm testsets list-testcases --test-set-key DEMO:10
uip tm testsets list-testcases --test-set-key DEMO:10

Format des données:

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

uip tm testsets run

Run a test set and return its ExecutionId immediately. The test set itself must already be configured with a package and folder — either by authoring inside Test Manager's web UI, or by hand via the REST API. Run does not block; pair it with uip tm wait in scripts.

Arguments: aucun.

Options:

  • --test-set-key <key> (obligatoire) — ensemble de tests à exécuter. La clé du projet est dérivée du préfixe.
  • --execution-type <type> — quels cas de test exécuter. Un de:
    • automated (par défaut) — cas de test automatisés uniquement.
    • manual — cas de test manuels uniquement.
    • mixed — à la fois automatisé et manuel.
    • none — aucun filtre de type.
  • --input-path <file> — chemin d'accès à un fichier JSON de remplacements de paramètres. Le fichier doit contenir un tableau de la forme [{"name":"Param","type":"String","value":"v"}]. Les remplacements sont mis en correspondance par rapport aux définitions de paramètres actuelles de l'ensemble de tests par name (et, le cas échéant, type), insensible à la casse. Si le serveur ne rapporte aucune définition de paramètre, les entrées sont envoyées telles quelles.

Exemples  :

# simplest
uip tm testsets run --test-set-key DEMO:10

# with parameter overrides and manual execution
uip tm testsets run \
  --test-set-key DEMO:10 \
  --execution-type mixed \
  --input-path ./params.json
# simplest
uip tm testsets run --test-set-key DEMO:10

# with parameter overrides and manual execution
uip tm testsets run \
  --test-set-key DEMO:10 \
  --execution-type mixed \
  --input-path ./params.json

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 :

The returned Status reflects the state at launch (typically Running); it does not mean the run has succeeded. To get the run outcome, block on uip tm wait and then read uip tm report get. Exit-code behavior for the combined launch-and-wait flow is documented on uip tm executions. See the Related section below for the wait and report references.

  • testcases — create and link the test cases that populate a test set.
  • executions — list and retry executions once a test set has been run.
  • 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