Etapas de configuração

Pré-requisitos e etapas de configuração para o SDK JavaScript do Robô: instalação do complemento JavaScript e configuração de acesso ao aplicativo.

Esta página abrange os pré-requisitos e a configuração para usar o SDK JavaScript do Robô em aplicativos da web personalizados, incluindo a configuração do navegador e do acesso ao consentimento do Robô, instalando o SDK e configurando o complemento JavaScript.

Pré-requisitos

Os seguintes pré-requisitos devem ser atendidos para projetos de automação para usar o SDK JavaScript do Robô:

• Studio e Robot versão 2021.10 ou posterior instalada
• O Add-on UiPath JavaScript instalado na máquina do Robô

Permitindo o acesso

Quando o complemento JavaScript do UiPath Robô é executado, o acesso deve ser concedido para que seu aplicativo personalizado ou página da web se conecte ao Robô. O acesso é tratado por uma caixa de diálogo em duas etapas — ambas as etapas devem ser confirmadas para executar o RobotJS. Ambas as caixas de diálogo são compatíveis com a automação conforme descrito nas seções a seguir.

Caixa de diálogo Acesso do navegador

Essa etapa se refere ao navegador que solicita permissões para abrir o UiPath Assistant.

Caixa de diálogo aceitando automaticamente o acesso do navegador

O uipath-web://* valor, adicionado como um URL confiável nas configurações do navegador, automatiza essa caixa de diálogo. O uipath-web://* se refere ao gerenciador de protocolos da web do UiPath Robot.

Observação:

Com base no navegador usado, é preciso definir diferentes configurações. Por exemplo, se você estiver usando o Google Chrome, siga as etapas descritas na documentação URLAllowList do Google Chrome.

Caixa de diálogo Consentimento do robô

A caixa de diálogo Consentimento do Robot é usada para permitir a conexão entre o Robot JavaScript SDK e o Executor do Robô.

Caixa de diálogo Aceitando automaticamente o consentimento do Robot

A Variável de ambiente do sistema UIPATH_ROBOTJS_ALLOWLIST aceita automaticamente o diálogo de consentimento do robô.

O valor da variável deve conter os URLs de seu aplicativo ou página da web personalizado, separados por ponto e vírgula. O URL deve conter o número da Porta apenas se uma porta padrão não for usada (80 ou 443).

O SDK de JavaScript do Robô

Esse SDK fornece todos os métodos e propriedades necessários, que você poderá incluir em seu aplicativo personalizado ou página da web. Faça o download da seguinte maneira:

NPM

O pacote npm está disponível junto com as associações de TypeScript. Para incluí-la no seu projeto:

1. Execute o seguinte comando na raiz do diretório do seu projeto:

   npm install --save @uipath/robot
   

CDN

Para CDN:

1. Adicione a seguinte tag de script antes da </body> tag de fechamento:

   <body>
   ...
   ...
   <script href="//download.uipath.com/js/1.3.2/UiPathRobot.js"></script>
   </body>
   

Download direto

Baixe o Robô JavaScript SDK via download direto.

Configurações de Add-on

Para definir configurações de complemento:

1. Abra o arquivo uipath.config na pasta de instalação.
2. Adicione os parâmetros ListenerPort e TokenExpiryInDays à seção <robotJsSettings>. Por padrão, a seção não contém nenhuma chave:

<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. O valor da porta deve corresponder ao que foi configurado nas Configurações do 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.