- Información general
- Comience ya
- Conceptos
- Uso de UiPath CLI
- Guías prácticas
- Recetas de CI/CD
- Referencia de los comandos
- Información general
- Códigos de salida
- Opciones globales
- agente de código UIP
- codificador UIP
- Contextualización de UIP
- UIP Docsai
- Función uip
- barreras de seguridad de UIP
- Configuración de UIP llm
- puerta de enlace llm de uip
- Creación de UIP Maestro
- Registro maestro de UIP
- UIP model-hub
- Actividades Buscar
- actividades get-default-xaml
- Analizar
- lista de reglas del analizador
- Crear
- Limpieza
- instalación de data-fabric-entities
- lista de entidades de data-fabric
- diferencia de archivos
- obtener-repositorio-de-objetos-de-biblioteca
- obtener-objeto-repositorio
- Init
- lista de instancias
- Paquete
- inspeccionar paquetes
- instalación de paquetes
- versiones de paquetes
- Publicar
- Remoto
- restore
- ejecutar, depurar & Ejecución
- Configuración
- Inicio de Studio
- Búsqueda de plantillas
- entidad de adición de datos de prueba
- añadir-cola de datos de prueba
- añadir-variación de los datos de prueba
- TM
- UIA
- Validar
- ejemplos-de-flujo-de-flujo-obtener
- lista de ejemplos de flujo de trabajo
- Tareas de UIP
- Archivo adjunto
- Campo personalizado
- Defects
- Ejecuciones
- exportar-trabajos
- Migración
- EtiquetaDeObjeto
- Paquete
- escenario de rendimiento
- grupos de carga de escenarios de rendimiento
- datos de ejecución de perf-scenario
- informe de escenario de rendimiento
- Proyecto
- permisos del proyecto
- Solicitudes
- Informar
- Requisitos
- Resultado
- Iniciar
- Programaciones
- Registro de casos de prueba
- Casos de prueba
- Conjuntos de prueba
- registro de pasos de prueba
- Usuario
- Esperar
- Seguimientos de UIP
- Comentarios de seguimientos de UIP
- Migración
- Referencia y soporte
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
| Marca | Descripció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
| Marca | Descripció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
| Marca | Descripción |
|---|---|
--project-key <key> | Obligatorio. El proyecto que se actualizará. |
--name <name> | Nuevo nombre. |
--description <text> | Nueva descripción. |
--set-default | Convierte 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
| Marca | Descripción |
|---|---|
--project-key <key> | Obligatorio. El proyecto que se va a eliminar. |
-y, --yes | Obligatorio. 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
| Marca | Descripció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
| Marca | Descripció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
| Marca | Descripció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
| Marca | Descripció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
| Marca | Descripció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ón | Valor |
|---|---|
{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.
| Contenido | Predeterminado | Agrega |
|---|---|---|
automation | Incluido | Información de automatización vinculada a casos de prueba. |
governance | Excluido | Información de control. |
project-config | Excluido | Configuración del proyecto. Necesita un tenant de Test Cloud; otros tenants lo rechazan con HTTP 403. |
prompts | Excluido | Solicitudes definidas por el usuario de la biblioteca de solicitudes del proyecto. |
Argumentos
Nada.
Opciones
| Marca | Descripció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 . |
--wait | Sondea 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. |
--overwrite | Reemplaza --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
| Marca | Descripció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-project | Crea 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 . |
--wait | Sondear 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. |
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.
Relacionado
- migración: comprueba y descarga los trabajos detrás de
exportyimport. - permisos-proyecto: los permisos que tienes en un proyecto.
- solicitudes: la biblioteca de solicitudes del proyecto que
export --include promptsempaqueta. - casos de prueba: crea casos de prueba dentro de un proyecto.
- conjuntos de pruebas: agrupa los casos de prueba en suites ejecutables.
Ver también
- Descripción general de Test Manager
uip or folders list: origen de la carpeta UUID utilizada porset-default-folder.
- Sinopsis
- lista de proyectos de uip tm
- Argumentos
- Opciones
- Ejemplo
- Forma de datos
- uip tm project get-default
- Argumentos
- Opciones
- Ejemplo
- Forma de datos
- creación de proyecto uip tm
- Argumentos
- Opciones
- Ejemplo
- Forma de datos
- actualización del proyecto uip tm
- Argumentos
- Opciones
- Ejemplos
- Forma de datos
- eliminación de proyecto uip tm
- Argumentos
- Opciones
- Ejemplo
- Forma de datos
- conjunto-carpeta-predeterminada del proyecto uip tm
- Argumentos
- Opciones
- Ejemplo
- Forma de datos
- proyecto uip tm borrar-carpeta-predeterminada
- Argumentos
- Opciones
- Ejemplo
- Forma de datos
- lista de propietarios de proyectos de uip tm
- Argumentos
- Opciones
- Ejemplos
- Forma de datos
- configuración del proyecto uip tm obtener
- Argumentos
- Opciones
- Ejemplo
- Forma de datos
- actualización de la configuración del proyecto uip tm
- Argumentos
- Opciones
- Ejemplos
- Forma de datos
- exportación de proyecto uip tm
- Argumentos
- Opciones
- Ejemplos
- Forma de datos (con
--wait) - Forma de datos (sin
--wait) - importación de proyecto uip tm
- Argumentos
- Opciones
- Ejemplos
- Forma de datos (con
--wait) - Relacionado
- Ver también