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 2019.10 ou posterior instalada
O Add-on UiPath JavaScript instalado na máquina do Robô
O SDK de JavaScript do Robô

Importante:
O Robot JavaScript SDK é fornecido pronto para usar para o Studio v2020.4 e superior. Para o Studio v2019.10 LTS, um instalador de Add-On independente também está disponível.

Se você for atualizar da v2019.10 para v2020.2 e posterior, você precisa desinstalar manualmente o Add-on do UiPath Robot JS, antes de executar o instalador do Studio e 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.

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

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 personalizado ou página da web, separados por 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.2.9/UiPathRobot.js"></script>
</body><body>
...
...
<script href="//download.uipath.com/js/1.2.9/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.