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>] [--wait [--timeout <seconds>] [--poll-interval <seconds>]]

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.
--filter <text>	Recherche sur le nom côté serveur.

Exemple

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

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

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

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

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.

Associé

• 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