Ensembles de tests uip tm

Syntaxe et options de `uip tm testsets`, qui gère les unités exécutables d'ensembles de tests qui produisent des exécutions suivies dans Test Manager.

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 --test-set-key <key> [--execution-type <type>] [--input-path <file>] [--playwright-projects <names...>] [--wait [--timeout <seconds>] [--poll-interval <seconds>]]
uip tm testsets playwright-context --test-set-key <key>

Tous les verbes respectent les options globales et les codes de sortie standard. Chaque verbe accepte --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

Drapeau	Description
--project-key <key>	Requis. Propriétaire du projet.
--name <name>	Requis. Nom de l’ensemble de tests.
--description <text>	Description sous forme libre. La valeur par défaut est vide.

Exemple

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

liste des ensembles de tests uip tm

Répertoriez les ensembles de tests dans un projet.

Arguments

Aucun

Options

Drapeau	Description
--project-key <key>	Requis. Projet à répertorier.
--folder-key <uuid>	Filtrez par clé de dossier Orchestrator (à partir de uip or folders list).
--filter <text>	Recherche sur le nom côté serveur.
--include-last-execution	Ajoutez le statut et l’horodatage de la dernière exécution à chaque ensemble de tests (voir LastExecutionStatus/LastExecutionAt ci-dessous). Coûte une recherche supplémentaire par ensemble de tests.

Exemple

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

Id est l'UUID interne — nécessaire par executions list --test-set-id. Avec --include-last-execution, chaque entrée obtient également LastExecutionStatus et LastExecutionAt (les deux chaînes vides si l'ensemble de tests n'a jamais été exécuté).

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

Drapeau	Description
--project-key <key>	Requis. Propriétaire du projet.
--test-set-key <key>	Requis. 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)"

Format des données

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

Drapeau	Description
--project-key <key>	Requis. Propriétaire du projet.
--test-set-key <key>	Requis. Clé d'ensemble de tests (par exemple, DEMO:10).
-y, --yes	Ignorez l’invite de confirmation. Requis dans les environnements non interactifs.

Exemple

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

uip tm ensembles de tests liste-testcases

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

Arguments

Aucun

Options

Drapeau	Description
--project-key <key>	Requis. Propriétaire du projet.
--test-set-key <key>	Requis. 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

Format des données

{
  "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. Par défaut, la commande se renvoie dès que l'exécution est mise en file d'attente. Transmettez --wait pour bloquer jusqu'à ce que l'exécution atteigne un état terminal - cela combine les étapes de lancement et d'attente en une seule commande.

Arguments

Aucun

Options

Drapeau	Description
--test-set-key <key>	Requis. Clé d’objet de l’ensemble de tests (par exemple, DEMO:42). La clé du projet est dérivée du préfixe.
--execution-type <type>	Type de cas de test à exécuter: automated (par défaut), manual, mixed (automatisé et manuel) ou none (aucun filtre de type).
--input-path <file>	Chemin d'accès à un fichier JSON contenant les remplacements de paramètres pour l'exécution. Format: [{"name":"Param","type":"String","value":"v"}].
--playwright-projects <names...>	Étendue de l'exécution à un ou plusieurs projets Playground packagés par uip tm pack (séparés par des espaces, par exemple, regression smoke). La sélection est conservée dans l'ensemble de tests, de sorte que les exécutions ultérieures du même ensemble de tests n'ont pas besoin de le répéter.
--wait	Bloquez jusqu'à ce que l'exécution atteigne un état terminal (finished, cancelled). Lorsqu'elle est omise, la commande revient immédiatement après la mise en file d'attente.
--timeout <seconds>	Nombre maximal de secondes à attendre (0 pour l'absence de délai d'attente). Nécessite --wait.
--poll-interval <seconds>	Secondes entre les vérifications du statut pendant l'attente. Nécessite --wait.

Remarque :

--playwright-projects est une option masquée (omise dans --help): elle existe et fonctionne, mais la surface de l'indicateur peut changer avant que la fonctionnalité d'exécution sous-jacente de Test Manager Playwork ne soit généralement annoncée. Cela s’applique uniquement à un ensemble de tests dont les cas de test proviennent tous d’un même package Playwork; sur tout autre ensemble de tests, l'exécution se poursuit en utilisant les valeurs par défaut playwright.config du package et l'indicateur est effectivement ignoré.

Exemples

# Fire-and-forget — returns ExecutionId immediately
uip tm testsets run --test-set-key DEMO:10

# Block until done — no need for a separate uip tm wait call
uip tm testsets run \
  --test-set-key DEMO:10 \
  --wait

# Block with a timeout and custom poll interval
uip tm testsets run \
  --test-set-key DEMO:10 \
  --execution-type automated \
  --wait \
  --timeout 900 \
  --poll-interval 15

# Pass parameter overrides from a file
uip tm testsets run \
  --test-set-key DEMO:10 \
  --input-path ./params.json \
  --wait

# Scope a run to specific Playwright projects (hidden option, see note above)
uip tm testsets run \
  --test-set-key DEMO:10 \
  --playwright-projects regression smoke

Format des données

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

Remarque :

Lorsque --wait est utilisé, Status reflète l'état terminal (Finished, Cancelled) plutôt que Running. Le ExecutionId renvoyé est le même dans les deux cas et peut être transmis à uip tm report get, uip tm result download et uip tm attachment download.

uip tm ensembles de tests lecture-contexte

Procédez à une sonde de la résolution Playwwrite d’un ensemble de tests: si chaque cas de test qu’il contient provient d’un même package Playwwrite, et quels noms de projet Playwight sont disponibles et actuellement sélectionnés. Masqué de --help (même limite d'échéance que --playwright-projects de run), mais réel et fonctionnel — utilisez-le pour découvrir les noms --playwright-projects valides avant d'appeler run, exactement comme l'option propre de run les points de texte sont renvoyés ici.

Arguments

Aucun

Options

Drapeau	Description
--test-set-key <key>	Requis. Clé d’objet de l’ensemble de tests (par ex. DEMO:42).
--log-level <level>	Par défaut Information.

Exemple

uip tm testsets playwright-context --test-set-key DEMO:42

Format des données

{
  "Code": "TestSetPlaywrightContext",
  "Data": {
    "TestSetKey": "DEMO:42",
    "IsPlaywright": true,
    "PackageIdentifier": "my-playwright-suite",
    "Version": "1.2.0",
    "AvailablePlaywrightProjects": "chromium, firefox, webkit",
    "SelectedPlaywrightProjects": "chromium"
  }
}

Lorsque l'ensemble de tests n'est pas un ensemble Playwork à package unique (RPA, mixte, manuel ou aucun package unique), IsPlaywright est false et la réponse comporte à la place un champ Details: "Not a Playwright test set (RPA, mixed, manual, or no single package). Run it without --playwright-projects." — les quatre Les champs spécifiques à Playground ci-dessus sont omis dans ce cas. AvailablePlaywrightProjects/SelectedPlaywrightProjects sont des chaînes jointes par des virgules, et non des tableaux.

Associé

• pack — empaquète un projet Playground et produit les noms d’étendue --playwright-projects utilisés ci-dessus.
• 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

• Vue d’ensemble de Test Manager
• Modèles de script