- About the Robot JavaScript SDK
- Configuration Steps
- Restarting Robot Components
- Windows Sessions
- Login Using Thales Luna Credential System
- Login Using NShield Key Storage Provider
- Redirecting Robots Through a Proxy Server
- Executing Tasks in a Minimized RDP Window
- Using Mapped Network Drives
- Stopping a Process
- Disable Stop Button
- Custom Package Folders and Network Paths
- CrowdStrike Integration
- Robot Citrix Apps Virtualization
- Common Connection Errors
- Unresponsive Robot Over RDP
- Duplicate Execution Logs
- Frequently Encountered Robot Errors
- Increased Process Execution Duration
- Enforced Package Signature Verification
- Message Too Large to Process
- Errors When Running as Administrator
- NuGet Packages Not Accessible After Migration
- User Access Control Prompt and UI Automation Activities
- .NET required during installation
- Assembly Cannot Be Loaded From Network Or Azure File Share
- Activities cannot find .NET Runtime
Configuration Steps
Prerequisites
In order for your automation projects to benefit from the Robot JavaScript SDK, the following prerequisites need to be met:
- Studio and Robot version 2019.10 or greater installed
- The UiPath JavaScript Add-On installed on the Robot machine
-
The Robot JavaScript SDK
Important:The Robot JavaScript SDK is provided out-of-the box for Studio v2020.4 and greater. For Studio v2019.10 LTS a stand-alone Add-On installer is also available.
If you upgrade from v2019.10 to v2020.2 and later, you need to manually uninstall the UiPath Robot JS Add-on before running the Studio and Robot installer.
Allowing access
When the UiPath Robot JavaScript Add-On is run, you need to provide access to your custom application or web page to connect to the Robot.
The access is handled by a two-step dialog. Both steps have to be confirmed in order to run RobotJS. They can be automated as described below.
Browser access dialog
This step refers to the browser requesting permissions to open the UiPath Assistant.
Automatically accepting the Browser access dialog
It can be automated by adding the uipath-web://*
value as a trusted (allowed) url in the browser's settings. The uipath-web://*
refers to the UiPath Robot web protocol handler.
Robot consent dialog
The robot consent dialog is used to allow the connection between the Robot JavaScript SDK and the Robot Executor.
Automatically accepting the robot consent dialog
This can be automatically allowed by adding the UIPATH_ROBOTJS_ALLOWLIST
System Environment Variable.
The values used in the variable need to be the URLs of your custom application or web page,
separated by semicolon. The URL should contain the port number only if a standard
port is not used (80
or 443
).
The Robot JavaScript SDK
This SDK provides all the necessary methods and properties you can include in your custom application or web page. You can download it as follows:
NPM
The npm package is available with TypeScript bindings. To include it in your project, you need to execute the following command at the root of your project directory:
npm install --save @uipath/robot
npm install --save @uipath/robot
CDN
For CDN, you need to include the SDK before closing the </body>
tag.
<body>
...
...
<script href="//download.uipath.com/js/1.3.1/UiPathRobot.js"></script>
</body>
<body>
...
...
<script href="//download.uipath.com/js/1.3.1/UiPathRobot.js"></script>
</body>
Direct download
You can also grab the Robot JavaScript SDK via direct download.
Add-on settings
In order to change add-on settings, you need to add the ListenerPort
and TokenExpiryInDays
parameters in the uipath.config
file from the installation folder. By default, the section does not contain any keys.
The configuration file needs to contain the following:
<robotJsSettings>
<add key="ListenerPort" value="2323" />
<add key="TokenExpiryInDays" value="30" />
</robotJsSettings>
<robotJsSettings>
<add key="ListenerPort" value="2323" />
<add key="TokenExpiryInDays" value="30" />
</robotJsSettings>
Attribute |
Description |
---|---|
|
The |
|
Any request coming from a new domain needs to have consent from the user to allow access of UiPath Robots from a web application. These consents are valid for the said number of days mentioned in this setting. |