Guia do desenvolvedor do UiPath Robot

Última atualização 18 de dez de 2024

Campos de configurações

A propriedade Configurações do SDK de JavaScript do Robô permite que você personalize e melhore seu controle sobre a configuração do add-on do navegador.

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

Atributo	Description
`portNumber`	Permite que você configure portas personalizadas, nas quais os serviços de back-end são executados. O número da porta padrão é 2323. Observe que isso está disponível apenas para instalações do Enterprise.
`pollTimeInterval`	Permite que você especifique o tempo em milissegundos em que o SDK de JavaScript do Robô rastreia a execução de um processo a partir de uma página web. O valor padrão é 250 milissegundos. Esse valor determina a frequência de pesquisa do navegador web
`disableTelemetry`	Permite que você desabilite a flag de telemetria. O valor padrão é `false`.
`appOrigin`	Permite que você especifique o aplicativo que usa o SDK. O valor padrão é escolhido a partir da `window.location.origin` classe.

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';

Configurações de Add-on

Para alterar as configurações do add-on é necessário alterar o arquivo uipath.config da pasta %ProgramFiles%\UiPath\Studio.

O arquivo de configuração precisa conter o seguinte:

<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	Description
`ListenerPort`	O `UiPath.RobotJS.ServiceHost.exe` inicia um HttpListener na porta configurada e contém as informações sobre outros ouvintes locais da sessão do usuário ativa nesse sistema. Observe que o valor de porta aqui precisa corresponder àquele configurado nas Configurações de SDK.
`TokenExpiryInDays`	Qualquer solicitação proveniente de um novo domínio precisa ter consentimento do usuário para permitir o acesso do UiPath Robots a partir de um aplicativo web. Esses consentimentos são válidos para o referido número de dias mencionados nesta configuração.

Sobreposição Padrão

É possível personalizar a tela de consentimento exibida quando uma solicitação é apresentada por um novo domínio. Há atualmente duas telas que são fornecidas junto ao SDK de JavaScript do Robô:

Prompt de Consentimento

A sobreposição consent-prompt é exibida quando uma solicitação de acesso ao UiPath Assistant é criada por um novo domínio.

Componentes Ausentes

A sobreposição missing-components é exibida quando o add-on exigido não está presente na máquina local.

As mensagens de sobreposição podem ser configuradas como exemplificadas abaixo.

// 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') });

Configurações do SDK

A propriedade Configurações do SDK de JavaScript do Robô permite que você personalize e melhore seu controle sobre a configuração do add-on do navegador.

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

Atributo	Description
`portNumber`	Permite que você configure portas personalizadas, nas quais os serviços de back-end são executados. O número da porta padrão é 2323. Observe que isso está disponível apenas para instalações do Enterprise.
`pollTimeInterval`	Permite que você especifique o tempo em milissegundos em que o SDK de JavaScript do Robô rastreia a execução de um processo a partir de uma página web. O valor padrão é 250 milissegundos. Esse valor determina a frequência de pesquisa do navegador web
`disableTelemetry`	Permite que você desabilite a flag de telemetria. O valor padrão é `false`.
`appOrigin`	Permite que você especifique o aplicativo que usa o SDK. O valor padrão é escolhido a partir da `window.location.origin` classe.

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';