- Primeros pasos
- Instalación y actualización
- Tipos de robot
- Componentes de robot
- Servicio de robots
- Ejecutor de robot
- Interfaz de línea de comandos
- Licencia
- Conexión de los robots a Orchestrator
- Procesos y actividades
- Registro
- Situaciones concretas
- Reinicio de componentes de UiPath Robot
- Sesiones de Windows
- Inicio de sesión usando el sistema de credenciales de Thales Luna
- Inicio de sesión utilizando el proveedor de almacenamiento de clave nShield
- Redirección de Robots a través de un servidor proxy
- Ejecución de tareas en una ventana RDP minimizada
- Uso de unidades de red asignadas
- Detención de un proceso
- Botón de deshabilitación de detención
- Carpetas de paquetes y rutas de red personalizadas
- Integración de CrowdStrike
- Robot de virtualización de apps citrix
- Control
- Solución de problemas
- Errores comunes de conexión
- Robot que no responde sobre RDP
- Registros de ejecución duplicados
- Errores de robot encontrados con frecuencia
- Aumento de la duración de la ejecución de proceso
- Exigencia de la verificación de la firma de paquetes
- Mensaje demasiado grande para procesarlo
- Errores al ejecutarse como administrador
- Los paquetes NuGet no son accesibles tras la migración
- Actividades de diálogo de control de acceso de usuario y automatización de IU
- Se requiere .NET durante la instalación
- El ensamblado no se puede cargar desde la red o compartir archivos de Azure
- Las actividades no pueden encontrar .NET Runtime
- Resolución de problemas de integración de CrowdStrike
Guía del usuario de UiPath Robot
La interfaz de línea de comandos del robot (UiRobot.exe) es una aplicación de consola que puede solicitar el inicio de trabajos y esperar a su salida. Es un cliente directo del mantenimiento de robot de UiPath, y la comunicación se realiza mediante un canal WCF.
Para hacer uso de los argumentos de la línea de comandos compatibles con los robots, asegúrate de que el servicio UiPath® Robot se esté ejecutando. De lo contrario, inícialo desde el complemento de Consola de administración de servicios de Microsoft.
cd C:\Program Files\UiPath\Studio.
Todos los ejemplos que se muestran en el capítulo se construyen a partir de la suposición de que has realizado esta acción.
Ejecutar
Utiliza este comando para iniciar la ejecución de un archivo de proyecto de los siguientes tipos:-
JSON
-
XAML
-
NUPKG
A partir de la versión 2023.4 de Robot, UiPath actualiza la lista de procesos al mismo tiempo que se ejecuta un proceso. Si hay una actualización de proceso disponible al inicio del trabajo, el trabajo utiliza la versión anterior del proceso. Las ejecuciones posteriores aplican el proceso actualizado.
El comando de ejecución utiliza los siguientes argumentos:
UiRobot.exe execute [--process <Package_ID> | --file <File_Path>] [--folder <Orchestrator_Folder_ID>] [--input <Input_Parameters>]UiRobot.exe execute [--process <Package_ID> | --file <File_Path>] [--folder <Orchestrator_Folder_ID>] [--input <Input_Parameters>]-
-p--process <Package_ID>(obligatorio): inicia la ejecución de un proceso local o de Orchestrator.Ejemplos:
UiRobot.exe execute --process UiPathDemoProcessUiRobot.exe execute --process UiPathDemoProcessUiRobot.exe execute -p UiPathDemoProcessUiRobot.exe execute -p UiPathDemoProcess -
-f--file <File_Path>(obligatorio): inicia la ejecución de un archivo de proyecto local. El archivo de destino puede ser JSON, XAML o NUPKG.Ejemplos:
UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"UiRobot.exe execute --file "C:\UiPath\Automation\Project.json" -
--folder <Orchestrator_Folder_ID>(opcional): te permite especificar la carpeta de Orchestrator desde la que instalar y ejecutar el proceso de destino. Solo se puede utilizar junto con el argumento--process.Ejemplo:
UiRobot.exe -Execute --process UiPathDemoProcess --folder OrchFolder1UiRobot.exe -Execute --process UiPathDemoProcess --folder OrchFolder1 -
--input <Input_Parameters>(opcional): te permite especificar argumentos de entrada para la ejecución. Se puede utilizar con los argumentos--processo--file.Ejemplos:
UiRobot.exe execute --process UiPathDemoProcess --input "{'inArg' : 'value' , 'Integer' : 3}"UiRobot.exe execute --process UiPathDemoProcess --input "{'inArg' : 'value' , 'Integer' : 3}"UiRobot.exe execute --process UiPathDemoProcess --folder OrchFolder1 --input "{'inArg' : 'value' , 'Integer' : 3}"UiRobot.exe execute --process UiPathDemoProcess --folder OrchFolder1 --input "{'inArg' : 'value' , 'Integer' : 3}"UiRobot.exe execute --file "C:\UiPath\Automation\Main.xaml" --input "{'inArg' : 'value' , 'Integer' : 3}"UiRobot.exe execute --file "C:\UiPath\Automation\Main.xaml" --input "{'inArg' : 'value' , 'Integer' : 3}" -
--entry <entrypoint>(opcional): te permite seleccionar el punto de entrada de un proceso al iniciarlo a través de la línea de comandos.Ejemplo:
UiRobot execute --file "C:\UiPath\Project\project.1.0.3.nupkg" --input "{'inArg':'value','integer':3}" --entry "OtherEntryPoint.xaml"UiRobot execute --file "C:\UiPath\Project\project.1.0.3.nupkg" --input "{'inArg':'value','integer':3}" --entry "OtherEntryPoint.xaml"
-
Los siguientes comandos no son compatibles con proyectos de Windows o multiplataforma:
UiRobot.exe execute --file "C:\UiPath\Automation\Main.xaml"UiRobot.exe execute --file "C:\UiPath\Automation\Main.xaml"UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"UiRobot.exe execute --file "C:\UiPath\Automation\Project.json"
- No se pueden utilizar los argumentos
--process (-p)y--file (-f)simultáneamente en el comando de ejecución.
Proceso de instalación
Utiliza este comando para instalar un proceso. Si el robot está conectado a Orchestrator, busca el proceso en la fuente de Orchestrator. Sin una conexión de Orchestrator, el robot utiliza la fuente local.
El comando del proceso de instalación utiliza los siguientes argumentos:
UiRobot.exe installprocess [--process-name <process_name>] [--folder <orchestrator_folder>]UiRobot.exe installprocess [--process-name <process_name>] [--folder <orchestrator_folder>]-
--process-name <process_name>(obligatorio): el nombre del proceso que deseas instalar.Ejemplo:
UiRobot installprocess --process-name MyProcessUiRobot installprocess --process-name MyProcess -
--folder <orchestrator_folder>(opcional): el nombre de la carpeta de Orchestrator que contiene el proceso que deseas instalar. Este argumento se aplica solo cuando la conexión a Orchestrator está activa. Si solo una carpeta contiene el proceso de instalación, omite este parámetro.Ejemplo:
UiRobot installprocess -p MyProcess --folder MyOrchestratorFolderUiRobot installprocess -p MyProcess --folder MyOrchestratorFolder
Conectar
Utiliza este comando para conectar tu robot a una instancia de Orchestrator. Si tu robot ya está conectado a Orchestrator y ejecutas este comando, se devuelve el mensaje "Orchestrator ya está conectado".
El comando de conexión utiliza los siguientes argumentos:
UiRobot.exe connect [--url <Orchestrator_Server_URL> --key <Machine_Key>] | [--connectionString <Connection_String>]UiRobot.exe connect [--url <Orchestrator_Server_URL> --key <Machine_Key>] | [--connectionString <Connection_String>]-
connect: establece la conexión a Orchestrator. Debe utilizarse juntos los argumentos--url,--keyo--clientID --clientSecret. Si no especificas estos argumentos, el comando utiliza la configuración de Configuración de Orchestrator.Ejemplos:
// no arguments UiRobot.exe connect// no arguments UiRobot.exe connect//using the machine key UiRobot.exe connect --url https://demo.uipath.com/ --key 1122AAB3C-DD44-ABCD-1234-7788GG99HH00//using the machine key UiRobot.exe connect --url https://demo.uipath.com/ --key 1122AAB3C-DD44-ABCD-1234-7788GG99HH00//using the client ID and secret UiRobot.exe connect --url https://demo.uipath.com/ --clientID 696CCA0C-1234-ABCD-1234-F65BBC2F15DE --clientSecret QJX!jv12345A4q4N//using the client ID and secret UiRobot.exe connect --url https://demo.uipath.com/ --clientID 696CCA0C-1234-ABCD-1234-F65BBC2F15DE --clientSecret QJX!jv12345A4q4N
Desconectar
Utiliza este comando para desconectar el Robot de la instancia actual de Orchestrator.
El comando desconectar utiliza los siguientes argumentos:
UiRobot.exe disconnect --force | --waitUiRobot.exe disconnect --force | --wait-
disconnect: desconecta el Robot de Orchestrator solo cuando no hay trabajos en ejecución en la máquina del robot.Ejemplo:
UiRobot.exe disconnectUiRobot.exe disconnect -
--force: elimina todos los trabajos en ejecución en la máquina y luego desconecta el robot de Orchestrator.Ejemplo:
UiRobot.exe disconnect --forceUiRobot.exe disconnect --force -
--wait: espera a que se completen los trabajos en ejecución antes de desconectar el robot de Orchestrator.Ejemplo:
UiRobot.exe disconnect --waitUiRobot.exe disconnect --wait
Trace
Utiliza este comando para habilitar o deshabilitar el seguimiento de bajo nivel para el robot.
El comando de seguimiento utiliza los siguientes argumentos:
UiRobot.exe trace --enableLowLevel | --disableLowLevelUiRobot.exe trace --enableLowLevel | --disableLowLevel-
--enableLowLevel: habilita el seguimiento detallado para el ejecutor de robot y el servicio en el visor de eventos. Genera un archivo ETL que puedes abrir con el Visor de eventos para ayudar a resolver problemas de bloqueos y errores.Ejemplo:
UiRobot.exe trace --enableLowLevelUiRobot.exe trace --enableLowLevel -
--disableLowLevel: deshabilita el seguimiento detallado para el ejecutor y el mantenimiento de robot de UiPath. Genera un archivo ETL que puedes abrir con el Visor de eventos para ayudar a resolver problemas de bloqueos y errores.Ejemplo:
UiRobot.exe trace --disableLowLevelUiRobot.exe trace --disableLowLevel
PiP
Utiliza este comando para habilitar o deshabilitar la sesión del robot o la capacidad Picture in Picture en la máquina. Este ajuste modifica las instalaciones existentes y se aplica a todos los usuarios en la máquina local. Requiere privilegios de administrador.
El comando PiP utiliza los siguientes argumentos:
UiRobot.exe pip --enable | --disableUiRobot.exe pip --enable | --disable-
--enable: habilita la sesión del robot (funcionalidad PiP) de la máquina.Ejemplo:
UiRobot.exe pip --enableUiRobot.exe pip --enable -
--disable: deshabilita la sesión del robot (funcionalidad PiP) de la máquina.Ejemplo:
UiRobot.exe pip --disableUiRobot.exe pip --disable
Otros argumentos
Los siguientes argumentos son puramente informativos y no tienen impacto en tus proyectos de automatización:
-
--version: muestra información sobre la versión del Robot. -
--help: muestra la lista de comandos compatibles, así como la información y ejemplos correspondientes. -
flushlogs [--timeout <timeout_in_seconds>]: envía todos los registros pendientes a Orchestrator.
