UiPath Documentation
uipath-cli
latest
false
Guía del usuario de UiPath CLI
Importante :
Este contenido se ha traducido mediante traducción automática. La localización de contenidos recién publicados puede tardar entre una y dos semanas en estar disponible.

proyecto uip tm

Sintaxis y opciones para `uip tm project`, que gestiona proyectos de Test Manager, el proyecto predeterminado del tenant, la configuración del proyecto y la exportación e importación de todo el proyecto como .tmh paquetes.

uip tm project los proyectos de Test Manager en el tenant actual. Un proyecto de Test Manager es el contenedor de nivel superior para requisitos, casos de prueba, conjuntos de pruebas y ejecuciones; los comandos uip tm con ámbito de proyecto toman --project-key o --project-id para seleccionar un proyecto. Cuando pasas ambos, se utiliza --project-id .

El mismo grupo lee y establece el proyecto predeterminado del tenant, lee y actualiza la configuración del proyecto y copia un proyecto completo en un paquete .tmh o en uno con export y import. Test Manager ejecuta la exportación e importación como trabajos de migración en segundo plano, que uip tm migration inspecciona y descarga.

Sinopsis​

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

Todos los verbos respetan las opciones globales y los códigos de salida estándar. Cada verbo acepta --log-level <level> para verbosidad (debug, info, warn, error; predeterminado Information).

lista de proyectos de uip tm​

Enumera los proyectos de Test Manager en el tenant actual. IsDefault es true en el proyecto predeterminado del tenant.

Argumentos​

Nada.

Opciones​

MarcaDescripción
--filter <text>Filtrar proyectos por nombre.
--limit <number>Número máximo de proyectos a devolver por página. El valor predeterminado es 50.
--offset <number>Número de resultados que se omitirán. El valor predeterminado es 0.

Ejemplo​

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

Forma de datos​

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

uip tm project get-default​

Obtén el proyecto de Test Manager predeterminado del tenant. Si el tenant no tiene un proyecto predeterminado, el comando crea uno y lo devuelve.

El proyecto predeterminado es el que project list marca con IsDefault: true. Al ejecutar pruebas sin especificar un proyecto, Test Manager almacena los resultados en el proyecto predeterminado, como se describe en Ejecutar sin proyecto. Para hacer que un proyecto diferente sea el predeterminado, utiliza project update --set-default.

La creación del proyecto predeterminado necesita una licencia de Test Manager, el ámbito TM.Projects y el permiso Project.Create del tenant. Si existe un proyecto predeterminado que no puedes abrir, el comando falla con un error de permiso; pide acceso a un administrador de Test Manager o utiliza un proyecto de project list.

Argumentos​

Nada.

Opciones​

Nada.

Ejemplo​

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

Forma de datos​

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

creación de proyecto uip tm​

Crea un proyecto de Test Manager. El nuevo proyecto está activo.

Argumentos​

Nada.

Opciones​

MarcaDescripción
--name <name>Obligatorio. Nombre del proyecto.
--project-key <key>Obligatorio. Clave del proyecto, el prefijo de cada clave de objeto en el proyecto. Por ejemplo, las claves de objeto en el proyecto DEMO se parecen a DEMO:1.
--description <text>Descripción del proyecto de forma libre. El valor predeterminado es vacío.

Ejemplo​

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"

Forma de datos​

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

actualización del proyecto uip tm​

Actualizar el nombre o la descripción de un proyecto, convertirlo en el proyecto predeterminado del tenant, o ambos. Los campos que omites mantienen sus valores actuales.

Argumentos​

Nada.

Opciones​

MarcaDescripción
--project-key <key>Obligatorio. El proyecto que se actualizará.
--name <name>Nuevo nombre.
--description <text>Nueva descripción.
--set-defaultConvierte este proyecto en el proyecto predeterminado del tenant, el que devuelve get-default . Quién puede abrir el proyecto no cambia. Un usuario debe ser administrador de tenant; una aplicación externa necesita los ámbitos TM.Administration y TM.Projects .

Con --set-default y --name o --description, el cambio de nombre se ejecuta primero. Si la configuración predeterminada falla, el mensaje de error indica que el proyecto se actualizó pero no se convirtió en el predeterminado.

Ejemplos​

# 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

Forma de datos​

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

eliminación de proyecto uip tm​

Eliminar un proyecto de Test Manager por su clave. La eliminación es permanente y elimina los casos de prueba, los conjuntos de pruebas y el historial de ejecución del proyecto.

Argumentos​

Nada.

Opciones​

MarcaDescripción
--project-key <key>Obligatorio. El proyecto que se va a eliminar.
-y, --yesObligatorio. Confirma la operación irreversible. La CLI nunca solicita; sin --yes el comando devuelve Result: "Failure" y sale de 1.

Ejemplo​

uip tm project delete --project-key DEMO --yes
uip tm project delete --project-key DEMO --yes

Forma de datos​

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

conjunto-carpeta-predeterminada del proyecto uip tm​

Establece la carpeta predeterminada de Orchestrator para el proyecto. Los conjuntos de pruebas creados posteriormente heredan esta carpeta a menos que establezcas otra.

Argumentos​

Nada.

Opciones​

MarcaDescripción
--project-key <key>Clave de proyecto de Test Manager. Aprueba esto o --project-id.
--project-id <id>ID del proyecto de Test Manager. Utilizar en lugar de --project-key. Cuando pasas ambos, se utiliza --project-id .
--folder-key <uuid>Obligatorio. Clave de carpeta de Orchestrator (UUID). Obtenlo de uip or folders list.

Ejemplo​

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

Forma de datos​

{
  "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 también se devuelve con --project-id .

proyecto uip tm borrar-carpeta-predeterminada​

Elimina la carpeta predeterminada de Orchestrator de un proyecto. Después de borrar, los nuevos conjuntos de pruebas no heredan una carpeta automáticamente.

Argumentos​

Nada.

Opciones​

MarcaDescripción
--project-key <key>Clave de proyecto de Test Manager. Aprueba esto o --project-id.
--project-id <id>ID del proyecto de Test Manager. Utilizar en lugar de --project-key. Cuando pasas ambos, se utiliza --project-id .

Ejemplo​

uip tm project clear-default-folder --project-key DEMO
uip tm project clear-default-folder --project-key DEMO

Forma de datos​

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

lista de propietarios de proyectos de uip tm​

Enumera los propietarios de uno o más proyectos de Test Manager en una sola llamada.

Argumentos​

Nada.

Opciones​

MarcaDescripción
--project-key <key...>Obligatorio. Una o más claves de proyecto, separadas por espacios o con el marcador repetido.

Ejemplos​

# 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

Forma de datos​

{
  "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": []
    }
  ]
}

configuración del proyecto uip tm obtener​

Muestra la configuración de un proyecto de Test Manager.

Argumentos​

Nada.

Opciones​

MarcaDescripción
--project-key <key>Clave de proyecto de Test Manager. Aprueba esto o --project-id.
--project-id <id>ID del proyecto de Test Manager. Utilizar en lugar de --project-key. Cuando pasas ambos, se utiliza --project-id .

Ejemplo​

uip tm project settings get --project-key DEMO
uip tm project settings get --project-key DEMO

Forma de datos​

{
  "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 solo cambia TimeZone y ExecutionNameFormat. Para cambiar FolderKey, utiliza set-default-folder. Los otros campos son de solo lectura a través de la CLI.

actualización de la configuración del proyecto uip tm​

Actualizar la zona horaria de un proyecto, su formato de nombre de ejecución o ambos.

Argumentos​

Nada.

Opciones​

MarcaDescripción
--project-key <key>Clave de proyecto de Test Manager. Aprueba esto o --project-id.
--project-id <id>ID del proyecto de Test Manager. Utilizar en lugar de --project-key. Cuando pasas ambos, se utiliza --project-id .
--time-zone <iana-name>Zona horaria del proyecto como nombre IANA, por ejemplo Europe/Bucharest o UTC. Se rechazan los nombres de zona horaria de Windows como Romance Standard Time .
--execution-name-format <template>Plantilla para los nombres de ejecución de prueba generados. Predeterminado: {Execution.Type} - {TestSet.Name} - {Execution.StartTime|yyyyMMdd.HHmmss}.

Aprobar --time-zone, --execution-name-format o ambos. Pasar ninguno falla con Result: "ValidationError" y ErrorCode: "invalid_argument", y no envía ninguna solicitud.

La plantilla de nombre de ejecución admite estos marcadores de posición. El texto fuera de las llaves es literal.

Marcador de posiciónValor
{TestSet.Name}Nombre del conjunto de pruebas.
{Execution.Type}manual, automated, autonomous, exploratory o unspecified.
{Execution.StartTime}Hora de inicio. Añade un formato de fecha .NET después de una canalización, por ejemplo {Execution.StartTime|yyyyMMdd.HHmmss}.
{TestSet.<custom field name>}Valor de un campo personalizado del conjunto de pruebas.

Se rechaza una plantilla de más de 1024 caracteres. Una plantilla más corta cuyo nombre renderizado tiene más de 1024 caracteres se trunca con ....

Ejemplos​

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

Forma de datos​

{
  "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á presente cuando pasas --project-key. TimeZone y ExecutionNameFormat están presentes cuando los configuras. La zona horaria se aplica primero, en su propia solicitud: cuando la actualización de la zona horaria falla, el formato del nombre de ejecución no cambia, y cuando se rechaza el formato del nombre de ejecución, la nueva zona horaria permanece aplicada y el mensaje de error lo indica .

exportación de proyecto uip tm​

Exporta un proyecto a un paquete .tmh . Test Manager crea el paquete en un trabajo de migración en segundo plano y no envía ninguna notificación de finalización. Sin --wait, el comando devuelve el trabajo y lo compruebas con migration get, luego recuperas el paquete con migration download. Con --wait, el comando sondea hasta que el trabajo finaliza y escribe el paquete en --output-file.

El paquete contiene los requisitos del proyecto, casos de prueba, conjuntos de pruebas, etiquetas, valores de campo personalizados, archivos adjuntos y ejecuciones. --include y --exclude intercambian el contenido opcional en la siguiente tabla.

ContenidoPredeterminadoAgrega
automationIncluidoInformación de automatización vinculada a casos de prueba.
governanceExcluidoInformación de control.
project-configExcluidoConfiguración del proyecto. Necesita un tenant de Test Cloud; otros tenants lo rechazan con HTTP 403.
promptsExcluidoSolicitudes definidas por el usuario de la biblioteca de solicitudes del proyecto.

Argumentos​

Nada.

Opciones​

MarcaDescripción
--project-key <key>Clave de proyecto de Test Manager. Aprueba esto o --project-id.
--project-id <id>ID del proyecto de Test Manager. Utilizar en lugar de --project-key. Cuando pasas ambos, se utiliza --project-id .
--include <content...>Contenido para añadir al paquete, separado por espacios: governance, project-config, prompts, automation.
--exclude <content...>Contenido que se va a dejar fuera del paquete, separado por espacios, del mismo conjunto. Se ha rechazado nombrar el mismo contenido en --include y --exclude .
--waitSondea hasta que finalice la exportación y, a continuación, descarga el paquete en --output-file.
--output-file <path>Dónde escribir el paquete .tmh . Obligatorio con --wait. El directorio principal debe existir.
--overwriteReemplaza --output-file si ya existe. Sin ella, se rechaza un archivo existente antes de que se inicie la exportación.
--timeout <seconds>Máximo de segundos de espera; 0 significa que no hay tiempo de espera. Requiere --wait. El valor predeterminado es 1800.
--poll-interval <seconds>Segundos entre comprobaciones de estado. Requiere --wait. El valor predeterminado es 10.

Sin --wait, --output-file, --overwrite, --timeout y --poll-interval no tienen efecto, y la CLI registra una advertencia. Si el trabajo finaliza como Failed o Cancelled, o el tiempo de espera se agota, no se escribe nada. Después de un tiempo de espera, el trabajo sigue ejecutándose; recuperar su paquete más tarde con migration download.

Ejemplos​

# 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

Forma de datos (con --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
  }
}

Forma de datos (sin --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 sin --wait es el trabajo de migración, ya que migration get lo devuelve.

importación de proyecto uip tm​

Importa un paquete .tmh a un proyecto existente o a un nuevo proyecto creado a partir del paquete. CLI carga el archivo en fragmentos y Test Manager lo procesa en un trabajo de migración en segundo plano. Sin --wait, el comando devuelve el trabajo; compruébalo con migration get. Con --wait, el comando sondea hasta que finaliza el trabajo.

--include y --exclude cambian automation (incluido de forma predeterminada), governance y project-config (ambos excluidos de forma predeterminada). La importación de project-config necesita un tenant de Test Cloud; otros tenants lo rechazan con HTTP 403.

Argumentos​

Nada.

Opciones​

MarcaDescripción
--project-key <key>Clave del proyecto al que importar. Pasa esto, --project-id o --create-project.
--project-id <id>ID del proyecto al que importar. Utilizar en lugar de --project-key. Cuando pasas ambos, se utiliza --project-id .
--file <path>Obligatorio. El paquete .tmh a importar, tal como está escrito por project export. La CLI lee todo el archivo en la memoria y rechaza paquetes de más de 2 GiB, archivos vacíos y archivos sin un manifest.json válido.
--create-projectCrea el proyecto de destino a partir del nombre, la clave y la descripción registrados en el paquete. El proyecto permanece inactivo hasta que finaliza la importación. No se puede combinar con --project-key o --project-id.
--new-project-name <name>Con --create-project: nombre del nuevo proyecto en lugar del nombre del paquete.
--new-project-key <key>Con --create-project: clave para el nuevo proyecto en lugar de la clave del paquete. Debe estar libre en este tenant.
--include <content...>Contenido a traer, separado por espacios: governance, project-config, automation.
--exclude <content...>Contenido a omitir, separado por espacios, del mismo conjunto. Se ha rechazado nombrar el mismo contenido en --include y --exclude .
--waitSondear hasta que finalice la importación.
--timeout <seconds>Máximo de segundos de espera; 0 significa que no hay tiempo de espera. Requiere --wait. El valor predeterminado es 14400.
--poll-interval <seconds>Segundos entre comprobaciones de estado. Requiere --wait. El valor predeterminado es 10.
ADVERTENCIA:

Una importación fallida puede dejar parte del paquete en el proyecto de destino. Comprueba o elimina ese proyecto antes de volver a importar, o importa a un nuevo proyecto con --create-project --new-project-key <key>. Si --wait se agota, la importación sigue ejecutándose en segundo plano; compruébalo con migration get, porque ejecutar el comando de nuevo importa todo una segunda vez.

Un proyecto que --create-project realizó permanece en su lugar, inactivo, cuando falla la importación. Elimínalo con project delete o impórtalo con --project-key.

Ejemplos​

# 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

Forma de datos (con --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 es el trabajo de migración tal como migration get lo devuelve, más el destino ProjectId, ProjectCreated (true cuando --create-project hizo el proyecto), el PackageName cargado, su tamaño en Bytes, y el número de cargas Chunks. Sin --wait, el comando vuelve una vez que finaliza la carga, y la respuesta lleva Instructions con el comando migration get para el trabajo.

Ver también​

¿Te ha resultado útil esta página?

Conectar

¿Necesita ayuda? Soporte(opens in new window)

¿Quiere aprender? UiPath Academy(opens in new window)

¿Tiene alguna pregunta? Foro de UiPath(opens in new window)

Manténgase actualizado