- Robot JavaScript SDK
- Sobre o SDK de JavaScript do Robô
- Etapas de configuração
Pré-requisitos e configuração para usar o Robot JavaScript SDK, incluindo a instalação do UiPath JavaScript Add-On e as configurações de acesso ao navegador.
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 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 é 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 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
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.
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, execute o seguinte comando na raiz do diretório do seu projeto:
npm install --save @uipath/robot
npm install --save @uipath/robot
CDN
Para CDN, inclua o SDK antes da </body> tag de fechamento:
<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 complemento, adicione os parâmetros ListenerPort e TokenExpiryInDays ao arquivo uipath.config na pasta de instalação. Por padrão, a seção não contém nenhuma chave.
O arquivo de configuração deve 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. 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. |
- Pré-requisitos
- Permitindo o acesso
- Caixa de diálogo Acesso do navegador
- Caixa de diálogo aceitando automaticamente o acesso do navegador
- Caixa de diálogo Consentimento do robô
- Caixa de diálogo Aceitando automaticamente o consentimento do Robot
- O SDK de JavaScript do Robô
- NPM
- CDN
- Download Direto
- Configurações de Add-on