Restaurar dependencias de automatización

Requisitos previos

• Crea una aplicación externa.
• Ejecuta el archivo CLI exe (para Windows Legacy) o dll (para Windows/Linux/macOS).
• Añade los ámbitos de aplicación de acceso a la API de Orchestrator necesarios.

Para restaurar las dependencias, sigue los siguientes pasos:

1. Ejecuta la tarea package , utilizando uipcli package. Puedes ver una lista de las subtareas disponibles.

2. Especifica los parámetros necesarios y ejecuta la subtarea restore .

   La siguiente tabla describe los parámetros necesarios:

   Parámetro	Descripción
   Project(s) Path (pos. 0)	Obligatorio. La ruta a un archivo project.json , o a una carpeta que contiene archivos project.json .
   --restoreFolder	Obligatorio. Restaurar la ruta de la carpeta de destino.
   --nugetConfigFilePath	Opcional. Ruta al archivo NuGet.Config que contiene las fuentes. La etiqueta <clear /> del archivo especificado se ignorará y solo se tendrán en cuenta las fuentes.
   --disableBuiltInNugetFeeds	Deshabilite las fuentes nuget integradas.
   --excludeConfiguredSources	Opcional. Excluye las fuentes integradas y las fuentes de NuGet configuradas a nivel de usuario y máquina en el host que ejecuta la CLI. La CLI resuelve los paquetes solo a partir de las fuentes definidas en --nugetConfigFilePath Consulta Gestionar fuentes NuGet.
   -u, --libraryOrchestratorUsername	Opcional, útil solo cuando tienes dependencias de una biblioteca en Orchestrator. El nombre de usuario de Orchestrator utilizado para la autenticación. Debe utilizarse junto con la contraseña.
   -p, --libraryOrchestratorPassword	Opcional, útil solo cuando tienes dependencias de una biblioteca en Orchestrator. La contraseña de Orchestrator utilizada para la autenticación. Debe utilizarse junto con el nombre de usuario.
   -t, --libraryOrchestratorAuthToken	Opcional, útil solo cuando tienes dependencias de una biblioteca en Orchestrator. El token de actualización de Orchestrator utilizado para la autenticación. Debe utilizarse junto con el nombre de la organización y el ID de cliente.
   -a, --libraryOrchestratorAccountName	Opcional, útil solo cuando tienes dependencias de una biblioteca en Orchestrator. El nombre de la organización de Orchestrator. Debe utilizarse junto con el token de actualización y el ID de cliente.
   -A, --libraryOrchestratorAccountForApp	Opcional, útil solo cuando tienes dependencias de una biblioteca en Orchestrator. El nombre de la organización de Orchestrator. Debe utilizarse junto con el ID, el secreto y los ámbitos para la aplicación externa.
   -I, --libraryOrchestratorApplicationId	Opcional, útil solo cuando tienes dependencias de una biblioteca en Orchestrator. El ID de la aplicación externa. Debe utilizarse junto con el nombre de la organización, el secreto y los ámbitos para la aplicación externa.
   -S, --libraryOrchestratorApplicationSecret	Opcional, útil solo cuando tienes dependencias de una biblioteca en Orchestrator. El secreto de la aplicación externa. Debe utilizarse junto con el nombre de la organización, el ID y los ámbitos para la aplicación externa.
   --libraryOrchestratorApplicationScope	Opcional, útil solo cuando tienes dependencias de una biblioteca en Orchestrator. La lista de ámbitos de aplicación separados por espacios. Debe utilizarse junto con el nombre, el ID y el secreto de la organización para la aplicación externa.
   --libraryOrchestratorUrl	Opcional, útil solo cuando tienes dependencias de una biblioteca en Orchestrator. La URL de Orchestrator.
   --libraryOrchestratorTenant	Opcional, útil solo cuando tienes dependencias de una biblioteca en Orchestrator. El tenant de Orchestrator.
   --libraryIdentityUrl	La URL de tu servidor de identidad. Obligatorio cuando la biblioteca Orchestrator se ejecuta en UiPath Automation Suite o en Orchestrator independiente (MSI local). No es necesario para Automation Cloud : la CLI resuelve el servidor de identidad desde la URL de la nube.
   --traceLevel	Especifica qué tipos de mensajes de registro generar uno de los siguientes valores: Ninguno, Crítico, Error, Advertencia, Información, Detallado. Valor predeterminado: Información.
   -l, --language	Idioma de los registros traducidos.
   --ca-cert	Uno o más archivos de certificado de CA raíz de confianza (PEM, DER o PKCS#7) utilizados al validar los certificados TLS de Orchestrator e Identity Server. Repite el marcador o separa con comas varias rutas. Consulta Confiar en certificados personalizados para obtener más detalles.
   --pinnedpubkey	Anclar la clave pública del certificado de hoja del servidor. Formato: sha256//<base64>. Se comprueba además de la validación de certificados estándar. Consulta Confiar en certificados personalizados para obtener más detalles.

Nota:

Al utilizar la autenticación de aplicaciones externas sin especificar el parámetro --libraryOrchestratorApplicationScope , la CLI aplica automáticamente estos ámbitos predeterminados de Orchestrator:

OR.Assets OR.BackgroundTasks OR.Execution OR.Folders OR.Robots.Read OR.Machines.Read OR.Jobs OR.TestSets OR.TestSetExecutions OR.Monitoring OR.Settings.Read

Consejo:

Para las instancias de Orchestrator firmadas por una autoridad de certificación privada (como UiPath Automation Suite), este comando también acepta los parámetros --ca-cert y --pinnedpubkey . Consulta Confiar en certificados personalizados para escenarios y ejemplos.

Uso

uipcli package restore <project_path> --restoreFolder <restore_directory> --nugetConfigFilePath <nuget_config_path> [--libraryOrchestratorUrl <orchestrator_url> --libraryOrchestratorTenant <orchestrator_tenant>] [--u <orchestrator_user> --p <orchestrator_pass>] [--t <auth_token> --a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --libraryOrchestratorApplicationScope <application_scope>] [--libraryIdentityUrl <identity_url>] [--libraryOrchestratorFolder <folder_name>] [-l <language>] [--disableBuiltInNugetFeeds] [--excludeConfiguredSources] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>]

Ejemplos de comandos mínimos

• uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder ""C:\userprofile\DependencyPackages" --nugetConfigFilePath "C:\userprofile\Package\NuGet.Config"
• uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --libraryOrchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --libraryOrchestratorTenant "TenantName" -u "orchestratorUsername" -p "********" --orchestratorFolder "FolderName"
• uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --libraryOrchestratorUrl "https://orch-23-10-paas.cloudapp.azure.com/" --libraryOrchestratorTenant "TenantName" -A "organizationName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S '********' --libraryOrchestratorApplicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --libraryOrchestratorFolder "FolderName" --libraryIdentityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity"
• uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --libraryOrchestratorUrl "https://automation-suite.base.url.com/" --libraryOrchestratorTenant "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S '********' --libraryOrchestratorApplicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --libraryOrchestratorFolder "FolderName"
• uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --libraryOrchestratorUrl "https://cloud.uipath.com/" --libraryOrchestratorTenant "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S '********' --libraryOrchestratorApplicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --libraryOrchestratorFolder "FolderName"

Restauración hermética: resuelve las dependencias solo desde el nuget.config explícito

• uipcli package restore "C:\userprofile\AutomationProject" --traceLevel Information --restoreFolder "C:\userprofile\DependencyPackages" --nugetConfigFilePath "C:\ci\nuget.config" --excludeConfiguredSources