UiPath Documentation
uipath-cli
latest
false
Guide de l'utilisateur de UiPath CLI
Important :
Ce contenu a été traduit à l'aide d'une traduction automatique. La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.

exécutions uip tm

Syntaxe et options pour `uip tm executions`, qui répertorie, filtre, exporte, réexécute, réessaie, termine, annule et supprime les exécutions de test, définit leur date de rapport et répertorie leurs journaux de cas de test.

uip tm executions inspecte et gère les exécutions de test, les objets produits par uip tm testsets run. Ces verbes répertorient, filtrent et exportent les exécutions; lire les statistiques d’exécution et les journaux de cas de test; réexécuter une exécution ou réessayer uniquement ses cas ayant échoué; fermer une exécution manuelle tôt ou annuler une exécution automatisée; enregistrer une exécution par rapport à une date de rapport; et supprimer une exécution.

La commande qui permet de lancer une exécution est uip tm testsets run, qui renvoie une ExecutionId. Chaque verbe de cette page, à l'exception de list, list-filtered et export prend cet ID.

Synthèse​

uip tm executions list (--project-key <key> | --project-id <id>) [--test-set-id <uuid>] [--filter <text>] [--status <status>] [--execution-type <type>] [--execution-finished-interval <interval>] [--limit <n>] [--offset <n>]
uip tm executions list-filtered (--project-key <key> | --project-id <id>) [--test-set-id <uuid>] [--status <status>] [--execution-type <type>] [--execution-finished-interval <interval>] [--updated-by <userId>] [--search <text>] [--labels <labels...>] [--test-execution-ids <ids...>] [--sort-by <expr>] [--limit <n>] [--offset <n>]
uip tm executions export (--project-key <key> | --project-id <id>) --output-file <path> [--test-set-id <uuid>] [--status <status>] [--execution-type <type>] [--execution-finished-interval <interval>] [--updated-by <userId>] [--search <text>] [--labels <labels...>] [--test-execution-ids <ids...>] [--sort-by <expr>]
uip tm executions testcaselogs list --execution-id <uuid> (--project-key <key> | --project-id <id>) [--only-failed] [--filter <text>] [--results <results...>] [--statuses <statuses...>] [--duration-period <period>] [--limit <n>] [--offset <n>]
uip tm executions run (--project-key <key> | --project-id <id>) --execution-id <uuid> --execution-type <type> [--test-case-log-ids <ids...>] [--async]
uip tm executions retry --execution-id <uuid> (--project-key <key> | --project-id <id> | --test-set-key <key>) [--execution-type <type>]
uip tm executions get-stats --execution-id <uuid> (--project-key <key> | --project-id <id>)
uip tm executions finish --execution-id <uuid> (--project-key <key> | --project-id <id>)
uip tm executions cancel --execution-id <uuid> (--project-key <key> | --project-id <id>)
uip tm executions set-reporting-date --execution-id <uuid> --reporting-date <date> (--project-key <key> | --project-id <id>)
uip tm executions delete --execution-id <uuid> (--project-key <key> | --project-id <id>) --yes
uip tm executions list (--project-key <key> | --project-id <id>) [--test-set-id <uuid>] [--filter <text>] [--status <status>] [--execution-type <type>] [--execution-finished-interval <interval>] [--limit <n>] [--offset <n>]
uip tm executions list-filtered (--project-key <key> | --project-id <id>) [--test-set-id <uuid>] [--status <status>] [--execution-type <type>] [--execution-finished-interval <interval>] [--updated-by <userId>] [--search <text>] [--labels <labels...>] [--test-execution-ids <ids...>] [--sort-by <expr>] [--limit <n>] [--offset <n>]
uip tm executions export (--project-key <key> | --project-id <id>) --output-file <path> [--test-set-id <uuid>] [--status <status>] [--execution-type <type>] [--execution-finished-interval <interval>] [--updated-by <userId>] [--search <text>] [--labels <labels...>] [--test-execution-ids <ids...>] [--sort-by <expr>]
uip tm executions testcaselogs list --execution-id <uuid> (--project-key <key> | --project-id <id>) [--only-failed] [--filter <text>] [--results <results...>] [--statuses <statuses...>] [--duration-period <period>] [--limit <n>] [--offset <n>]
uip tm executions run (--project-key <key> | --project-id <id>) --execution-id <uuid> --execution-type <type> [--test-case-log-ids <ids...>] [--async]
uip tm executions retry --execution-id <uuid> (--project-key <key> | --project-id <id> | --test-set-key <key>) [--execution-type <type>]
uip tm executions get-stats --execution-id <uuid> (--project-key <key> | --project-id <id>)
uip tm executions finish --execution-id <uuid> (--project-key <key> | --project-id <id>)
uip tm executions cancel --execution-id <uuid> (--project-key <key> | --project-id <id>)
uip tm executions set-reporting-date --execution-id <uuid> --reporting-date <date> (--project-key <key> | --project-id <id>)
uip tm executions delete --execution-id <uuid> (--project-key <key> | --project-id <id>) --yes

Tous les verbes respectent les options globales et les codes de sortie standard.

liste des exécutions uip tm​

Répertoriez les exécutions d’un projet, éventuellement limitées à un seul ensemble de tests.

Arguments​

Aucun

Options​

DrapeauDescription
--project-key <key>Propriétaire de la clé de projet. Transmettez ceci ou --project-id.
--project-id <id>Propriétaire de l'ID de projet. Utiliser au lieu de --project-key Lorsque vous transmettez les deux, --project-id est utilisé.
--test-set-id <uuid>UUID de l'ensemble de tests (le champ Id de testsets list, non TestSetKey). Omettez de répertorier les exécutions dans l’ensemble du projet.
--filter <text>Recherchez des exécutions par nom.
--status <status>Filtrer par statut d'exécution unique: pending, running, cancelling, finished, cancelled.
--execution-type <type>Filtrez par un seul type d'exécution (automated, manual, mixed, none, autonomous).
--execution-finished-interval <interval>Filtrez par date de fin d'exécution: lastHour, lastDay, lastWeek, last15Days, last30Days.
--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 executions list \
  --project-key DEMO \
  --test-set-id a1b2c3d4-0000-0000-0000-000000000001 \
  --limit 2
uip tm executions list \
  --project-key DEMO \
  --test-set-id a1b2c3d4-0000-0000-0000-000000000001 \
  --limit 2

Format des données​

{
  "Code": "ExecutionsList",
  "Data": [
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000001",
      "Name": "Nightly Run 2025-04-15",
      "Status": "Finished",
      "Passed": 18,
      "Failed": 0
    },
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000002",
      "Name": "Nightly Run 2025-04-14",
      "Status": "Finished",
      "Passed": 16,
      "Failed": 2
    }
  ]
}
{
  "Code": "ExecutionsList",
  "Data": [
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000001",
      "Name": "Nightly Run 2025-04-15",
      "Status": "Finished",
      "Passed": 18,
      "Failed": 0
    },
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000002",
      "Name": "Nightly Run 2025-04-14",
      "Status": "Finished",
      "Passed": 16,
      "Failed": 2
    }
  ]
}

Chaque ligne comporte les mêmes champs que get-stats; l'exemple montre un sous-ensemble.

Exécutions UIP tm filtrées par liste​

Répertoriez les exécutions dans un projet à l’aide de l’ensemble de filtres côté serveur. Aucun ensemble de tests n’est requis. --status et --execution-type prennent chacun une valeur unique; filtrer par heure de fin avec --execution-finished-interval.

Arguments​

Aucun

Options​

DrapeauDescription
--project-key <key>Propriétaire de la clé de projet. Transmettez ceci ou --project-id.
--project-id <id>Propriétaire de l'ID de projet. Utiliser au lieu de --project-key Lorsque vous transmettez les deux, --project-id est utilisé.
--test-set-id <uuid>Limitez les résultats à un seul UUID d’ensemble de tests (le Id de testsets list, et non la clé de l’ensemble de tests).
--status <status>Filtrer par statut d'exécution unique: pending, running, cancelling, finished, cancelled.
--execution-type <type>Filtrez par un seul type d'exécution (automated, manual, mixed, none, autonomous).
--execution-finished-interval <interval>Filtrez par date de fin d'exécution: lastHour, lastDay, lastWeek, last15Days, last30Days.
--updated-by <userId>Filtrez par l'ID utilisateur qui a mis à jour l'exécution pour la dernière fois.
--search <text>Recherchez des exécutions par nom.
--labels <labels...>Noms de libellés séparés par des espaces par lesquels filtrer.
--test-execution-ids <ids...>UUID d'exécution séparés par des espaces à inclure.
--sort-by <expr>Expression de tri: un nom de champ et une direction, par exemple 'executionFinished desc'.
--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 executions list-filtered \
  --project-key DEMO \
  --labels nightly regression \
  --status finished \
  --sort-by 'executionFinished desc' \
  --limit 10
uip tm executions list-filtered \
  --project-key DEMO \
  --labels nightly regression \
  --status finished \
  --sort-by 'executionFinished desc' \
  --limit 10

Format des données​

{
  "Code": "ExecutionsListFiltered",
  "Data": [
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000001",
      "Name": "Nightly Run 2025-04-15",
      "Status": "Finished",
      "ExecutionType": "automated",
      "Passed": 18,
      "Failed": 2
    }
  ]
}
{
  "Code": "ExecutionsListFiltered",
  "Data": [
    {
      "Id": "b2c3d4e5-0000-0000-0000-000000000001",
      "Name": "Nightly Run 2025-04-15",
      "Status": "Finished",
      "ExecutionType": "automated",
      "Passed": 18,
      "Failed": 2
    }
  ]
}

Chaque ligne comporte les mêmes champs que get-stats; l'exemple montre un sous-ensemble.

exportation d’exécutions uip tm​

Exportez les exécutions auxquelles un filtre correspond vers un fichier .xlsx , une ligne par exécution avec des colonnes fixes. Chaque Name cellule renvoie à Test Manager. Le verbe prend les mêmes filtres que list-filtered et lit chaque page, il n'a donc pas --limit ou --offset. Pour le propre fichier de rapport d'une exécution (Excel, PDF ou JUnit), utilisez report export.

Nécessite l'autorisation de lecture d'exécution de Test Manager et une licence d'utilisateur, afin qu'un appelant qui peut exécuter list-filtered puisse toujours être refusé ici.

Remarque :

Un filtre qui ne correspond à rien écrit toujours un classeur valide sans ligne et renvoie Result: "Success". Vérifiez le filtre, et non le code de sortie.

Arguments​

Aucun

Options​

DrapeauDescription
--project-key <key>Propriétaire de la clé de projet. Transmettez ceci ou --project-id.
--project-id <id>Propriétaire de l'ID de projet. Utiliser au lieu de --project-key Lorsque vous transmettez les deux, --project-id est utilisé.
--output-file <path>Requis. Chemin d’accès où écrire le fichier .xlsx . Les répertoires manquants sont créés.
--test-set-id <uuid>Limitez les résultats à un seul UUID d’ensemble de tests (le Id de testsets list, et non la clé de l’ensemble de tests).
--status <status>Filtrer par statut d'exécution unique: pending, running, cancelling, finished, cancelled.
--execution-type <type>Filtrez par un seul type d'exécution (automated, manual, mixed, none, autonomous).
--execution-finished-interval <interval>Filtrez par date de fin d'exécution: lastHour, lastDay, lastWeek, last15Days, last30Days.
--updated-by <userId>Filtrez par l'ID utilisateur qui a mis à jour l'exécution pour la dernière fois.
--search <text>Recherchez des exécutions par nom.
--labels <labels...>Noms de libellés séparés par des espaces par lesquels filtrer.
--test-execution-ids <ids...>UUID d'exécution séparés par des espaces à inclure.
--sort-by <expr>Expression de tri: un nom de champ et une direction, par exemple 'executionFinished desc'.

Exemple​

uip tm executions export \
  --project-key DEMO \
  --test-set-id a1b2c3d4-0000-0000-0000-000000000010 \
  --output-file ./executions.xlsx
uip tm executions export \
  --project-key DEMO \
  --test-set-id a1b2c3d4-0000-0000-0000-000000000010 \
  --output-file ./executions.xlsx

Format des données​

{
  "Code": "ExecutionExport",
  "Data": {
    "OutputFile": "./executions.xlsx",
    "Bytes": 2048,
    "ProjectKey": "DEMO",
    "Result": "Exported"
  }
}
{
  "Code": "ExecutionExport",
  "Data": {
    "OutputFile": "./executions.xlsx",
    "Bytes": 2048,
    "ProjectKey": "DEMO",
    "Result": "Exported"
  }
}

Liste des journaux de cas de test d'exécutions uip tm​

Répertorie les journaux de cas de test produits par une exécution. Chaque journal est l'exécution d'un cas de test, qui porte son résultat, son statut et sa synchronisation.

Arguments​

Aucun

Options​

DrapeauDescription
--execution-id <uuid>Requis. Exécution à inspecter.
--project-key <key>Propriétaire de la clé de projet. Transmettez ceci ou --project-id.
--project-id <id>Propriétaire de l'ID de projet. Utiliser au lieu de --project-key Lorsque vous transmettez les deux, --project-id est utilisé.
--only-failedAfficher uniquement les journaux ayant échoué.
--filter <text>Recherchez les journaux par nom.
--results <results...>Résultats séparés par des espaces par lesquels filtrer: None, Passed, Failed, Restricted.
--statuses <statuses...>Statuts de journal séparés par des espaces par lesquels filtrer: pending, running, cancelling, cancelled, finished, failed.
--duration-period <period>Filtrez par date d’exécution du journal: last7Days, last15Days, last30Days, last90Days, last180Days, last365Days.
--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 executions testcaselogs list \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO \
  --only-failed
uip tm executions testcaselogs list \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO \
  --only-failed

Format des données​

{
  "Code": "ExecutionTestCaseLogs",
  "Data": [
    {
      "Id": "c3d4e5f6-0000-0000-0000-000000000001",
      "TestCaseId": "a1b2c3d4-0000-0000-0000-000000000010",
      "TestExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
      "Result": "Failed",
      "Status": "Finished",
      "ExecutionType": "automated",
      "ExecutionStart": "2025-04-15T10:00:00Z",
      "ExecutionEnd": "2025-04-15T10:05:00Z",
      "Info": "Assertion failed on step 3",
      "TestCase": {
        "Id": "a1b2c3d4-0000-0000-0000-000000000010",
        "ObjKey": "DEMO:1",
        "Name": "Login flow"
      }
    }
  ]
}
{
  "Code": "ExecutionTestCaseLogs",
  "Data": [
    {
      "Id": "c3d4e5f6-0000-0000-0000-000000000001",
      "TestCaseId": "a1b2c3d4-0000-0000-0000-000000000010",
      "TestExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
      "Result": "Failed",
      "Status": "Finished",
      "ExecutionType": "automated",
      "ExecutionStart": "2025-04-15T10:00:00Z",
      "ExecutionEnd": "2025-04-15T10:05:00Z",
      "Info": "Assertion failed on step 3",
      "TestCase": {
        "Id": "a1b2c3d4-0000-0000-0000-000000000010",
        "ObjKey": "DEMO:1",
        "Name": "Login flow"
      }
    }
  ]
}

Chaque ligne correspond au journal de cas de test complet avec son cas de test imbriqué sous TestCase; l'exemple montre un sous-ensemble. Chaque Id est un UUID du journal de cas de test. Transmettez-le à uip tm testcaselog list-assertions pour voir pourquoi un journal a été marqué Failed.

Exécutions UiPtm​

Réexécutez une exécution existante par son ID. Cela ne démarre pas une nouvelle exécution; il rejoue dans le même enregistrement d'exécution, ciblant tous les cas de test ou un sous-ensemble spécifique de journaux de cas de test.

Remarque :

Pour démarrer une nouvelle exécution, utilisez uip tm testsets run à la place.

Arguments​

Aucun

Options​

DrapeauDescription
--project-key <key>Propriétaire de la clé de projet. Transmettez ceci ou --project-id.
--project-id <id>Propriétaire de l'ID de projet. Utiliser au lieu de --project-key Lorsque vous transmettez les deux, --project-id est utilisé.
--execution-id <uuid>Requis. ID de l'exécution existante à réexécuter.
--execution-type <type>Requis. Quels cas de test exécuter (automated, manual, mixed, none, autonomous).
--test-case-log-ids <ids...>UUID du journal de cas de test séparé par des espaces. Lorsqu'ils sont fournis, seuls ces journaux spécifiques sont réexécutés.
--asyncRetournez immédiatement après la mise en file d'attente.

Exemples​

# re-run the entire execution
uip tm executions run \
  --project-key DEMO \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --execution-type automated

# re-run specific logs only
uip tm executions run \
  --project-key DEMO \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --execution-type automated \
  --test-case-log-ids c3d4e5f6-0000-0000-0000-000000000001 c3d4e5f6-0000-0000-0000-000000000002
# re-run the entire execution
uip tm executions run \
  --project-key DEMO \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --execution-type automated

# re-run specific logs only
uip tm executions run \
  --project-key DEMO \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --execution-type automated \
  --test-case-log-ids c3d4e5f6-0000-0000-0000-000000000001 c3d4e5f6-0000-0000-0000-000000000002

Format des données​

{
  "Code": "ExecutionRun",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Succeeded"
  }
}
{
  "Code": "ExecutionRun",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Succeeded"
  }
}

Status: "Succeeded" signifie que Test Manager a accepté la demande d'exécution, et non que les cas de test ont réussi. Il lit la même chose avec ou sans --async. Vérifiez le résultat avec get-stats ou wait.

Nouvelle tentative d’exécutions uip tm​

Réessayer uniquement les cas de test ayant échoué d’une exécution terminée, en place. La commande lit d'abord les statistiques d'exécution et refuse une exécution dont le statut n'est pas Finished ou Cancelled. Si aucun cas de test n’a échoué, il quitte 0 avec un message. La nouvelle tentative utilise le même ID d’exécution.

Arguments​

Aucun

Options​

DrapeauDescription
--execution-id <uuid>Requis. Exécution à réessayer.
--project-key <key>Propriétaire de la clé de projet.
--project-id <id>Propriétaire de l'ID de projet. Utiliser au lieu de --project-key
--test-set-key <key>Clé d'ensemble de tests (par exemple, DEMO:42); la clé du projet est dérivée du préfixe.
--execution-type <type>Type d'exécution pour la nouvelle tentative: automated, manual, mixed ou none. La valeur par défaut est automated.

Transmettez --project-id, --project-key ou --test-set-key. Lorsque vous transmettez plus d'un élément, --project-id est utilisé en premier, puis --project-key, puis le préfixe du projet --test-set-key.

Exemple​

uip tm executions retry \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO
uip tm executions retry \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO

Format des données (échec de la nouvelle tentative)​

{
  "Code": "ExecutionRetry",
  "Data": {
    "ExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Running",
    "StartTime": "2025-04-15T10:30:00Z",
    "RetriedCount": 3
  }
}
{
  "Code": "ExecutionRetry",
  "Data": {
    "ExecutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "Status": "Running",
    "StartTime": "2025-04-15T10:30:00Z",
    "RetriedCount": 3
  }
}

Format des données (aucun échec de nouvelle tentative)​

{
  "Code": "ExecutionRetry",
  "Data": {
    "Message": "Execution 'a1b2c3d4-0000-0000-0000-000000000001' has no failed test cases to retry."
  }
}
{
  "Code": "ExecutionRetry",
  "Data": {
    "Message": "Execution 'a1b2c3d4-0000-0000-0000-000000000001' has no failed test cases to retry."
  }
}

Obtenir les statistiques des exécutions uip tm​

Obtenez une exécution de test par ID avec tous ses champs d'exécution ainsi que les réussites, les échecs et aucuns comptes agrégés. Utilisez-le pour vérifier si une exécution est terminée avant d'appeler report get, ou pour extraire des données de synchronisation et de couverture pour les rapports externes.

Arguments​

Aucun

Options​

DrapeauDescription
--execution-id <uuid>Requis. UUID de l’exécution de test. Obtenez-le à partir de uip tm testsets run ou uip tm testcases run.
--project-key <key>Clé de projet Test Manager (par exemple, DEMO). Transmettez ceci ou --project-id.
--project-id <id>ID de projet Test Manager. Utiliser au lieu de --project-key Lorsque vous transmettez les deux, --project-id est utilisé.

Exemple​

uip tm executions get-stats \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO
uip tm executions get-stats \
  --execution-id a1b2c3d4-0000-0000-0000-000000000001 \
  --project-key DEMO

Format des données​

{
  "Code": "ExecutionStats",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Nightly Run 2025-04-15",
    "Description": "Smoke + regression suite",
    "Status": "Finished",
    "ExecutionType": "automated",
    "Source": "TestManager",
    "SourceDetails": "",
    "ProjectId": "00000000-0000-0000-0000-000000000abc",
    "TestSetId": "a1b2c3d4-0000-0000-0000-000000000010",
    "TestSetObjKey": "DEMO:10",
    "TestSetScheduleId": "",
    "BatchExecutionKey": "",
    "Passed": 8,
    "Failed": 2,
    "None": 0,
    "Duration": 3600000,
    "RunId": 12,
    "EnforceExecutionOrder": false,
    "EnableCoverage": false,
    "IsRunningAutomated": false,
    "HasTestsFromMultipleAutomationProjects": false,
    "RemoteControlAccess": "Disabled",
    "ExecutionStart": "2025-04-15T10:00:00Z",
    "ExecutionFinished": "2025-04-15T11:00:00Z",
    "ReportingDate": "2025-04-15T11:00:00Z",
    "FolderKey": "11111111-2222-3333-4444-555555555555",
    "Created": "2025-04-15T09:55:00Z",
    "CreatedBy": "11111111-2222-3333-4444-555555555555",
    "Updated": "2025-04-15T11:00:00Z",
    "UpdatedBy": "11111111-2222-3333-4444-555555555555",
    "AutopilotForRobotsSettings": { "Enabled": false },
    "OrderedExecutionSettings": { "Enabled": false },
    "VideoRecordingSettings": { "Enabled": false }
  }
}
{
  "Code": "ExecutionStats",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Nightly Run 2025-04-15",
    "Description": "Smoke + regression suite",
    "Status": "Finished",
    "ExecutionType": "automated",
    "Source": "TestManager",
    "SourceDetails": "",
    "ProjectId": "00000000-0000-0000-0000-000000000abc",
    "TestSetId": "a1b2c3d4-0000-0000-0000-000000000010",
    "TestSetObjKey": "DEMO:10",
    "TestSetScheduleId": "",
    "BatchExecutionKey": "",
    "Passed": 8,
    "Failed": 2,
    "None": 0,
    "Duration": 3600000,
    "RunId": 12,
    "EnforceExecutionOrder": false,
    "EnableCoverage": false,
    "IsRunningAutomated": false,
    "HasTestsFromMultipleAutomationProjects": false,
    "RemoteControlAccess": "Disabled",
    "ExecutionStart": "2025-04-15T10:00:00Z",
    "ExecutionFinished": "2025-04-15T11:00:00Z",
    "ReportingDate": "2025-04-15T11:00:00Z",
    "FolderKey": "11111111-2222-3333-4444-555555555555",
    "Created": "2025-04-15T09:55:00Z",
    "CreatedBy": "11111111-2222-3333-4444-555555555555",
    "Updated": "2025-04-15T11:00:00Z",
    "UpdatedBy": "11111111-2222-3333-4444-555555555555",
    "AutopilotForRobotsSettings": { "Enabled": false },
    "OrderedExecutionSettings": { "Enabled": false },
    "VideoRecordingSettings": { "Enabled": false }
  }
}
ChampSignification
Passed, Failed, NoneNombre agrégé de journaux de cas de test pour l'exécution.
DurationDurée totale d'exécution en millisecondes.
StatusÉtat de l’exécution. Lorsque Finished, les décomptes sont définitifs. Une exécution fermée tôt avec finish conserve Status: "Running".
ExecutionFinishedLorsque l'exécution se ferme, par elle-même ou via finish.
IsRunningAutomatedtrue tandis que les cas de test automatisés sont toujours en cours d'envoi aux robots.
Remarque :

get-stats renvoie l'enregistrement d'exécution brut avec les comptes. Pour obtenir un résumé formaté avec des messages d'échec par cas de test, utilisez uip tm report get à la place.

Fin des exécutions uip tm​

Fermez une exécution de test manuelle tôt, tant que certains de ses journaux de cas de test ne sont pas encore terminés. Une exécution dont les journaux sont tous terminés s’est déjà fermée, utilisez-la uniquement pour en terminer une plus tôt. Test Manager refuse une exécution pour laquelle aucun journal de cas de test n’a encore commencé, une exécution qui dispose déjà d’un horodatage ExecutionFinished et une exécution provenant d’Orchestrator. Nécessite l'autorisation d'exécution manuelle de Test Manager.

Avertissement :

finish tamponne ExecutionFinished sans définir Status, ce qui reste Running. Reconnaîtez une exécution fermée tôt par son horodatage ExecutionFinished . uip tm wait sur une telle exécution bloque jusqu'à ce qu'il soit --timeout (par défaut 1800 secondes), puis signale un délai d'attente.

Arguments​

Aucun

Options​

DrapeauDescription
--execution-id <uuid>Requis. Exécution à fermer.
--project-key <key>Propriétaire de la clé de projet. Transmettez ceci ou --project-id.
--project-id <id>Propriétaire de l'ID de projet. Utiliser au lieu de --project-key Lorsque vous transmettez les deux, --project-id est utilisé.

Exemple​

uip tm executions finish \
  --execution-id a1b2c3d4-0000-0000-0000-000000000002 \
  --project-key DEMO
uip tm executions finish \
  --execution-id a1b2c3d4-0000-0000-0000-000000000002 \
  --project-key DEMO

Format des données​

{
  "Code": "ExecutionFinish",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000002",
    "Name": "UAT session 1",
    "Status": "Running",
    "ExecutionType": "Manual",
    "Passed": 1,
    "Failed": 0,
    "None": 1,
    "ExecutionStart": "2026-09-22T11:30:00Z",
    "ExecutionFinished": "2026-09-22T11:45:00Z"
  }
}
{
  "Code": "ExecutionFinish",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000002",
    "Name": "UAT session 1",
    "Status": "Running",
    "ExecutionType": "Manual",
    "Passed": 1,
    "Failed": 0,
    "None": 1,
    "ExecutionStart": "2026-09-22T11:30:00Z",
    "ExecutionFinished": "2026-09-22T11:45:00Z"
  }
}

Data correspond à l'exécution relue après la fermeture, avec les mêmes champs que get-stats; l'exemple montre un sous-ensemble. Si la lecture échoue, Data ne contient que Id.

annulation des exécutions uip tm​

Demandez à Test Manager d'arrêter une exécution automatisée en cours et ses tâches Orchestrator. Une exécution manuelle n'a pas de tâche à arrêter; fermer l'autre avec executions finish Nécessite l'autorisation d'exécution automatisée et un utilisateur sous licence.

Result: "Success" signifie uniquement que Test Manager a accepté la requête. Lisez Data.Status pour savoir ce qui s'est passé.

Data.StatusSignification
CancellingTest Manager a enregistré l'arrêt.
RunningL'arrêt a été transféré à Orchestrator. L'exécution atteint Cancelled lors du rapport d'Orchestrator.
Un statut terminal (Finished, Cancelled)L'exécution était déjà terminée.

Interrogez avec uip tm wait jusqu'à ce que l'exécution atteigne un statut terminal.

Arguments​

Aucun

Options​

DrapeauDescription
--execution-id <uuid>Requis. Exécution à annuler.
--project-key <key>Propriétaire de la clé de projet. Transmettez ceci ou --project-id.
--project-id <id>Propriétaire de l'ID de projet. Utiliser au lieu de --project-key Lorsque vous transmettez les deux, --project-id est utilisé.

Exemple​

uip tm executions cancel \
  --execution-id a1b2c3d4-0000-0000-0000-000000000003 \
  --project-key DEMO
uip tm executions cancel \
  --execution-id a1b2c3d4-0000-0000-0000-000000000003 \
  --project-key DEMO

Format des données​

{
  "Code": "ExecutionCancel",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000003",
    "Name": "Regression Test Set - 20260922.1130",
    "Status": "Cancelling",
    "ExecutionType": "Automated",
    "Passed": 1,
    "Failed": 0,
    "None": 3,
    "ExecutionStart": "2026-09-22T11:30:00Z"
  }
}
{
  "Code": "ExecutionCancel",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000003",
    "Name": "Regression Test Set - 20260922.1130",
    "Status": "Cancelling",
    "ExecutionType": "Automated",
    "Passed": 1,
    "Failed": 0,
    "None": 3,
    "ExecutionStart": "2026-09-22T11:30:00Z"
  }
}

Data correspond à l'exécution relancée après la demande d'annulation, avec les mêmes champs que get-stats; l'exemple montre un sous-ensemble. Si la lecture échoue, Data ne contient que Id.

Exécutions uip tm set-reporting-date​

Réservez une exécution de test pour un jour donné, afin que les rapports la comptent ce jour plutôt que le jour où il a été exécuté. Le fait de la définir à nouveau remplace la date précédente. Nécessite l'autorisation de modification d'exécution.

Remarque :

La date est jointe au résultat de l'exécution, qui n'existe qu'une fois l'exécution fermée. Sur une exécution ouverte, la commande renvoie un 404 qui nomme le résultat plutôt que l'exécution. Fermez l'exécution avec testcaselog finish sur chaque journal, ou forcez-la avec executions finish

Arguments​

Aucun

Options​

DrapeauDescription
--execution-id <uuid>Requis. Exécution à réserver.
--reporting-date <date>Requis. Jour de réserve, dans ISO 8601 (par exemple, 2026-09-21 ou 2026-09-21T10:00:00Z). Une date seule réserve l'UTC minuit. Une heure doit avoir un décalage (Z ou +hh:mm). L'instant UTC doit être compris entre 2019-01-01 et 9999-12-31. Une date non valide échoue avec Result: "ValidationError" avant toute requête.
--project-key <key>Propriétaire de la clé de projet. Transmettez ceci ou --project-id.
--project-id <id>Propriétaire de l'ID de projet. Utiliser au lieu de --project-key Lorsque vous transmettez les deux, --project-id est utilisé.

Exemple​

uip tm executions set-reporting-date \
  --execution-id a1b2c3d4-0000-0000-0000-000000000002 \
  --reporting-date 2026-09-21 \
  --project-key DEMO
uip tm executions set-reporting-date \
  --execution-id a1b2c3d4-0000-0000-0000-000000000002 \
  --reporting-date 2026-09-21 \
  --project-key DEMO

Format des données​

{
  "Code": "ExecutionSetReportingDate",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000002",
    "Name": "UAT session 1",
    "Status": "Running",
    "ExecutionType": "Manual",
    "ReportingDate": "2026-09-21T00:00:00.000Z"
  }
}
{
  "Code": "ExecutionSetReportingDate",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000002",
    "Name": "UAT session 1",
    "Status": "Running",
    "ExecutionType": "Manual",
    "ReportingDate": "2026-09-21T00:00:00.000Z"
  }
}

Data correspond à l'exécution relancée après la mise à jour, avec les mêmes champs que get-stats; l'exemple montre un sous-ensemble. Si la lecture échoue, Data ne contient que Id.

suppression des exécutions uip tm​

Supprimez une exécution de test avec les journaux de cas de test et les instantanés de journal qu'elle contient. L'exécution n'apparaît alors plus dans list ou list-filtered. Nécessite l'autorisation d'exécution-suppression de Test Manager.

Avertissement :

Le serveur n’a pas de garde-fou: toute exécution peut être supprimée, qu’elle soit en cours d’exécution ou non. Si vous souhaitez également arrêter les tâches Orchestrator d'une exécution automatisée, exécutez d'abord executions cancel .

Arguments​

Aucun

Options​

DrapeauDescription
--execution-id <uuid>Requis. Exécution à supprimer.
--project-key <key>Propriétaire de la clé de projet. Transmettez ceci ou --project-id.
--project-id <id>Propriétaire de l'ID de projet. Utiliser au lieu de --project-key Lorsque vous transmettez les deux, --project-id est utilisé.
-y, --yesRequis. Confirme l’opération irréversible. La CLI ne s’affiche jamais; sans --yes la commande renvoie Result: "Failure" et quitte 1.

Exemple​

uip tm executions delete \
  --execution-id a1b2c3d4-0000-0000-0000-000000000002 \
  --project-key DEMO \
  --yes
uip tm executions delete \
  --execution-id a1b2c3d4-0000-0000-0000-000000000002 \
  --project-key DEMO \
  --yes

Format des données​

{
  "Code": "ExecutionDelete",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000002",
    "Result": "Deleted"
  }
}
{
  "Code": "ExecutionDelete",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000002",
    "Result": "Deleted"
  }
}

Codes de sortie​

Le modèle CI standard est un pipeline en trois étapes:

  1. Lancer — uip tm testsets run renvoie une ExecutionId et quitte 0
  2. Bloquer — uip tm wait interrogations jusqu'à ce que l'exécution atteigne un état terminal. Quitte 0 lorsque vous avez terminé, 2 lors du délai d'expiration, 1 lors de l'échec.
  3. Verdict — uip tm report get lit les chiffres Passed et Failed . Votre script échoue explicitement la génération.
id=$(uip tm testsets run \
  --test-set-key DEMO:10 \
  --execution-type automated \
  --output-filter ExecutionId --output plain)

uip tm wait --execution-id "$id" --project-key DEMO --timeout 1800
code=$?
[ "$code" -eq 2 ] && { echo "timed out" >&2; exit 2; }
[ "$code" -ne 0 ] && { echo "wait failed ($code)" >&2; exit "$code"; }

failed=$(uip tm report get \
  --execution-id "$id" --project-key DEMO --output-filter Failed --output plain)
[ "$failed" -gt 0 ] && { echo "$failed test(s) failed" >&2; exit 1; }
echo "all passed"
id=$(uip tm testsets run \
  --test-set-key DEMO:10 \
  --execution-type automated \
  --output-filter ExecutionId --output plain)

uip tm wait --execution-id "$id" --project-key DEMO --timeout 1800
code=$?
[ "$code" -eq 2 ] && { echo "timed out" >&2; exit 2; }
[ "$code" -ne 0 ] && { echo "wait failed ($code)" >&2; exit "$code"; }

failed=$(uip tm report get \
  --execution-id "$id" --project-key DEMO --output-filter Failed --output plain)
[ "$failed" -gt 0 ] && { echo "$failed test(s) failed" >&2; exit 1; }
echo "all passed"

Pour un package déjà téléchargé vers Orchestrator, uip tm run effectue les trois étapes dans une seule commande et se termine sans zéro lorsqu'un test échoue.

  • exécution des ensembles de tests — le démarrage d'une exécution.
  • exécuter — exécuter chaque test dans un package téléchargé, attendre et écrire un rapport en une seule étape.
  • attendre — bloquer jusqu'à ce qu'une exécution atteigne un état terminal.
  • rapport, résultat, pièce jointe — artefacts post-exécution.
  • testcaselog — démarrer, terminer et inspecter les journaux de cas de test individuels; list-assertions transforme un journal échoué en détail par assertion.

Voir également​

Cette page vous a-t-elle été utile ?

Connecter

Besoin d'aide ? Assistance(opens in new window)

Vous souhaitez apprendre ? UiPath Academy(opens in new window)

Vous avez des questions ? UiPath Forum(opens in new window)

Rester à jour