Ejecutar un trabajo dentro de Orchestrator

• Crea un proceso en Orchestrator.
• 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.

1. Ejecuta la tarea job, utilizando uipcli job. Ahora puedes ver una lista de las subtareas disponibles.
2. Especifica los parámetros necesarios y ejecuta la subtarea run .
   Consulta la lista de parámetros a continuación.

   Parámetro	Descripción
   -io --input_path (solo serequiere si el punto de entrada del flujo de trabajo tiene parámetros de entrada)	La ruta completa al archivo de entrada JSON correspondiente al proceso que desea ejecutar. Ejemplo de formato de archivo JSON: { "StringArgument_In": "MyConfigurationValue", "IntArgument_In": 1, "DictionaryArgument_In": { "Key1": "Value1", "Key2": "Value2" } }
   -Po --priority	La prioridad con la que desea ejecutar el trabajo: - Baja. Normal (predeterminado). Alto.
   -ro --robots	Una lista de nombres de robots específicos, separados por comas.
   -jo --jobscount	El número de veces que desea ejecutar el proceso. El número predeterminado de veces que se ejecuta el proceso es una.
   -Uo --user	El nombre del usuario. Debe ser un usuario de la máquina, no un usuario de Orchestrator. Para usuarios locales, el formato es NómbreDeMáquina\NombreDeUsuario.
   -Mo --machine	El nombre de la máquina en la que desea ejecutar el proceso.
   -Ro --result_path	La ruta completa a un archivo JSON o a una carpeta donde quieres almacenar los resultados del trabajo. Los resultados se devuelven como archivos JSON.
   -Wo --timeout	El tiempo de espera para las ejecuciones de trabajos (segundos). El valor predeterminado es 1800 segundos.
   -fo --fail_when_job_fails	El comando falla cuando se produce un error en un trabajo. El valor predeterminado es Verdadero.
   -wo --wait	El comando espera a que finalice el trabajo. El valor predeterminado es Verdadero.
   -bo --job_type (solo para carpetas modernas)	El tipo de runtime para el trabajo. Puede elegir: - Unattended- NonProduction.
   -u, o --username (necesario cuando 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 (necesario cuando 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.
   -to --token (obligatorio si utiliza la autenticación basada en token)	El token de actualización OAuth2 que se usa para autenticarse en Orchestrator. Debe emparejarlo con el nombre de la cuenta y la ID del cliente.
   -ao --accountName (obligatorio si utiliza la autenticación basada en token)	El nombre de la cuenta de Orchestrator CloudRPA. Debes emparejarlo con el token de actualización de OAuth2 y el ID de cliente.
   -Ao --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 la aplicación externa.
   -I, o --applicationId(necesario cuando 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(necesario cuando 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 (necesario cuando utilizas la autenticación de aplicación externa)	La lista de ámbitos de aplicación, separados por espacios individuales. Debes emparejarlo con la Cuenta de la aplicación, ID de la aplicación y el Secreto de la aplicación para aplicaciones externas.
   -oo --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, --language	El lenguaje de Orchestrator.
   -y, --disableTelemetry	Deshabilitar los datos de telemetría.
   --traceLevel	Mostrar el seguimiento de los eventos.
   --identityUrl (necesario solo para implementaciones de PaaS)	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.
   Process Name (pos.0) (obligatorio)	El nombre del proceso que desea ejecutar.
   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 ejecutar los procesos.

Uso:

job run <process_name> <orchestrator_url> <orchestrator_tenant> [-i <input_path>] [-j <jobscount>] [-R <result_path>] [-P <priority>] [-r <robots>] [-f <do_not_fail_when_job_fails>] [-W <timeout>] [-w <do_not_wait>] [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <account_for_app> -I <application_id> -S <application_secret> --applicationScope] [-o <folder_organization_unit>] [-l <language>]

Ejemplos:

• job run ProcessName "https://uipath-orchestrator.myorg.com" default -u admin -p 123456

• job run ProcessName "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -P Low

• job run ProcessName "https://uipath-orchestrator.myorg.com" default -u admin -p 123456 -P Normal -o MyFolder

• NombreDelProceso de ejecución del trabajo "https://uipath-orchestrator.myorg.com" predeterminado -u admin -p 123456 -P High -o MyFolder

• job run ProcessName "https://uipath-orchestrator.myorg.com" default -t a7da29a2c93a717110a82 -a myAccount -f false -W 0

• NombreDelProceso de ejecución del trabajo "https://uipath-orchestrator.myorg.com" predeterminado -t a7da29a2c93a717110a82 -a miCuenta -P High -j 3 -w falso

• job run ProcessName "https://uipath-orchestrator.myorg.com" default -t a7da29a2c93a717110a82 -a myAccount -P Low -r robotName -R C:\Temp

• NombreDelProceso de ejecución del trabajo "https://uipath-orchestrator.myorg.com" predeterminado -t a7da29a2c93a717110a82 -a mi cuenta -r robotName -RC: \ Temp \ status.json

• job run ProcessName "https://uipath-orchestrator.myorg.com" default -A accountForExternalApp -I myExternalAppId -S myExternalAppSecret --applicationScope "OR.Folders.Read OR.Settings.Read" -r robotName -R C:\Temp\status.json

Añadir una aplicación externa

Para registrar una aplicación externa para que pueda acceder a tus recursos UiPath utilizando OAuth:

1. Inicia sesión en el tenant como Administrador.
2. Ve a Tenant > Gestionar acceso > Asignar roles y haz clic en Administrar cuentas y grupos.

   Se abre el nivel de tenant.

3. A la izquierda, selecciona Aplicaciones externas.

   Aparecerá la página Aplicaciones externas, con una lista de todas las aplicaciones externas registradas para el tenant actual:

   
   

   

   
   
4. Encima de la tabla, a la derecha, haz clic en Añadir aplicación.
5. Rellena el campo Nombre de la aplicación.
6. Selecciona una opción para el Tipo de aplicación.

   Si seleccionas Aplicación confidencial, recibirás un secreto de la aplicación al final, así que asegúrate de que tu aplicación puede almacenarlo de forma segura. Si no se puede, selecciona Solicitud no confidencial.

7. En Recursos, haz clic en Añadir ámbitos.

   Aparecerá el panel Editar recurso a la derecha, en el que puedes seleccionar los recursos a los que debe tener acceso la aplicación.

8. En la lista desplegable Recursos, selecciona la API de UiPath que puede utilizar la aplicación.
   Nota: Solo se puede añadir ámbito para un recurso a la vez. Si quieres permitir el acceso a varios recursos, repite este proceso para añadir el ámbito de cada recurso.
9. En la pestaña Ámbito(s) de usuario, selecciona las casillas de los permisos lógicos de la API que quieres otorgar, según sea necesario.

   Conceder permisos bajo el ámbito de usuario significa que la aplicación externa puede acceder a esos recursos dentro de un contexto de usuario y un usuario con los permisos adecuados debe estar conectado.

10. Si se trata de una aplicación confidencial, puedes cambiar a la pestaña Ámbito(s) de aplicación para conceder también permisos a nivel de aplicación para el recurso seleccionado, según sea necesario.

    Con los permisos bajo el ámbito de la aplicación, la aplicación externa tiene acceso a los datos de toda la aplicación para los ámbitos seleccionados sin necesidad de la interacción del usuario.

    Las aplicaciones no confidenciales no pueden acceder al ámbito de la aplicación.

11. Haz clic en Guardar.

    Se cierra el panel y el recurso y los ámbitos seleccionados se añadirán a la tabla Recursos del formulario.

12. Si la aplicación externa puede aceptarla, puedes añadir una URL en el campo Redirigir la URL y la respuesta de autorización se envía allí. La aplicación puede usarlo para acceder a los recursos de UiPath.
13. Haz clic en Añadir para crear el registro.

    Aparece un mensaje de confirmación. En el caso de las aplicaciones confidenciales, el mensaje de confirmación incluye el secreto de la aplicación que la aplicación externa registrada puede utilizar para solicitar autorización. Asegúrate de guardarlo en un lugar seguro porque no podrás volver a verlo.