Guía para desarrolladores de robots

Última actualización 17 de dic. de 2024

Campos de configuración

La propiedad Configuración del SDK JavaScript del Robot te permite personalizar y mejorar tu control sobre la configuración del complemento del navegador.

class Settings {
  portNumber: number;
  pollTimeInterval: number;
  disableTelemetry: boolean;
  appOrigin: string;
}class Settings {
  portNumber: number;
  pollTimeInterval: number;
  disableTelemetry: boolean;
  appOrigin: string;
}

Atributo	Descripción
`portNumber`	Te permite configurar los puertos personalizados en los que se ejecutan los servicios de back-end. El número de puerto predeterminado es 2323. Ten en cuenta que esto solo está disponible para instalaciones Enterprise.
`pollTimeInterval`	Te permite especificar el tiempo en milisegundos en que el SDK JavaScript del Robot mantiene un seguimiento de la ejecución de un proceso desde una página web. El valor predeterminado es de 250 milisegundos. Este valor determina la frecuencia de sondeo desde el navegador web
`disableTelemetry`	Te permite deshabilitar el marcador de telemetría. El valor predeterminado es `false`.
`appOrigin`	Te permite especificar la aplicación que usa el SDK. El valor predeterminado se recoge desde la clase `window.location.origin`.

const robot = UiPathRobot.init();
robot.settings.portNumber = 1234;
robot.settings.pollTimeInterval = 1000; 
robot.settings.disableTelemetry = true; 
robot.settings.appOrigin = 'MyApp';const robot = UiPathRobot.init();
robot.settings.portNumber = 1234;
robot.settings.pollTimeInterval = 1000; 
robot.settings.disableTelemetry = true; 
robot.settings.appOrigin = 'MyApp';

Ajustes del complemento

Para cambiar la configuración del complemento, es necesario cambiar el archivo uipath.config de la carpeta %ProgramFiles%\UiPath\Studio.

El archivo de configuración debe contener lo siguiente:

<robotJsSettings>
    <add key="ListenerPort" value="2323" />
    <add key="TokenExpiryInDays" value="30" />
</robotJsSettings><robotJsSettings>
    <add key="ListenerPort" value="2323" />
    <add key="TokenExpiryInDays" value="30" />
</robotJsSettings>

Atributo	Descripción
`ListenerPort`	El `UiPath.RobotJS.ServiceHost.exe` inicia un HttpListener en el puerto configurado y contiene la información sobre otros listeners locales de la sesión del usuario activo en ese sistema. Ten en cuenta que aquí el valor del puerto debe coincidir con el que se configura en los Ajustes del SDK.
`TokenExpiryInDays`	Cualquier solicitud que provenga de un nuevo dominio debe tener consentimiento del usuario para permitir el acceso de UiPath Robots desde una aplicación web. Estos consentimientos son válidos para el número de días mencionado en este ajuste.

Superposición predeterminada

Es posible personalizar la pantalla de consentimiento que se muestra cuando se eleva una solicitud desde un nuevo dominio. Actualmente existen dos pantallas que se ofrecen con el SDK de JavaScript del Robot:

Solicitud de consentimiento

Se muestra la superposición consent-prompt cuando se eleva una solicitud para acceder al UiPath Assistant desde un nuevo dominio.

Faltan componentes

Se muestra la superposición missing-components cuando el complemento necesario no está presente en la máquina local.

Los mensajes de superposición se pueden configurar como se muestra en los siguientes ejemplos.

// Consent code will be written to the console instead of showing default overlay
// Error logged to console when required components are missing insread of showing
// default error overlay
const robot = UiPathRobot.init();
robot.on('consent-prompt', function(consentCode){ console.log(consentCode) });
robot.on('missing-components', function(){ console.log('Missing components') });// Consent code will be written to the console instead of showing default overlay
// Error logged to console when required components are missing insread of showing
// default error overlay
const robot = UiPathRobot.init();
robot.on('consent-prompt', function(consentCode){ console.log(consentCode) });
robot.on('missing-components', function(){ console.log('Missing components') });

Ajustes de SDK

La propiedad Configuración del SDK JavaScript del Robot te permite personalizar y mejorar tu control sobre la configuración del complemento del navegador.

class Settings {
  portNumber: number;
  pollTimeInterval: number;
  disableTelemetry: boolean;
  appOrigin: string;
}class Settings {
  portNumber: number;
  pollTimeInterval: number;
  disableTelemetry: boolean;
  appOrigin: string;
}

Atributo	Descripción
`portNumber`	Te permite configurar los puertos personalizados en los que se ejecutan los servicios de back-end. El número de puerto predeterminado es 2323. Ten en cuenta que esto solo está disponible para instalaciones Enterprise.
`pollTimeInterval`	Te permite especificar el tiempo en milisegundos en que el SDK JavaScript del Robot mantiene un seguimiento de la ejecución de un proceso desde una página web. El valor predeterminado es de 250 milisegundos. Este valor determina la frecuencia de sondeo desde el navegador web
`disableTelemetry`	Te permite deshabilitar el marcador de telemetría. El valor predeterminado es `false`.
`appOrigin`	Te permite especificar la aplicación que usa el SDK. El valor predeterminado se recoge desde la clase `window.location.origin`.

const robot = UiPathRobot.init();
robot.settings.portNumber = 1234;
robot.settings.pollTimeInterval = 1000; 
robot.settings.disableTelemetry = true; 
robot.settings.appOrigin = 'MyApp';const robot = UiPathRobot.init();
robot.settings.portNumber = 1234;
robot.settings.pollTimeInterval = 1000; 
robot.settings.disableTelemetry = true; 
robot.settings.appOrigin = 'MyApp';