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 répertorier les ensembles de tests contenant un cas de test. Cette page documente également uip tm testcaselog list-assertions, qui lit les artefacts d'assertion associés à un seul journal de cas de test, et les verbes testcaselog start / testcaselog finish utilisés par les automatisations pour enregistrer les entrées de journal manuelles.

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>] [--precondition <text>] [--postcondition <text>]
uip tm testcases list --project-key <key> [--filter <text>] [--limit <n>] [--offset <n>]
uip tm testcases list-result-history --project-key <key> --test-case-id <uuid> [--limit <n>] [--offset <n>]
uip tm testcases update --project-key <key> --test-case-key <key> [--name <name>] [--description <text>] [--precondition <text>] [--postcondition <text>]
uip tm testcases delete --project-key <key> --test-case-key <key> [-y]
uip tm testcases link-automation --project-key <key> --test-case-key <key> --automation-id <uuid>
uip tm testcases unlink-automation --project-key <key> --test-case-key <key>
uip tm testcases list-automations --folder-key <uuid> [--package-name <name>]
uip tm testcases list-testsets --project-key <key> --test-case-id <uuid>
uip tm testcases run --project-key <key> --test-case-id <uuid...> --name <name> --execution-type <type> [--async] [--folder-key <uuid>] [--runtime-type <type>] [--robot-user-key <uuid>] [--machine-key <uuid>] [--host-machine-name <name>] [--service-user-name <name>] [--test-set-packages <json>]
uip tm testcases add --test-set-key <key> --test-case-keys <keys>
uip tm testcases remove --test-set-key <key> --test-case-keys <keys> [-y]
uip tm testcases list-steps --project-key <key> --test-case-id <uuid>

uip tm testcases steps list --project-key <key> --test-case-id <uuid>
uip tm testcases steps get --project-key <key> --step-id <uuid>
uip tm testcases steps add --project-key <key> --test-case-id <uuid> [--description <text>] [--expected-result <text>] [--action-type <type>] [--clipboard-data <text>] [--order-no <n>] [--step <json>...]
uip tm testcases steps update --project-key <key> --step-id <uuid> [--description <text>] [--expected-result <text>] [--action-type <type>] [--clipboard-data <text>]
uip tm testcases steps move --project-key <key> --step-id <uuid> --target-position <n>
uip tm testcases steps delete --project-key <key> --step-id <uuid> [-y]

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

uip tm testcaselog start --execution-id <uuid> --test-case-id <uuid> [--execution-type <type>]
uip tm testcaselog finish --test-case-log-id <uuid> [--info <text>]

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.
• --precondition <text> — texte de précondition. La valeur par défaut est vide.
• --postcondition <text> — texte postcondition. La valeur par défaut est vide.

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

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

liste des cas de test uip tm

Répertoriez tous les cas de test d'un projet.

Arguments

Aucun

Options

• --project-key <key> (obligatoire) : projet à répertorier.
• --filter <text> — filtrer par nom ou par clé (recherche côté serveur).
• --limit <n> — taille de la page. La valeur par défaut est 50.
• --offset <n> — résultats à ignorer. La valeur par défaut est 0.

Exemple

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

Format des données

{
  "Code": "TestCasesList",
  "Data": [
    {
      "TestCaseKey": "DEMO:1",
      "Name": "Login smoke",
      "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 le fichier --test-case-id interne (UUID): 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.
• --limit <n> — taille de la page. La valeur par défaut est 50.
• --offset <n> — résultats à ignorer. La valeur par défaut est 0.

Exemple

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

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, sa précondition ou sa post-condition. Au moins un de ces champs doit être fourni.

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.
• --precondition <text> — nouveau texte de précondition.
• --postcondition <text> — nouveau texte postcondition.

Exemple

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

Format des données

{
  "Code": "TestCaseUpdate",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "Name": "Login smoke (2026)",
    "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).
• -y, --yes — ignorer l'invite de confirmation. Requis dans les environnements non interactifs.

Exemple

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

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 une automatisation Orchestrator à un cas de test par son UUID d'automatisation. C’est ce qui rend le cas de test exécutable au sein d’un ensemble de tests. Exécutez testcases list-automations pour découvrir le --automation-id d’un dossier donné.

Arguments

Aucun

Options

• --project-key <key> (obligatoire) : propriétaire du projet.
• --test-case-key <key> (obligatoire) — cas de test à lier.
• --automation-id <uuid> (requis) : UUID de l'automatisation Orchestrator (point d'entrée du package). Obtenez-le à partir de uip tm testcases list-automations.

Exemple

uip tm testcases link-automation \
  --project-key DEMO \
  --test-case-key DEMO:1 \
  --automation-id f0f0f0f0-0000-0000-0000-000000000001

Format des données

{
  "Code": "TestCaseLinkAutomation",
  "Data": {
    "TestCaseKey": "DEMO:1",
    "AutomationId": "f0f0f0f0-0000-0000-0000-000000000001",
    "Result": "Linked"
  }
}

cas de test uip tm unlink-automation

Supprimez la liaison d'automatisation 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. Exécutez cette option pour découvrir la valeur --automation-id à passer à link-automation.

Arguments

Aucun

Options

• --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 \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001

Format des données

{
  "Code": "TestAutomationsList",
  "Data": [
    {
      "AutomationId": "f0f0f0f0-0000-0000-0000-000000000001",
      "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-id <uuid> (obligatoire) : UUID du cas de test interne (pas la clé PROJECT:N ). Obtenez-le à partir de testcases list ou d’une réponse TestCaseCreate .

Exemple

uip tm testcases list-testsets \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001

Format des données

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

Exécution de cas de test uip tm

Exécutez une nouvelle exécution pour un ou plusieurs cas de test directement sans créer d’abord un ensemble de test. La CLI crée un ensemble de tests temporaire, l’exécute et renvoie la valeur ExecutionId.

Arguments

Aucun

Options

• --project-key <key> (obligatoire) : propriétaire du projet.
• --test-case-id <uuid...> (obligatoire) — un ou plusieurs UUID de cas de test à exécuter (séparés par des espaces).
• --name <name> (obligatoire) — nom de la nouvelle exécution.
• --execution-type <type> (obligatoire) — quels cas de test exécuter: automated, manual, mixed, ou none.
• --async — renvoie immédiatement après la file d'attente sans interrogation.
• --folder-key <uuid> — Dossier Orchestrator dans lequel exécuter.
• --runtime-type <type> — type de runtime de robot (par exemple, Unattended).
• --robot-user-key <uuid> — utilisateur robot à affecter.
• --machine-key <uuid> — machine à affecter.
• --host-machine-name <name> — nom de la machine hôte.
• --service-user-name <name> — nom d'utilisateur du service.
• --test-set-packages <json> — Tableau JSON des remplacements de package: [{"packageName":"Pkg","version":"1.0.0"}].

Exemple

uip tm testcases run \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --execution-type automated \
  --name "Smoke run"

Format des données

{
  "Code": "TestCaseRun",
  "Data": {
    "ExecutionId": "b2c3d4e5-0000-0000-0000-000000000001",
    "Status": "Running",
    "StartTime": "2025-04-15T10:30:00Z"
  }
}

Ajouter des cas de test uip tm

Ajoutez un ou plusieurs cas de test à un ensemble de tests existant.

Arguments

Aucun

Options

• --test-set-key <key> (requis) : Clé d'objet de l'ensemble de tests (par exemple, DEMO:42).
• --test-case-keys <keys> (requis) : des clés de cas de test séparées par des virgules à ajouter (par exemple, DEMO:1,DEMO:2).

Exemple

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

Format des données

{
  "Code": "TestSetAddTestCases",
  "Data": {
    "TestSetKey": "DEMO:42",
    "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.

Arguments

Aucun

Options

• --test-set-key <key> (requis) : Clé d'objet de l'ensemble de tests (par exemple, DEMO:42).
• --test-case-keys <keys> (requis) — clés de cas de test séparées par des virgules à supprimer (par exemple, DEMO:1,DEMO:2).
• -y, --yes — ignorer l'invite de confirmation. Requis dans les environnements non interactifs.

Exemple

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

Format des données

{
  "Code": "TestSetRemoveTestCases",
  "Data": {
    "TestSetKey": "DEMO:42",
    "Removed": "DEMO:1, DEMO:2",
    "Result": "Removed"
  }
}

étapes de liste des cas de test uip tm

Répertoriez les étapes de test manuelles d’un cas de test. Il s'agit d'un alias pour testcases steps list.

Arguments

Aucun

Options

• --project-key <key> (obligatoire) : propriétaire du projet.
• --test-case-id <uuid> (obligatoire) : UUID interne du cas de test.

Exemple

uip tm testcases list-steps \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001

Format des données

{
  "Code": "TestCaseStepsList",
  "Data": [
    {
      "Id": "d4e5f6a7-0000-0000-0000-000000000001",
      "TestCaseId": "a1b2c3d4-0000-0000-0000-000000000001",
      "OrderNo": 0,
      "ActionType": "Manual",
      "Description": "Open login page",
      "ExpectedResult": "Login form is displayed"
    }
  ]
}

étapes des cas de test uip tm

testcases steps est un sous-groupe qui gère les étapes manuelles individuelles d'un cas de test: répertorier, obtenir, ajouter, mettre à jour, déplacer et supprimer.

liste des étapes des cas de test uip tm

Dressez la liste des étapes d’un cas de test dans l’ordre.

Arguments

Aucun

Options

• --project-key <key> (obligatoire) : propriétaire du projet.
• --test-case-id <uuid> (obligatoire) : UUID interne du cas de test.

Exemple

uip tm testcases steps list \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001

Format des données

{
  "Code": "TestCaseStepsList",
  "Data": [
    {
      "Id": "d4e5f6a7-0000-0000-0000-000000000001",
      "OrderNo": 0,
      "ActionType": "Manual",
      "Description": "Open login page",
      "ExpectedResult": "Login form is displayed"
    }
  ]
}

étapes des cas de test uip tm - Obtenir

Obtenez une seule étape par son UUID.

Arguments

Aucun

Options

• --project-key <key> (obligatoire) : propriétaire du projet.
• --step-id <uuid> (obligatoire) — UUID de l'étape de test (depuis steps list).

Exemple

uip tm testcases steps get \
  --project-key DEMO \
  --step-id d4e5f6a7-0000-0000-0000-000000000001

Format des données

{
  "Code": "TestStepGet",
  "Data": {
    "Id": "d4e5f6a7-0000-0000-0000-000000000001",
    "OrderNo": 0,
    "ActionType": "Manual",
    "Description": "Open login page",
    "ExpectedResult": "Login form is displayed"
  }
}

Étapes d'ajout de cas de test uip tm

Ajoutez une ou plusieurs étapes à un cas de test. Utilisez des indicateurs intégrés pour une seule étape ou --step <json> (répétable) pour plusieurs étapes à la fois.

Arguments

Aucun

Options

• --project-key <key> (obligatoire) : propriétaire du projet.
• --test-case-id <uuid> (obligatoire) : cas de test auquel ajouter des étapes.
• --description <text> — description de l'étape (mode à une seule étape).
• --expected-result <text> — résultat attendu (mode à une seule étape).
• --action-type <type> — type d'action d'étape (mode à une seule étape).
• --clipboard-data <text> — données de test à copier pour l'étape (mode à une seule étape).
• --order-no <n> — Position d'insertion basée sur 0; omettre d'ajouter à la fin (mode à une seule étape);
• --step <json> — une étape en tant qu'objet JSON ({"description":"...","expectedResult":"..."}). Répétez l'opération pour ajouter plusieurs étapes.

Exemples

# single step
uip tm testcases steps add \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --description "Open login page" \
  --expected-result "Login form is displayed"

# multiple steps
uip tm testcases steps add \
  --project-key DEMO \
  --test-case-id a1b2c3d4-0000-0000-0000-000000000001 \
  --step '{"description":"Open login page","expectedResult":"Login form is shown"}' \
  --step '{"description":"Enter credentials","clipboardData":"[e-mail]"}' \
  --step '{"description":"Click submit","expectedResult":"Dashboard loads"}'

Format des données

{
  "Code": "TestStepAdd",
  "Data": [
    {
      "Id": "d4e5f6a7-0000-0000-0000-000000000001",
      "OrderNo": 0,
      "Description": "Open login page",
      "ExpectedResult": "Login form is displayed"
    }
  ]
}

mise à jour des étapes des cas de test uip tm

Mettez à jour la description d'une étape, le résultat attendu, le type d'action ou les données du presse-papiers. Au moins un de ces champs doit être fourni.

Arguments

Aucun

Options

• --project-key <key> (obligatoire) : propriétaire du projet.
• --step-id <uuid> (obligatoire) — UUID de l'étape de test.
• --description <text> — nouvelle description.
• --expected-result <text> — nouveau résultat attendu.
• --action-type <type> — nouveau type d'action.
• --clipboard-data <text> — nouvelles données dans le presse-papiers.

Exemple

uip tm testcases steps update \
  --project-key DEMO \
  --step-id d4e5f6a7-0000-0000-0000-000000000001 \
  --expected-result "Dashboard is shown"

Format des données

{
  "Code": "TestStepUpdate",
  "Data": {
    "StepId": "d4e5f6a7-0000-0000-0000-000000000001",
    "Result": "Updated"
  }
}

Étapes du cas de test uip tm - Déplacement

Déplacez une étape vers une nouvelle position dans l'ordre des cas de test.

Arguments

Aucun

Options

• --project-key <key> (obligatoire) : propriétaire du projet.
• --step-id <uuid> (obligatoire) — UUID de l'étape de test.
• --target-position <n> (obligatoire) — nouvelle position basée sur 0 (0 = première). Correspond au champ OrderNo de steps list.

Exemple

uip tm testcases steps move \
  --project-key DEMO \
  --step-id d4e5f6a7-0000-0000-0000-000000000001 \
  --target-position 2

Format des données

{
  "Code": "TestStepMove",
  "Data": {
    "StepId": "d4e5f6a7-0000-0000-0000-000000000001",
    "TargetPosition": 2,
    "Result": "Moved"
  }
}

étapes de suppression des cas de test uip tm

Supprimez une étape d'un cas de test. Ceci est permanent.

Arguments

Aucun

Options

• --project-key <key> (obligatoire) : propriétaire du projet.
• --step-id <uuid> (obligatoire) — UUID de l'étape de test.
• -y, --yes — ignorer l'invite de confirmation. Requis dans les environnements non interactifs.

Exemple

uip tm testcases steps delete \
  --project-key DEMO \
  --step-id d4e5f6a7-0000-0000-0000-000000000001 \
  --yes

Format des données

{
  "Code": "TestStepDelete",
  "Data": {
    "StepId": "d4e5f6a7-0000-0000-0000-000000000001",
    "Result": "Deleted"
  }
}

uip tm testcaselog 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 enregistrées par l'automatisation. Ce verbe fait apparaître la raison pour laquelle un journal de cas de test est marqué Failed.

Ce verbe est enregistré sous testcaselog, 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 testcaselog 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 }
  ]
}

Début du journal de cas de test uip tm

Signalez le début d’une entrée de journal de cas de test manuelle pour un cas de test spécifique au sein d’une exécution.

Arguments

Aucun

Options

• --execution-id <uuid> (requis) : l'exécution dans laquelle le cas de test s'exécute.
• --test-case-id <uuid> (obligatoire) : UUID interne du cas de test en cours de journalisation.
• --execution-type <type> — type d'exécution pour l'entrée de journal (par exemple, automated, manual). Facultatif.

Exemple

uip tm testcaselog start \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --test-case-id b2c3d4e5-0000-0000-0000-000000000001

Format des données

{
  "Code": "TestCaseLogStart",
  "Data": {
    "TestCaseLogId": "c3d4e5f6-0000-0000-0000-000000000001",
    "Status": "InProgress"
  }
}

fin du journal de cas de test uip tm

Signalez la fin d’une entrée de journal de cas de test démarrée manuellement.

Arguments

Aucun

Options

• --test-case-log-id <uuid> (requis) : l'ID de journal renvoyé par testcaselog start.
• --info <text> — erreur facultative ou message d'information à joindre à l’entrée de journal.

Exemple

uip tm testcaselog finish \
  --test-case-log-id c3d4e5f6-0000-0000-0000-000000000001 \
  --info "Login button not found on page"

Format des données

{
  "Code": "TestCaseLogFinish",
  "Data": {
    "TestCaseLogId": "c3d4e5f6-0000-0000-0000-000000000001",
    "Result": "Finished"
  }
}

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.
• 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 pour list-automations.