Implementar activos en Orchestrator

Prerequisites:

• Crea un archivo CSV que contenga los activos que quieres implementar en Orchestrator.

  El archivo CSV debe tener las siguientes tres columnas: name, type, valuey description.

• Ejecuta el archivo CLI exe (para Windows) o dll (para Linux).

• Añade los ámbitos de aplicación de acceso a la API de Orchestrator necesarios.

Para obtener más información sobre el archivo CSV, consulta el ejemplo de la siguiente tabla.

name	Tipo	valor	Descripción
asset_1_name	text	"tengo un comentario"	asset_1_description
asset_2_name	Entero	1	asset_2_description
asset_3_name	Booleano	false	asset_3_description
asset_4_name	Credencial	nombre de usuario:contraseña	asset_4_description

Para implementar activos en Orchestrator, sigue los siguientes pasos:

1. Ejecuta la tarea asset , utilizando uipcli asset. Puedes ver una lista de las subtareas disponibles.
2. Especifica los parámetros necesarios y ejecuta la subtarea deploy . La siguiente tabla describe los parámetros necesarios.

Parámetro	Descripción
-u o --username ( obligatorio si utilizas la autenticación básica , mediante un nombre de usuario y una contraseña)	El nombre de usuario utilizado para autenticarse en Orchestrator. Debe emparejarlo con la contraseña correspondiente.
-p o --password ( obligatorio si utilizas la autenticación básica , mediante un nombre de usuario y una contraseña)	La contraseña utilizada para autenticarse en Orchestrator. Debes emparejarlo con el nombre de usuario correspondiente.
-t o --token ( Obligatorio si utilizas la autenticación basada en tokens )	El token de actualización OAuth2 utilizado para autenticarse en Orchestrator. Debes emparejarlo con el Nombre de cuenta y el ID de cliente .
-a o --accountName ( Obligatorio si utilizas la autenticación basada en tokens )	El nombre de la cuenta de Orchestrator CloudRPA. Debes emparejarlo con el token de actualización OAuth2 y el ID de cliente .
-A , or --accountForApp	El nombre de la cuenta de Orchestrator CloudRPA (nombre de la organización). Debes emparejarlo con el ID de la aplicación, el Secreto de la aplicación y el Ámbito de la aplicación para aplicaciones externas.
-I o --applicationId ( Obligatorio si utilizas la autenticación de aplicación externa )	El ID de aplicación externo. Debes emparejarlo con la Cuenta de la aplicación, el Secreto de la aplicación y el Ámbito de la aplicación.
-S o --applicationSecret ( Obligatorio si utilizas la autenticación de aplicación externa )	El Secreto de la aplicación externo. Debes emparejarlo con la Cuenta de la aplicación, ID de la aplicación y Ámbito de la aplicación.
--applicationScope ( Opcional para la autenticación de aplicaciones externas )	La lista de ámbitos de aplicación, separados por espacios individuales. Opcional cuando se utiliza la autenticación de aplicaciones externas, ya que los ámbitos predeterminados se aplican automáticamente. Debes emparejarlo con la cuenta de la aplicación , el ID de la aplicación y el secreto de la aplicación para la aplicación externa.
-o , or --organizationUnit	El nombre de la carpeta de Orchestrator (unidad de organización). Para introducir subcarpetas, asegúrate de introducir tanto el nombre de la carpeta principal como el nombre de la subcarpeta. Por ejemplo, AccountingTeam\TeamJohnusa .
-l , or --language	El idioma utilizado en la interfaz de usuario de Orchestrator.
--traceLevel	Mostrar el seguimiento de los eventos.
--identityUrl ( Obligatorio para implementaciones de PaaS o MSI )	La URL de su servidor de identidad.
--help	Muestra los parámetros y ejemplos de este comando.
--version	Mostrar información de la versión.
Assets File (pos. 0) ( Obligatorio )	El nombre del archivo CSV que contiene los activos que quieres eliminar.
Orchestrator URL (pos.1) ( Obligatorio )	La URL de la instancia de Orchestrator.
Orchestrator Tenant (pos.2) ( Obligatorio ) para implementaciones de SaaP. ( Opcional ) para implementaciones de PaaS.	El tenant de la instancia de Orchestrator, donde quieres gestionar tus activos.

Nota:

Al utilizar la autenticación de aplicaciones externas sin especificar el parámetro --applicationScope , 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

Uso:

uipcli asset deploy <assets_file> <orchestrator_url> <orchestrator_tenant> [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-l <language>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identity_url>]

Ejemplos de comandos mínimos:

• uipcli asset deploy "C:\userprofile\assets.csv" "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel "Information"
• uipcli asset deploy "C:\userprofile\assets.csv" "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S "********" --applicationScope "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" --identityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity" -o "FolderName" --traceLevel "Information"
• uipcli asset deploy "C:\userprofile\assets.csv" "https://automation-suite.base.url.com/" "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S "********" --applicationScope "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" -o "FolderName" --traceLevel "Information
• uipcli asset deploy "C:\userprofile\assets.csv" "https://cloud.uipath.com/" "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S "********" --applicationScope "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" -o "FolderName" --traceLevel "Information"