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.

projet tm uip

Syntaxe et options pour `uip tm project`, qui gère les projets Test Manager, le projet par défaut du locataire, les paramètres du projet et l'exportation et l'importation du projet entier au format.tmh des paquets.

uip tm project gère les projets Test Manager sur le locataire actuel. Le projet Test Manager est le conteneur de niveau supérieur pour les exigences, les cas de test, les ensembles de test et les exécutions. Les commandes uip tm au niveau du projet prennent --project-key ou --project-id pour sélectionner un projet. Lorsque vous transmettez les deux, --project-id est utilisé.

Le même groupe lit et définit le projet par défaut du locataire, lit et met à jour les paramètres du projet et copie un projet entier dans un .tmh package ou à partir d'un package avec export et import. Test Manager exécute les tâches d’exportation et d’importation en tant que tâches de migration en arrière-plan, qui uip tm migration inspecte et télécharge.

Synthèse​

uip tm project list [--filter <text>] [--limit <number>] [--offset <number>]
uip tm project get-default
uip tm project create --name <name> --project-key <key> [--description <text>]
uip tm project update --project-key <key> [--name <name>] [--description <text>] [--set-default]
uip tm project delete --project-key <key> -y
uip tm project set-default-folder (--project-key <key> | --project-id <id>) --folder-key <uuid>
uip tm project clear-default-folder (--project-key <key> | --project-id <id>)
uip tm project owners list --project-key <key...>
uip tm project settings get (--project-key <key> | --project-id <id>)
uip tm project settings update (--project-key <key> | --project-id <id>) [--time-zone <iana-name>] [--execution-name-format <template>]
uip tm project export (--project-key <key> | --project-id <id>) [--include <content...>] [--exclude <content...>] [--wait --output-file <path> [--overwrite] [--timeout <seconds>] [--poll-interval <seconds>]]
uip tm project import (--project-key <key> | --project-id <id> | --create-project [--new-project-name <name>] [--new-project-key <key>]) --file <path> [--include <content...>] [--exclude <content...>] [--wait [--timeout <seconds>] [--poll-interval <seconds>]]
uip tm project list [--filter <text>] [--limit <number>] [--offset <number>]
uip tm project get-default
uip tm project create --name <name> --project-key <key> [--description <text>]
uip tm project update --project-key <key> [--name <name>] [--description <text>] [--set-default]
uip tm project delete --project-key <key> -y
uip tm project set-default-folder (--project-key <key> | --project-id <id>) --folder-key <uuid>
uip tm project clear-default-folder (--project-key <key> | --project-id <id>)
uip tm project owners list --project-key <key...>
uip tm project settings get (--project-key <key> | --project-id <id>)
uip tm project settings update (--project-key <key> | --project-id <id>) [--time-zone <iana-name>] [--execution-name-format <template>]
uip tm project export (--project-key <key> | --project-id <id>) [--include <content...>] [--exclude <content...>] [--wait --output-file <path> [--overwrite] [--timeout <seconds>] [--poll-interval <seconds>]]
uip tm project import (--project-key <key> | --project-id <id> | --create-project [--new-project-name <name>] [--new-project-key <key>]) --file <path> [--include <content...>] [--exclude <content...>] [--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> pour l'élément textuel (debug, info, warn, error; par défaut Information).

liste des projets uip tm​

Répertoriez les projets Test Manager sur le locataire actuel. IsDefault est true sur le projet par défaut du locataire.

Arguments​

Aucun

Options​

DrapeauDescription
--filter <text>Filtrez les projets par nom.
--limit <number>Nombre maximal de projets à renvoyer par page. La valeur par défaut est 50.
--offset <number>Nombre de résultats à ignorer. La valeur par défaut est 0.

Exemple​

uip tm project list --limit 20 --offset 0
uip tm project list --limit 20 --offset 0

Format des données​

{
  "Code": "ProjectsList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000001",
      "ProjectKey": "DEMO",
      "Name": "Demo Project",
      "Description": "Smoke tests",
      "Active": true,
      "AuthorizationEnabled": false,
      "SapConfigured": false,
      "Created": "2025-01-01T00:00:00Z",
      "CreatedBy": "alice@example.com",
      "Updated": "2025-06-01T00:00:00Z",
      "UpdatedBy": "bob@example.com",
      "IsDefault": true
    }
  ]
}
{
  "Code": "ProjectsList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000001",
      "ProjectKey": "DEMO",
      "Name": "Demo Project",
      "Description": "Smoke tests",
      "Active": true,
      "AuthorizationEnabled": false,
      "SapConfigured": false,
      "Created": "2025-01-01T00:00:00Z",
      "CreatedBy": "alice@example.com",
      "Updated": "2025-06-01T00:00:00Z",
      "UpdatedBy": "bob@example.com",
      "IsDefault": true
    }
  ]
}

Obtenir par défaut le projet uip tm​

Obtenez le projet Test Manager par défaut du locataire. Si le locataire n’a pas de projet par défaut, la commande en crée un et le renvoie.

Le projet par défaut est celui marqué project list avec IsDefault: true. Lorsque vous exécutez des tests sans spécifier de projet, Test Manager stocke les résultats dans le projet par défaut, comme décrit dans Exécuter sans projet. Pour définir un projet différent sur la valeur par défaut, utilisez project update --set-default.

La création du projet par défaut nécessite une licence Test Manager, l’étendue TM.Projects et l’autorisation Project.Create du locataire. S'il existe un projet par défaut que vous ne pouvez pas ouvrir, la commande échoue avec une erreur d'autorisation; demandez l’accès à un administrateur Test Manager ou utilisez un projet de project list.

Arguments​

Aucun

Options​

Aucun

Exemple​

uip tm project get-default
uip tm project get-default

Format des données​

{
  "Code": "ProjectGetDefault",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "ProjectKey": "DEMO",
    "Name": "Default Project",
    "Description": "Default project for automated test executions.",
    "Active": true,
    "AuthorizationEnabled": true,
    "SapConfigured": false,
    "Created": "2026-10-01T00:00:00Z",
    "CreatedBy": "alice@example.com",
    "Updated": "2026-10-01T00:00:00Z",
    "UpdatedBy": "alice@example.com",
    "IsDefault": true
  }
}
{
  "Code": "ProjectGetDefault",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "ProjectKey": "DEMO",
    "Name": "Default Project",
    "Description": "Default project for automated test executions.",
    "Active": true,
    "AuthorizationEnabled": true,
    "SapConfigured": false,
    "Created": "2026-10-01T00:00:00Z",
    "CreatedBy": "alice@example.com",
    "Updated": "2026-10-01T00:00:00Z",
    "UpdatedBy": "alice@example.com",
    "IsDefault": true
  }
}

création de projet uip tm​

Créez un projet Test Manager. Le nouveau projet est actif.

Arguments​

Aucun

Options​

DrapeauDescription
--name <name>Requis. Nom du projet.
--project-key <key>Requis. Clé du projet, le préfixe de chaque clé d'objet dans le projet. Par exemple, les clés d'Object dans le projet DEMO ressemblent à DEMO:1.
--description <text>Description du projet en forme libre. La valeur par défaut est vide.

Exemple​

uip tm project create \
  --name "Demo Project" \
  --project-key DEMO \
  --description "Smoke tests"
uip tm project create \
  --name "Demo Project" \
  --project-key DEMO \
  --description "Smoke tests"

Format des données​

{
  "Code": "ProjectCreate",
  "Data": {
    "ProjectKey": "DEMO",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Demo Project",
    "Description": "Smoke tests",
    "IsDefault": false
  }
}
{
  "Code": "ProjectCreate",
  "Data": {
    "ProjectKey": "DEMO",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Demo Project",
    "Description": "Smoke tests",
    "IsDefault": false
  }
}

mise à jour du projet uip tm​

Mettez à jour le nom ou la description d'un projet, faites-en le projet par défaut des locataires, ou les deux. Les champs que vous omettez conservent leurs valeurs actuelles.

Arguments​

Aucun

Options​

DrapeauDescription
--project-key <key>Requis. Le projet à mettre à jour.
--name <name>Nouveau nom.
--description <text>Nouvelle description.
--set-defaultFaites de ce projet le projet par défaut du locataire, celui que get-default renvoie. Qui peut ouvrir le projet ne change pas. Un utilisateur doit être un administrateur de locataire; une application externe a besoin des étendues TM.Administration et TM.Projects .

Avec --set-default et --name ou --description, le changement de nom s’exécute en premier. Si la définition de la valeur par défaut échoue, le message d'erreur indique que le projet a été mis à jour, mais n'est pas devenu le projet par défaut.

Exemples​

# Rename a project
uip tm project update --project-key DEMO --name "Demo Project (2026)"

# Make a project the tenant default
uip tm project update --project-key DEMO --set-default
# Rename a project
uip tm project update --project-key DEMO --name "Demo Project (2026)"

# Make a project the tenant default
uip tm project update --project-key DEMO --set-default

Format des données​

{
  "Code": "ProjectUpdate",
  "Data": {
    "ProjectKey": "DEMO",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Demo Project (2026)",
    "Description": "Smoke tests",
    "IsDefault": false
  }
}
{
  "Code": "ProjectUpdate",
  "Data": {
    "ProjectKey": "DEMO",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Demo Project (2026)",
    "Description": "Smoke tests",
    "IsDefault": false
  }
}

Suppression de projet uip tm​

Supprimez un projet Test Manager par sa clé. La suppression est permanente et supprime les cas de test, les ensembles de test et l’historique d’exécution du projet.

Arguments​

Aucun

Options​

DrapeauDescription
--project-key <key>Requis. Le projet à supprimer.
-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 project delete --project-key DEMO --yes
uip tm project delete --project-key DEMO --yes

Format des données​

{
  "Code": "ProjectDelete",
  "Data": {
    "ProjectKey": "DEMO",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Result": "Deleted"
  }
}
{
  "Code": "ProjectDelete",
  "Data": {
    "ProjectKey": "DEMO",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Result": "Deleted"
  }
}

uip tm - Définir-par défaut-dossier du projet​

Définissez le dossier Orchestrator par défaut pour le projet. Les ensembles de tests créés par la suite héritent de ce dossier, sauf si vous en définissez un autre.

Arguments​

Aucun

Options​

DrapeauDescription
--project-key <key>Clé de projet Test Manager. 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é.
--folder-key <uuid>Requis. Clé de dossier Orchestrator. Obtenez-le à partir de uip or folders list.

Exemple​

uip tm project set-default-folder \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001
uip tm project set-default-folder \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001

Format des données​

{
  "Code": "ProjectSetDefaultFolder",
  "Data": {
    "ProjectKey": "DEMO",
    "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001",
    "Result": "Updated"
  }
}
{
  "Code": "ProjectSetDefaultFolder",
  "Data": {
    "ProjectKey": "DEMO",
    "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001",
    "Result": "Updated"
  }
}

ProjectKey est également renvoyé avec --project-id .

uip tm - projet clair-par défaut-dossier​

Supprimez le dossier Orchestrator par défaut d'un projet. Après avoir été effacés, les nouveaux ensembles de tests n’héritent pas automatiquement d’un dossier.

Arguments​

Aucun

Options​

DrapeauDescription
--project-key <key>Clé de projet Test Manager. 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 project clear-default-folder --project-key DEMO
uip tm project clear-default-folder --project-key DEMO

Format des données​

{
  "Code": "ProjectClearDefaultFolder",
  "Data": {
    "ProjectKey": "DEMO",
    "Result": "Cleared"
  }
}
{
  "Code": "ProjectClearDefaultFolder",
  "Data": {
    "ProjectKey": "DEMO",
    "Result": "Cleared"
  }
}

liste des propriétaires de projet uip tm​

Répertoriez les propriétaires d'un ou de plusieurs projets Test Manager dans un seul appel.

Arguments​

Aucun

Options​

DrapeauDescription
--project-key <key...>Requis. Une ou plusieurs clés de projet, séparées par des espaces ou avec l'indicateur répété.

Exemples​

# List owners of a single project
uip tm project owners list --project-key DEMO

# List owners of two projects in one call
uip tm project owners list --project-key DEMO DEMO2
# List owners of a single project
uip tm project owners list --project-key DEMO

# List owners of two projects in one call
uip tm project owners list --project-key DEMO DEMO2

Format des données​

{
  "Code": "ProjectOwnersList",
  "Data": [
    {
      "ProjectKey": "DEMO",
      "ProjectId": "a1b2c3d4-0000-0000-0000-000000000001",
      "Owners": [
        {
          "Identifier": "b2c3d4e5-0000-0000-0000-000000000001",
          "LocalIdentifier": "c3d4e5f6-0000-0000-0000-000000000001",
          "IdentityName": "jane.doe@example.com",
          "DisplayName": "Jane Doe",
          "Email": "jane.doe@example.com",
          "FirstName": "Jane",
          "LastName": "Doe",
          "ObjectType": "user",
          "Source": "AzureAD"
        }
      ]
    },
    {
      "ProjectKey": "DEMO2",
      "ProjectId": "a2b3c4d5-0000-0000-0000-000000000002",
      "Owners": []
    }
  ]
}
{
  "Code": "ProjectOwnersList",
  "Data": [
    {
      "ProjectKey": "DEMO",
      "ProjectId": "a1b2c3d4-0000-0000-0000-000000000001",
      "Owners": [
        {
          "Identifier": "b2c3d4e5-0000-0000-0000-000000000001",
          "LocalIdentifier": "c3d4e5f6-0000-0000-0000-000000000001",
          "IdentityName": "jane.doe@example.com",
          "DisplayName": "Jane Doe",
          "Email": "jane.doe@example.com",
          "FirstName": "Jane",
          "LastName": "Doe",
          "ObjectType": "user",
          "Source": "AzureAD"
        }
      ]
    },
    {
      "ProjectKey": "DEMO2",
      "ProjectId": "a2b3c4d5-0000-0000-0000-000000000002",
      "Owners": []
    }
  ]
}

Paramètres du projet uip tm - Obtenir​

Affichez les paramètres d'un projet Test Manager.

Arguments​

Aucun

Options​

DrapeauDescription
--project-key <key>Clé de projet Test Manager. 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 project settings get --project-key DEMO
uip tm project settings get --project-key DEMO

Format des données​

{
  "Code": "ProjectSettingsGet",
  "Data": {
    "Id": "d1e2f3a4-0000-0000-0000-000000000001",
    "ProjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "ProjectKey": "DEMO",
    "TimeZone": "Europe/Bucharest",
    "ExecutionNameFormat": "{Execution.Type} - {TestSet.Name} - {Execution.StartTime|yyyyMMdd.HHmmss}",
    "MaxNumberOfTestSteps": 250,
    "FolderKey": null,
    "GovernanceEnabled": false,
    "GovernanceSettings": null
  }
}
{
  "Code": "ProjectSettingsGet",
  "Data": {
    "Id": "d1e2f3a4-0000-0000-0000-000000000001",
    "ProjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "ProjectKey": "DEMO",
    "TimeZone": "Europe/Bucharest",
    "ExecutionNameFormat": "{Execution.Type} - {TestSet.Name} - {Execution.StartTime|yyyyMMdd.HHmmss}",
    "MaxNumberOfTestSteps": 250,
    "FolderKey": null,
    "GovernanceEnabled": false,
    "GovernanceSettings": null
  }
}

settings update modifie uniquement TimeZone et ExecutionNameFormat. Pour modifier FolderKey, utilisez set-default-folder. Les autres champs sont en lecture seule via la CLI.

mise à jour des paramètres du projet uip tm​

Mettez à jour le fuseau horaire d'un projet, son format de nom d'exécution, ou les deux.

Arguments​

Aucun

Options​

DrapeauDescription
--project-key <key>Clé de projet Test Manager. 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é.
--time-zone <iana-name>Fuseau horaire du projet comme nom IANA, par exemple Europe/Bucharest ou UTC. Les noms de fuseau horaire Windows tels que Romance Standard Time sont rejetés.
--execution-name-format <template>Modèle pour les noms d'exécution de test générés. Par défaut: {Execution.Type} - {TestSet.Name} - {Execution.StartTime|yyyyMMdd.HHmmss}.

Transmettez --time-zone, --execution-name-format, ou les deux. La transmission n’échoue pas avec Result: "ValidationError" et ErrorCode: "invalid_argument", et n’envoie aucune requête.

Le modèle de nom d’exécution prend en charge ces espaces réservés. Le texte hors crochets est littéral.

Espace réservéValeur (Value)
{TestSet.Name}Nom de l’ensemble de tests.
{Execution.Type}manual, automated, autonomous, exploratory, ou unspecified
{Execution.StartTime}Heure de début. Ajoutez un format de date.NET après un canal, par exemple {Execution.StartTime|yyyyMMdd.HHmmss}.
{TestSet.<custom field name>}Valeur d’un champ personnalisé d’ensemble de tests.

Les modèles de plus de 1 024 caractères sont rejetés. Un modèle plus court dont le nom rendu dépasse 1 024 caractères est tronqué avec ....

Exemples​

uip tm project settings update --project-id a1b2c3d4-0000-0000-0000-000000000001 --time-zone Europe/Bucharest

uip tm project settings update --project-key DEMO --time-zone UTC --execution-name-format "{TestSet.Name} - {Execution.StartTime|yyyyMMdd}"
uip tm project settings update --project-id a1b2c3d4-0000-0000-0000-000000000001 --time-zone Europe/Bucharest

uip tm project settings update --project-key DEMO --time-zone UTC --execution-name-format "{TestSet.Name} - {Execution.StartTime|yyyyMMdd}"

Format des données​

{
  "Code": "ProjectSettingsUpdate",
  "Data": {
    "ProjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "TimeZone": "Europe/Bucharest",
    "Result": "Updated"
  }
}
{
  "Code": "ProjectSettingsUpdate",
  "Data": {
    "ProjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "TimeZone": "Europe/Bucharest",
    "Result": "Updated"
  }
}

ProjectKey est présent lorsque vous transmettez --project-key TimeZone et ExecutionNameFormat sont présents lorsque vous les définissez. Le fuseau horaire est appliqué en premier, dans sa propre requête: lorsque la mise à jour du fuseau horaire échoue, le format du nom d'exécution n'est pas modifié, et lorsque le format du nom d'exécution est ensuite rejeté, le nouveau fuseau horaire reste appliqué et le message d'erreur l'indique .

Exportation de projet uip tm​

Exportez un projet vers un package .tmh . Test Manager crée le package dans une tâche de migration en arrière-plan et n’envoie aucune notification d’achèvement. Sans --wait, la commande renvoie la tâche et vous la vérifiez avec migration get, puis récupérez le package avec migration download. Avec --wait, la commande interroge jusqu'à ce que la tâche se termine et écrit le package dans --output-file.

Le package contient les exigences du projet, les cas de test, les ensembles de test, les libellés, les valeurs de champ personnalisé, les pièces jointes et les exécutions. --include et --exclude changent le contenu facultatif dans le tableau suivant.

Contenu (Content)DefaultAjoute
automationInclusInformations d'automatisation liées aux cas de test.
governanceExcluInformations de gouvernance.
project-configExcluConfiguration du projet. Nécessite un locataire Test Cloud; les autres locataires le rejettent avec HTTP 403.
promptsExcluInvites définies par l'utilisateur à partir de la bibliothèque d'invites du projet.

Arguments​

Aucun

Options​

DrapeauDescription
--project-key <key>Clé de projet Test Manager. 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é.
--include <content...>Contenu à ajouter au package, séparé par des espaces: governance, project-config, prompts, automation.
--exclude <content...>Contenu à omettre du package, séparé par des espaces, du même ensemble. La modification du même contenu dans --include et --exclude est refusée.
--waitInterrogez jusqu’à la fin de l’exportation, puis téléchargez le package sur --output-file.
--output-file <path>Où écrire le package .tmh . Requis avec --wait. Le répertoire parent doit exister.
--overwriteRemplacez --output-file s’il existe déjà. Sans cela, un fichier existant sera refusé avant le début de l’exportation.
--timeout <seconds>Nombre maximum de secondes à attendre; 0 signifie qu'il n'y a pas de délai d'expiration. Nécessite --wait. La valeur par défaut est 1800.
--poll-interval <seconds>Secondes entre les vérifications de statut. Nécessite --wait. La valeur par défaut est 10.

Sans --wait, --output-file, --overwrite, --timeout et --poll-interval n'ont aucun effet, et la CLI consigne un avertissement. Si la tâche se termine par Failed ou Cancelled, ou si l'attente expire, rien n'est écrit. Après un certain délai d'expiration, la tâche se poursuit; récupérer son package ultérieurement avec migration download.

Exemples​

# Export, wait for the job, and write the package
uip tm project export \
  --project-id a1b2c3d4-0000-0000-0000-000000000001 \
  --wait \
  --output-file demo.tmh

# Start the export with governance information and without automation information, and return the job
uip tm project export \
  --project-key DEMO \
  --include governance \
  --exclude automation
# Export, wait for the job, and write the package
uip tm project export \
  --project-id a1b2c3d4-0000-0000-0000-000000000001 \
  --wait \
  --output-file demo.tmh

# Start the export with governance information and without automation information, and return the job
uip tm project export \
  --project-key DEMO \
  --include governance \
  --exclude automation

Format des données (avec --wait)​

{
  "Code": "MigrationExport",
  "Data": {
    "Id": "e5f6a7b8-0000-0000-0000-000000000001",
    "Type": "ExportProject",
    "Status": "Completed",
    "OutputFile": "demo.tmh",
    "Bytes": 481203
  }
}
{
  "Code": "MigrationExport",
  "Data": {
    "Id": "e5f6a7b8-0000-0000-0000-000000000001",
    "Type": "ExportProject",
    "Status": "Completed",
    "OutputFile": "demo.tmh",
    "Bytes": 481203
  }
}

Format de données (sans --wait)​

{
  "Code": "MigrationExport",
  "Data": {
    "Id": "e5f6a7b8-0000-0000-0000-000000000001",
    "Type": "ExportProject",
    "Status": "Ready",
    "Created": "2026-09-17T10:00:00.000Z",
    "Updated": "2026-09-17T10:00:00.000Z",
    "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "ProjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "TenantId": "d4e5f6a7-0000-0000-0000-000000000004"
  },
  "Instructions": "The export runs in the background. Check it with: uip tm migration get --project-id a1b2c3d4-0000-0000-0000-000000000001 --job-id e5f6a7b8-0000-0000-0000-000000000001. Once it reads Completed, fetch the package with: uip tm migration download --project-id a1b2c3d4-0000-0000-0000-000000000001 --job-id e5f6a7b8-0000-0000-0000-000000000001 --output-file <path>"
}
{
  "Code": "MigrationExport",
  "Data": {
    "Id": "e5f6a7b8-0000-0000-0000-000000000001",
    "Type": "ExportProject",
    "Status": "Ready",
    "Created": "2026-09-17T10:00:00.000Z",
    "Updated": "2026-09-17T10:00:00.000Z",
    "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "ProjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "TenantId": "d4e5f6a7-0000-0000-0000-000000000004"
  },
  "Instructions": "The export runs in the background. Check it with: uip tm migration get --project-id a1b2c3d4-0000-0000-0000-000000000001 --job-id e5f6a7b8-0000-0000-0000-000000000001. Once it reads Completed, fetch the package with: uip tm migration download --project-id a1b2c3d4-0000-0000-0000-000000000001 --job-id e5f6a7b8-0000-0000-0000-000000000001 --output-file <path>"
}

Data sans --wait correspond à la tâche de migration car migration get la renvoie.

importation de projet uip tm​

Importez un package .tmh dans un projet existant ou dans un nouveau projet créé à partir du package. La CLI charge le fichier par segments et Test Manager le traite dans une tâche de migration en arrière-plan. Sans --wait, la commande renvoie la tâche; vérifiez-le avec migration get. Avec --wait, la commande interroge jusqu'à ce que la tâche soit terminée.

--include et --exclude basculent automation (inclus par défaut), governance et project-config (les deux exclus par défaut). L'importation de project-config nécessite un locataire Test Cloud; les autres locataires le rejettent avec HTTP 403.

Arguments​

Aucun

Options​

DrapeauDescription
--project-key <key>Clé du projet dans lequel importer. Transmettez ceci, --project-id ou --create-project.
--project-id <id>ID du projet dans lequel importer. Utiliser au lieu de --project-key Lorsque vous transmettez les deux, --project-id est utilisé.
--file <path>Requis. Le package .tmh à importer, tel qu'écrit par project export. La CLI lit l'intégralité du fichier en mémoire et refuse les packages de plus de 2 Gio, les fichiers vides et les fichiers sans manifest.json valide.
--create-projectCréez le projet cible à partir du nom, de la clé et de la description enregistrés dans le package. Le projet reste inactif jusqu'à ce que l'importation soit terminée. Ne peut pas être combiné avec --project-key ou --project-id.
--new-project-name <name>Avec --create-project: nom du nouveau projet à la place du nom du package.
--new-project-key <key>Avec --create-project: clé du nouveau projet à la place de la clé du package. Doit être libre dans ce locataire.
--include <content...>Contenu à intégrer, séparé par des espaces: governance, project-config, automation.
--exclude <content...>Contenu à omettre, séparé par des espaces, du même ensemble. La modification du même contenu dans --include et --exclude est refusée.
--waitInterrogez jusqu’à la fin de l’importation.
--timeout <seconds>Nombre maximum de secondes à attendre; 0 signifie qu'il n'y a pas de délai d'expiration. Nécessite --wait. La valeur par défaut est 14400.
--poll-interval <seconds>Secondes entre les vérifications de statut. Nécessite --wait. La valeur par défaut est 10.
Avertissement :

Un échec d'importation peut laisser une partie du package dans le projet cible. Vérifiez ou supprimez ce projet avant de l’importer à nouveau, ou importez-le dans un nouveau projet avec --create-project --new-project-key <key> Si le délai de --wait expire, l’importation se poursuit en arrière-plan; vérifiez-le avec migration get, car l'exécution à nouveau de la commande importe tout une seconde fois.

Un projet créé par --create-project reste en place, inactif, lorsque l’importation échoue. Supprimez-le avec project delete ou importez-le avec --project-key.

Exemples​

# Import into an existing project and return the job
uip tm project import \
  --project-id a1b2c3d4-0000-0000-0000-000000000001 \
  --file demo.tmh

# Create a project from the package without automation information, and wait for the import
uip tm project import \
  --create-project \
  --new-project-key DEMO2 \
  --file demo.tmh \
  --exclude automation \
  --wait
# Import into an existing project and return the job
uip tm project import \
  --project-id a1b2c3d4-0000-0000-0000-000000000001 \
  --file demo.tmh

# Create a project from the package without automation information, and wait for the import
uip tm project import \
  --create-project \
  --new-project-key DEMO2 \
  --file demo.tmh \
  --exclude automation \
  --wait

Format des données (avec --wait)​

{
  "Code": "MigrationImport",
  "Data": {
    "Id": "e5f6a7b8-0000-0000-0000-000000000002",
    "Type": "ImportProject",
    "Status": "Completed",
    "SchemaVersion": "1.0.18",
    "Created": "2026-09-17T10:05:00.000Z",
    "Updated": "2026-09-17T10:06:40.000Z",
    "ExecutionStarted": "2026-09-17T10:05:04.000Z",
    "ExecutionFinished": "2026-09-17T10:06:40.000Z",
    "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "TenantId": "d4e5f6a7-0000-0000-0000-000000000004",
    "ProjectId": "a2b3c4d5-0000-0000-0000-000000000002",
    "ProjectCreated": true,
    "PackageName": "demo.tmh",
    "Bytes": 481203,
    "Chunks": 1
  }
}
{
  "Code": "MigrationImport",
  "Data": {
    "Id": "e5f6a7b8-0000-0000-0000-000000000002",
    "Type": "ImportProject",
    "Status": "Completed",
    "SchemaVersion": "1.0.18",
    "Created": "2026-09-17T10:05:00.000Z",
    "Updated": "2026-09-17T10:06:40.000Z",
    "ExecutionStarted": "2026-09-17T10:05:04.000Z",
    "ExecutionFinished": "2026-09-17T10:06:40.000Z",
    "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "TenantId": "d4e5f6a7-0000-0000-0000-000000000004",
    "ProjectId": "a2b3c4d5-0000-0000-0000-000000000002",
    "ProjectCreated": true,
    "PackageName": "demo.tmh",
    "Bytes": 481203,
    "Chunks": 1
  }
}

Data est la tâche de migration car migration get la renvoie, plus la cible ProjectId, ProjectCreated (true lorsque --create-project a créé le projet), le PackageName téléchargé, sa taille dans Bytes, et le nombre de téléchargements Chunks. Sans --wait, la commande se renvoie une fois le téléchargement terminé, et la réponse comporte Instructions avec la commande migration get pour la tâche.

  • migration: vérifiez et téléchargez les tâches derrière export et import.
  • project-autorisations: les autorisations dont vous disposez par rapport à un projet.
  • invites: la bibliothèque d’invites du projet qui export --include prompts package.
  • testcases: créez des cas de test dans un projet.
  • testsets: regroupent les cas de test dans des suites exécutables.

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