uip tm testcases

uip tm testcases manages test cases within a Test Manager project: create, list, update, delete, link or unlink an Orchestrator automation, inspect historical results, and add or remove test cases from a test set. This page also documents uip tm testcaselogs list-assertions, which reads the assertion artifacts attached to a single test case log produced by a run.

A test case is the unit of authorship. It becomes runnable once it is linked to a package entry point with testcases link-automation, and it runs as part of a test set (see testsets).

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

uip tm testcases create

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.

uip tm testcases list

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

uip tm testcases update

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

uip tm testcases delete

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 testcases link-automation

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.

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

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

uip tm testcases add

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

uip tm testcases remove

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 testcaselogs list-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.
• testsets — group test cases into a runnable suite.
• executions — execution-level views of test case logs (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.