Archivos de configuración

Una vez que edites los archivos de configuración, debes reiniciar los componentes relevantes del robot para que los cambios surtan efecto. La siguiente lista resume cómo reiniciar varios componentes, en función del modo de instalación del robot.

Recuerda guardar cualquier trabajo en curso antes de reiniciar para evitar perder progreso no guardado.

• Servicio de robots
  • Instalación en modo servicio
    1. Abre Gestor de tareas > Servicios.
    2. Busca el servicio UiPathRobotSvc.
    3. Haz clic con el botón derecho en el servicio y selecciona Reiniciar.
  • Instalación en modo de usuario: sal y reinicia UiPath Assistant, o:
    1. Abre el Gestor de tareas > Detalles.
    2. Selecciona el proceso UiPath.Service.UserHost.exe.
    3. Selecciona Finalizar tarea.
• Servicio de actualización
  1. Abre Gestor de tareas > Servicios.
  2. Busca el servicio UiPath.UpdateService.Agent.
  3. Haz clic con el botón derecho en el servicio y selecciona Reiniciar.
• UiPath RobotJS ServiceHost
  1. Abre Gestor de tareas > Servicios.
  2. Busca el servicio UiPath.RobotJS.ServiceHost.
  3. Haz clic con el botón derecho en el servicio y selecciona Reiniciar.
• Asistente de UiPath
  1. En el UiPath Assistant, selecciona Preferencias y luego Salir.
  2. Reinicia el UiPath Assistant.
• Widgets : reinicia UiPath Assistant, o:
  1. Haz clic con el botón derecho en el icono de UiPath Assistant en la barra de tareas.
  2. Selecciona Volver a cargar widgets

uipath.config

El archivo UiPath.config contiene parámetros de configuración esenciales para el robot. Como administrador, puedes personalizar el comportamiento de tus robots editando la lista de parámetros en el archivo de configuración.

Nota:

Cada entorno puede necesitar avisos específicos, por lo que UiPath te permite aplicar diferentes configuraciones en función del entorno actual del robot, ya sea Desarrollo, Preparación o Producción. Siempre ten cuidado al editar este archivo, ya que una configuración inexacta puede causar problemas de aplicación.

Acceder al archivo

Al instalar el robot, el sistema crea el archivo UiPath.config.

Para acceder a él, navega a C:\Program Files\UiPath\Studio\UiPath.config.

Configuración personalizable

El archivo UiPath.config consta de los siguientes parámetros:

• En la sección de configuración connectionSettings
  • DefaultServiceUrl (string): establece la dirección predeterminada que utiliza el robot para conectarse a Orchestrator. Ejemplo:

    string DefaultServiceUrl = "https://cloud.uipath.com"

  • AutoSignIn (bool): habilita la función de inicio de sesión automático para UiPath Assistant. El valor predeterminado es false. Ejemplo:

    bool AutoSignIn = true.

  • EnforceDefaultServiceUrl (bool): aplica la dirección proporcionada como DefaultServiceUrl a todos los usuarios. El valor predeterminado es false. Ejemplo:

    bool EnforceDefaultServiceUrl = true.

• En la sección de configuración communicationSettings
  • MaxMessageSizeInMegabytes (byte): establece el tamaño máximo de un mensaje que el sistema puede enviar o recibir, en MB. El valor predeterminado es 10.

    Esto se utiliza para evitar sobrecargas o bloqueos de proceso debido al manejo de mensajes demasiado grandes. Exemplo:

    byte MaxMessageSizeInMegabytes = 10;

  • InstallPackageTimeout (TimeSpan): establece el límite de tiempo para las instalaciones de paquetes. El valor predeterminado es 20 minutos.

    Si la instalación de un paquete tarda más del tiempo definido, el sistema aborta la instalación. Ejemplo:

    TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);

  • RequestTimeout (TimeSpan): define cuánto tiempo espera el sistema una respuesta de comunicación. El valor predeterminado es 40 segundos.

    Si el sistema no recibe una respuesta en el período establecido, se detiene y continúa. Esto evita los bloqueos del sistema. Exemplo:

    TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);

• En la sección de configuración packageSettings
  • PackagesInstallationFolder (cadena): establece el directorio predeterminado donde se instalan los paquetes. El valor predeterminado es C:\UiPath\Packages.
  • SkipHttpConfigurationSources (bool): permite que el sistema ignore las fuentes de paquetes configuradas a través de HTTP, como las fuentes NuGet. El valor predeterminado es false.

    Esto significa que el sistema no recupera paquetes de estas fuentes, lo que es útil cuando las fuentes no son fiables o seguras.

  • DisableSecureXaml (bool): permite que el UiPath Robot ejecute flujos de trabajo potencialmente no seguros. El valor predeterminado es false.
  • DirectDownload (bool): permite la descarga directa de paquetes, sin preguntar al usuario. El valor predeterminado es false.
  • PackageSaveWithoutNupkg (bool): permite guardar los paquetes sin el archivo .nupkg . El valor predeterminado es false.

    Esto es útil para reducir el tamaño de descarga.

• En la sección de configuración analyticsSettings
  • Telemetry.Enabled (bool): permite que UiPath recopile y envíe datos de uso para su análisis. El valor predeterminado es false.
• En la sección de configuración robotCacheSettings
  • SessionCacheDuration (TimeSpan): define cuánto tiempo deben conservarse los datos de una sesión específica en la caché antes de descartarse. El valor predeterminado es 30 segundos.

    Esto es útil para reutilizar datos como valores de variables o detalles de operaciones, en lugar de recrearlos o volver a recuperarlos. Exemplo:

    TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);

  • GetResourceUrlCacheDuration (TimeSpan): define cuánto tiempo se almacenan en la caché las URL de los recursos, como las API o las páginas web. El valor predeterminado es una (1) hora.

    Esto es útil para optimizar el rendimiento en escenarios en los que sus robots necesitan acceder a ciertos recursos regularmente. Exemplo:

    TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);

• En la sección de configuración robotJsSettings
  • ListenerPort (int): establece el número de puerto en el que Robot.js escucha las conexiones entrantes. El valor predeterminado es 2323.

    Esto permite al mantenimiento de robot de UiPath interactuar con aplicaciones web que se ejecutan en servidores locales o remotos. Exemplo:

    int ListenerPort = 2323;

  • TokenExpiryInDays (int): establece el período de validez, en días, de los tokens de autenticación generados por el mantenimiento de robot de UiPath. El valor predeterminado es 30 días.

    El mantenimiento de robot de UiPath utiliza estos tokens para autenticarse al interactuar con otros componentes o servicios de software. Exemplo:

    int TokenExpiryInDays = 30;

  • AllowUrlList (string): establece la lista de URL a las que puede acceder el mantenimiento de robot de UiPath. Esto ayuda a garantizar que tu mantenimiento de robot de UiPath solo interactúe con los servicios aprobados. Ejemplo:

    string AllowUrlList = "https://cloud.uipath.com";

Importante:

• Crea siempre una copia de seguridad del archivo original UiPath.config antes de realizar cualquier cambio. Esto puede ayudar a restaurar la configuración original si algo sale mal.
• Para aplicar las actualizaciones realizadas al archivo UiPath.config, reinicia el servicio de UiPath o el sistema.
• La configuración local en el archivo UiPath.config tiene prioridad sobre la configuración establecida en Orchestrator.
• Los datos confidenciales en el archivo UiPath.config pueden cifrarse para obtener seguridad adicional.

Variables del sistema de UiPath Robot

Se puede configurar otro comportamiento personalizado a través de variables de entorno del sistema.

Importante:

Después de modificar cualquiera de las variables del sistema, reinicia el mantenimiento de robot de UiPath.

La siguiente lista resume los casos de uso más comunes:

• UIPATH_SESSION_TIMEOUT : cambia el tiempo de espera predeterminado de 60 segundos para crear una sesión interactiva. Ajusta este valor para adaptar el comportamiento del robot en función del rendimiento y los tiempos de carga del sistema con el que interactúa.

  Ejemplo:

  UIPATH_SESSION_TIMEOUT=75

• UIPATH_PIP_SESSION_TIMEOUT : cambia el tiempo de espera predeterminado de 180 segundos para iniciar un proceso en una sesión de robot.

  Ejemplo:

  UIPATH_PIP_SESSION_TIMEOUT=60

• UIPATH_LANGUAGE : establece el idioma en el que opera el robot. El orden de precedencia es:
  1. UIPATH_LANGUAGE Valor
  2. Variable de entorno de la máquina
  3. Cultura de IU del hilo actual
  4. Idioma predeterminado de UiPath (inglés)

  Ejemplo:

  UIPATH_LANGUAGE=French

• UIPATH_HEADLESS_WITH_USER : utiliza las credenciales de un usuario específico, que se configuró previamente en Orchestrator.

  Ejemplo:

  UIPATH_HEADLESS_WITH_USER=True

• UIPATH_PRE_LOADED_EXECUTOR : de forma predeterminada, se lanza un ejecutor precargado cuando se inicia el robot. Para cambiar este comportamiento e iniciar el ejecutor precargado solo cuando se ejecuta el primer proceso, establece esta variable en None.

  Ejemplo:

  UIPATH_PRE_LOADED_EXECUTOR=None

• UIPATH_DISABLE_PRE_LOADED_EXECUTOR : deshabilita la característica del ejecutor precargado.

  Ejemplo:

  UIPATH_PRE_LOADED_EXECUTOR=None

• UIPATH_ROBOTJS_ALLOWLIST : acepta automáticamente el cuadro de diálogo de consentimiento del robot, al establecer la conexión entre el SDK de Robot JS y el ejecutor de robot.

  La variable acepta URL de aplicación personalizadas, separadas por punto y coma. Incluye el número de puerto en la URL si difiere de los puertos estándar (80 o 443).

  Ejemplo:

  UIPATH_ROBOTJS_ALLOWLIST=cloud.uipath.com;mydomain.com;

• UIPATH_DNS_MACHINENAME : permite utilizar el nombre de host DNS para Localhost al crear sesiones RDP. Para ejecutar trabajos desatendidos en entornos con autenticación Kerberos para RDP, establece este valor en Verdadero.

  Ejemplo:

  UIPATH_DNS_MACHINENAME=True

• NUGET_FALLBACK_PACKAGES : configura las rutas a las carpetas de paquetes alternativos. Utiliza punto y coma para separar varias rutas.
  En ausencia de esta variable, el Robot busca carpetas de paquetes de reserva en el archivo Nuget.config.
• NUGET_SCRATCH : permite que varios robots de modo de usuario en la misma máquina compartan una ruta local para almacenar paquetes.

  El valor debe ser una ruta diferente a la carpeta de instalación de Nuget, y actúa como carpeta temporal para NuGet.

  Nota: solo la variable NUGET_SCRATCH debe utilizar la carpeta temporal configurada.

  Ejemplo:

  NUGET_SCRATCH=C:\NuGetTempFolder

• UIPATH_PRESERVE_CREDENTIALS_CASE : conserva las mayúsculas y minúsculas originales de las credenciales de registro (dominio\nombre de usuario).

  Ejemplo:

  UIPATH_PRESERVE_CREDENTIALS_CASE = True

• UIPATH_SESSION_BEHAVIOR : configura la forma en que se comporta la restauración de la sesión después de completar un trabajo. Las siguientes opciones están disponibles:
  • TryReuseAndRestoreSession—Opción predeterminada. Intenta reutilizar la sesión y restaurarla a su estado anterior una vez finalizado un trabajo. Si no hay ninguna sesión inicial que reutilizar, se cierra sesión al restaurar.
  • ForceNew—Crea una sesión completamente nueva, independientemente del estado de la sesión anterior. Siempre cierra sesión al restaurar.
  • LeaveSessionActive—Impide la restauración del estado de la sesión inicial.
  • LeaveSessionDisconnected—Desconecta siempre la sesión al restaurar.

  Ejemplo:

  UIPATH_SESSION_BEHAVIOR = LeaveSessionDisconnected

• UIPATH_HTTP_CONNECTION_LIFETIME : define cuánto tiempo permanece abierta la conexión a Orchestrator antes de que se cierre y se actualice. La duración predeterminada es de 30 minutos, pero para ajustar este valor, utiliza el valor en segundos.

  Ejemplo:

  // to set 10 minutes                          
  UIPATH_HTTP_CONNECTION_LIFETIME = 600

• UIPATH_FILE_LOG_LEVEL : define el nivel de registro de ejecución utilizado en el archivo local. Este es diferente al nivel de registro utilizado para Orchestrator. Las siguientes opciones están disponibles:
  • Verbose
  • Trace
  • Information
  • Advertencia
  • Error
  • Critical
  • Off

  Ejemplo:

  // to set verbose level locally
  UIPATH_FILE_LOG_LEVEL = Verbose

• UIPATH_EXECUTOR_STARTUP_DELAY : define el tiempo en segundos que se debe esperar entre la creación de la sesión y el inicio del ejecutor. Esto se utiliza cuando tu infraestructura necesita cargar algunos servicios (VPN, seguridad) antes de que comience la ejecución de tu automatización.

  Ejemplo:

  // to set the delay to 5 seconds
  UIPATH_EXECUTOR_STARTUP_DELAY = 5