Robô - Etapas de configuração

Pré-requisitos

Para que seus projetos de automação se beneficiem do SDK de JavaScript do Robô, os seguintes pré-requisitos precisam ser atendidos:

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 Add-On do JavaScript do UiPath Robot for executado, você precisará fornecer acesso a seu aplicativo personalizado ou página da web para se conectar ao Robot.

O acesso é gerenciado por uma caixa de diálogo em duas etapas. Ambas as etapas têm que ser confirmadas para executar o RobotJS. Elas podem ser automatizadas conforme descrito abaixo.

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

Pode ser automatizado adicionando o valor uipath-web://* como um URL confiável (permitido) nas configurações do navegador. O uipath-web://* se refere ao gerenciador de protocolos da web do UiPath Robot.

Note: Based on the browser used, different settings need to be configured. For example, if you are using Google Chrome, follow the steps described in the Google Chrome URLAllowlist documentation.

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

Isso pode ser permitido automaticamente adicionando a variável de ambiente do sistema UIPATH_ROBOTJS_ALLOWLIST.

Os valores usados na variável precisam ser 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í-lo em seu projeto, você precisará executar o seguinte comando na raiz do seu diretório de projeto:

npm install --save @uipath/robotnpm install --save @uipath/robot

CDN

Para a CDN, você precisa incluir o SDK antes de fechar a </body> tag.

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

Download Direto

Você também pode obter o SDK de JavaScript do Robô via download direto.

Configurações de Add-on

Para alterar as configurações de add-On, você precisa adicionar os parâmetros ListenerPort e TokenExpiryInDays no arquivo uipath.config a partir da pasta da instalação. Por padrão, a seção não contém nenhuma chave.

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.

Guia do usuário do robô

Etapas de configuração