cas de test uip tm

uip tm testcases gère les cas de test au sein d'un projet Test Manager: permet de créer, répertorier, mettre à jour, supprimer, lier ou dissocier une automatisation Orchestrator, inspecter les résultats historiques et ajouter ou supprimer des cas de test d'un ensemble de tests. Cette page documente également uip tm testcaselogs list-assertions, qui lit les artefacts d'assertion associés à un journal de cas de test unique produit par une exécution.

Un cas de test est l'unité de création. Il devient exécutable une fois qu'il est lié à un point d'entrée du package avec testcases link-automation et qu'il s'exécute dans le cadre d'un ensemble de tests (voir ensembles de tests).

Synthèse

uip tm testcases create --project-key <key> --name <name> [--description <text>] [--version <version>]
uip tm testcases list --project-key <key> [--filter <text>]
uip tm testcases list-result-history --project-key <key> --test-case-id <uuid> [filters…]
uip tm testcases update --project-key <key> --test-case-key <key> [--name <name>] [--description <text>]
uip tm testcases delete --project-key <key> --test-case-key <key>
uip tm testcases link-automation --project-key <key> --test-case-key <key> --folder-key <uuid> --package-name <name> --test-name <name>
uip tm testcases unlink-automation --project-key <key> --test-case-key <key>
uip tm testcases list-automations --project-key <key> --folder-key <uuid> [--package-name <name>]
uip tm testcases list-testsets --project-key <key> --test-case-key <key>
uip tm testcases add --test-set-key <key> --test-case-keys <keys>
uip tm testcases remove --test-set-key <key> --test-case-keys <keys>

uip tm testcaselogs list-assertions --project-key <key> --test-case-log-id <uuid>

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 de cas de test uip tm

Créez un nouveau cas de test dans un projet.

Arguments

Aucun

Options

• --project-key <key> (obligatoire) : propriétaire du projet.
• --name <name> (obligatoire) : nom du cas de test.
• --description <text> — description forme libre. La valeur par défaut est vide.
• --version <version> — chaîne de version de cas de test. La valeur par défaut est 1.0.0.

Exemple

uip tm testcases create \
  --project-key DEMO \
  --name "Login smoke" \
  --description "Logs in and out"

Format des données

{
  "Code": "TestCaseCreate",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Login smoke",
    "Description": "Logs in and out",
    "Version": "1.0.0"
  }
}

TestCaseKey (l'identifiant public PROJECT:N ) est ce que vous transmettez aux autres verbes. La valeur interne Id n’est nécessaire que pour list-result-history.

liste des cas de test uip tm

Répertoriez tous les cas de test d'un projet. La CLI page automatiquement dans les résultats; aucune option de pagination n'est exposée sur ce verbe.

Arguments

Aucun

Options

• --project-key <key> (obligatoire) : projet à répertorier.
• --filter <text> — filtrer par nom ou par clé (recherche côté serveur).

Exemple

uip tm testcases list --project-key DEMO --filter login

Format des données

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

uip tm testcases list-result-history

Répertoriez les journaux de cas de test historiques pour un cas de test unique. Prend la clé --test-case-id interne (UUID), et non la clé PROJECT:N — recherchez l'UUID via testcases list ou à partir d'une sortie TestCaseCreate précédente.

Arguments

Aucun

Options

• --project-key <key> (obligatoire) : propriétaire du projet.
• --test-case-id <uuid> (obligatoire) : UUID interne du cas de test.
• --filter <text> — recherchez les journaux de cas de test par nom.
• --only-failed — raccourci pour « afficher uniquement les journaux ayant échoué» (par défaut false).
• --results <results...> — résultats séparés par des espaces à inclure. Les valeurs acceptées proviennent de l’enum du SDK Result .
• --statuses <statuses...> — statuts d'exécution séparés par des espaces. Les valeurs acceptées proviennent de l’enum du SDK TestCaseLogExecutionStatus .
• --duration-period <period> — filtrer par compartiment de durée. Les valeurs acceptées proviennent de l’enum du SDK DurationPeriod .
• --top <number> — taille de la page. La valeur par défaut est 50.
• --skip <number> — résultats à ignorer. La valeur par défaut est 0.

Remarque :

Les valeurs exactes acceptées pour --results, --statuses et --duration-period sont générées au moment de l’exécution à partir des énumérations du SDK Test Manager fournies avec la version installée de l’outil. Exécutez uip tm testcases list-result-history --help pour voir l'ensemble actuel.

Exemple

uip tm testcases list-result-history \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --only-failed

Format des données

{
  "Code": "TestCaseResultHistory",
  "Data": [
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000001",
      "Result": "Failed",
      "Status": "Finished",
      "ExecutionEnd": "2025-04-15T12:00:00Z"
    }
  ]
}

mise à jour des cas de test uip tm

Renommez un cas de test ou modifiez sa description. Au moins une des propriétés --name ou --description est requise; sinon, la commande échoue avec une erreur de validation.

Arguments

Aucun

Options

• --project-key <key> (obligatoire) : propriétaire du projet.
• --test-case-key <key> (obligatoire) — clé de cas de test (par exemple DEMO:1).
• --name <name> — nouveau nom.
• --description <text> — nouvelle description.

Exemple

uip tm testcases update \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --name "Login smoke (2026)"

Format des données

{
  "Code": "TestCaseUpdate",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Name": "Login smoke (2026)",
    "Description": "Logs in and out",
    "Result": "Updated"
  }
}

suppression de cas de test uip tm

Supprimez un cas de test par sa clé.

Arguments

Aucun

Options

• --project-key <key> (obligatoire) : propriétaire du projet.
• --test-case-key <key> (obligatoire) — clé de cas de test (par exemple DEMO:1).

Exemple

uip tm testcases delete --project-key DEMO --test-case-key DEMO:1

Format des données

{
  "Code": "TestCaseDelete",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Result": "Deleted"
  }
}

uip tm cas de test lier-automatisation

Liez un point d'entrée de package Orchestrator à un cas de test. C’est ce qui rend le cas de test exécutable au sein d’un ensemble de tests.

En interne, la commande résout le nom d'affichage du dossier à partir de --folder-key, recherche le point d'entrée du package correspondant par nom, puis stocke la liaison sur le cas de test. Les quatre éléments --folder-key, --package-name et --test-name doivent se résoudre à un point d'entrée concret, ou la commande échoue.

Arguments

Aucun

Options

• --project-key <key> (obligatoire) : propriétaire du projet.
• --test-case-key <key> (obligatoire) — cas de test à lier.
• --folder-key <uuid> (requis) : UUID du dossier Orchestrator (depuis uip or folders list).
• --package-name <name> (obligatoire) : Identifiant du package Orchestrator (par ex. InvoiceTests).
• --test-name <name> (obligatoire) : le nom du cas de test dans le package (le nom du point d'entrée).

Exemple

uip tm testcases link-automation \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001 \
  --package-name InvoiceTests \
  --test-name SmokeTest

Format des données

{
  "Code": "TestCaseLinkAutomation",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "PackageName": "InvoiceTests",
    "PackageSource": "Shared",
    "TestName": "SmokeTest",
    "Result": "Linked"
  }
}

PackageSource est le nom complet du dossier résolu à partir de --folder-key.

cas de test uip tm unlink-automation

Supprimez la liaison package-entry-point d'un cas de test. Après sa dissociation, le cas de test ne peut plus être exécuté tant qu’il n’est pas lié à nouveau.

Arguments

Aucun

Options

• --project-key <key> (obligatoire) : propriétaire du projet.
• --test-case-key <key> (obligatoire) — cas de test à dissocier.

Exemple

uip tm testcases unlink-automation --project-key DEMO --test-case-key DEMO:1

Format des données

{
  "Code": "TestCaseUnlinkAutomation",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Result": "Unlinked"
  }
}

uip tm testcases list-automations

Répertorie les points d'entrée de test disponibles dans un dossier Orchestrator - utilisez-le pour découvrir les valeurs --package-name / --test-name à passer à link-automation.

Arguments

Aucun

Options

• --project-key <key> (obligatoire) : propriétaire du projet (utilisé pour étendre la recherche).
• --folder-key <uuid> (requis) : UUID du dossier Orchestrator.
• --package-name <name> — filtrer la liste à un seul package (correspondance exacte insensible à la casse).

Exemple

uip tm testcases list-automations \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001

Format des données

{
  "Code": "TestAutomationsList",
  "Data": [
    {
      "PackageName": "InvoiceTests",
      "TestName": "SmokeTest",
      "PackageVersion": "1.0.2"
    }
  ]
}

uip tm cas de test liste-ensembles de test

Répertorie chaque ensemble de tests qui contient un cas de test donné.

Arguments

Aucun

Options

• --project-key <key> (obligatoire) : propriétaire du projet.
• --test-case-key <key> (obligatoire) — clé de cas de test (par exemple DEMO:1).

Exemple

uip tm testcases list-testsets --project-key DEMO --test-case-key DEMO:1

Format des données

{
  "Code": "TestCaseTestSetsList",
  "Data": [
    {
      "TestSetKey": "DEMO:10",
      "Name": "Smoke Suite",
      "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001"
    }
  ]
}

Ajouter des cas de test uip tm

Ajoutez un ou plusieurs cas de test à un ensemble de test. La CLI résout chaque clé de son UUID interne et appelle le point de terminaison de l'affectation dans une seule requête. Si une clé est inconnue, l'ensemble de l'appel échoue avant qu'une modification ne soit apportée.

Arguments

Aucun

Options

• --test-set-key <key> (obligatoire) — ensemble de tests à modifier.
• --test-case-keys <keys> (obligatoire) — clés de cas de test séparées par des virgules (par exemple DEMO:1,DEMO:2). Les espaces entre les virgules sont ignorés.

Exemple

uip tm testcases add \
  --test-set-key DEMO:10 \
  --test-case-keys DEMO:1,DEMO:2

Format des données

{
  "Code": "TestCaseAdd",
  "Data": {
    "TestSetKey": "DEMO:10",
    "Added": "DEMO:1, DEMO:2",
    "Result": "Added"
  }
}

Suppression des cas de test uip tm

Supprime un ou plusieurs cas de test d'un ensemble de test. Mêmes sémantiques que testcases add , mais appelle le point de terminaison non affectation.

Arguments

Aucun

Options

• --test-set-key <key> (obligatoire) — ensemble de tests à modifier.
• --test-case-keys <keys> (requis) : les clés de cas de test séparées par des virgules à supprimer.

Exemple

uip tm testcases remove \
  --test-set-key DEMO:10 \
  --test-case-keys DEMO:1,DEMO:2

Format des données

{
  "Code": "TestCaseRemove",
  "Data": {
    "TestSetKey": "DEMO:10",
    "Removed": "DEMO:1, DEMO:2",
    "Result": "Removed"
  }
}

uip tm - journaux de cas de test - assertions

Répertorie les assertions enregistrées pour un journal de cas de test unique. Chaque exécution d’un cas de test produit exactement un journal de cas de test; ses assertions correspondent aux vérifications individuelles de l'automatisation enregistrées (Expect, VerifyExpression, etc.). Utilisez cette option lorsque vous souhaitez faire apparaître la raison pour laquelle un journal de cas de test est marqué Failed.

Ce verbe est enregistré sous testcaselogs, non testcases, mais il est documenté ici, car il lit les artefacts d'assertion pour le journal d'un cas de test.

Arguments

Aucun

Options

• --test-case-log-id <uuid> (obligatoire) : UUID du journal de cas de test. Obtenez-le de uip tm executions testcaselogs list ou uip tm testcases list-result-history.
• --project-key <key> (obligatoire) : propriétaire du projet.

Exemple

uip tm testcaselogs list-assertions \
  --test-case-log-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO

Format des données

{
  "Code": "TestCaseLogAssertions",
  "Data": [
    { "Message": "Title contains 'Welcome'", "Succeeded": true },
    { "Message": "Button 'Login' visible", "Succeeded": false }
  ]
}

Associé

• projet — étendue qui possède chaque cas de test.
• ensembles de tests — regroupe les cas de test dans une suite exécutable.
• exécutions - vues au niveau de l'exécution des journaux de cas de test (execution testcaselogs list).
• rapport — résumé d'une exécution, avec des incidents échoués et un texte d'assertion.

Voir également

• Vue d’ensemble de Test Manager
• uip or folders list — source de --folder-key.
• uip or packages — comment les packages et les points d'entrée Orchestrator sont enregistrés.