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

Création d'ensembles de tests uip tm

Créez un ensemble de tests vide dans un projet. Utilisez ensuite testcases add pour la remplir.

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

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

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

Suppression d'ensembles de tests uip tm

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 ensembles de tests liste-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"
    }
  ]
}

Exécution des ensembles de tests uip tm

Exécutez un ensemble de tests et renvoyez immédiatement son ExecutionId . L'ensemble de tests lui-même doit déjà être configuré avec un package et un dossier, soit en créant dans l'interface utilisateur Web de Test Manager, soit manuellement via l'API REST. L'exécution ne bloque pas; associez-le à uip tm wait dans les 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 :

Le Status renvoyé reflète l'état au lancement (généralement Running); cela ne signifie pas que l'exécution a réussi. Pour obtenir le résultat de l'exécution, bloquez uip tm wait puis lisez uip tm report get. Le comportement du code de sortie pour le flux de lancement et d'attente combiné est documenté sur uip tm executions. Voir la section Associer ci-dessous pour les références wait et report .

  • 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