Étapes de configuration

Prérequis

Pour que vos projets d’automatisation bénéficient du Robot JavaScript SDK, les conditions préalables suivantes doivent être remplies :

Version Studio et Robot 2019.10 ou ultérieure installée
Module complémentaire JavaScript UiPath installé sur la machine Robot
Le robot JavaScript SDK

Important :
Le Robot JavaScript SDK est fourni prêt à l'emploi pour Studio v2020.4 et versions ultérieures. Pour Studio v2019.10 LTS, un installateur autonome de module complémentaire est également disponible.

Si vous effectuez une mise à niveau de v2019.10 vers v2020.2 et versions ultérieures, vous devez désinstaller manuellement le module de complément UiPath Robot JS avant d’exécuter l’installateur Studio et Robot.

Autoriser l'accès

Lorsque le module complémentaire UiPath Robot JavaScript est exécuté, vous devez fournir l'accès à votre application ou page Web personnalisée pour vous connecter au Robot.

L'accès est géré par une boîte de dialogue en deux étapes. Les deux étapes doivent être confirmées pour exécuter RobotJS. Ils peuvent être automatisés comme décrit ci-dessous.

Boîte de dialogue d'accès au navigateur

Cette étape fait référence au navigateur qui demande les autorisations pour ouvrir l'Assistant UiPath.

Acceptation automatique de la boîte de dialogue Accès au navigateur

Il peut être automatisé en ajoutant la valeur uipath-web://* en tant qu'URL approuvée (autorisée) dans les paramètres du navigateur. Le uipath-web://* fait référence au gestionnaire de protocole Web du Robot UiPath.

Remarque : en fonction du navigateur utilisé, différents paramètres doivent être configurés. Si vous utilisez Google Chrome, par exemple, suivez les étapes décrites dans la documentation Google Chrome URLAllowList .

Boîte de dialogue d'autorisation du robot

La boîte de dialogue de consentement du robot est utilisée pour autoriser la connexion entre le Robot JavaScript SDK et l'exécuteur de Robot.

Accepter automatiquement la boîte de dialogue de consentement du robot

Cela peut être automatiquement autorisé en ajoutant la variable d'environnement système UIPATH_ROBOTJS_ALLOWLIST .

Les valeurs utilisées dans la variable doivent être les URL de votre application ou page Web personnalisée, séparées par des virgules. L'URL ne doit contenir le numéro de port que si un port standard n'est pas utilisé ( 80 ou 443 ).

Le robot JavaScript SDK

Ce SDK fournit toutes les méthodes et propriétés nécessaires que vous pouvez inclure dans votre application personnalisée ou votre page Web. Vous pouvez le télécharger comme suit :

NPM

Le package npm est disponible avec des liaisons TypeScript. Pour l'inclure dans votre projet, vous devez exécuter la commande suivante à la racine de votre répertoire de projet :

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

CDN

Pour CDN, vous devez inclure le SDK avant de fermer la balise </body>.

<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>

Téléchargement direct

Vous pouvez également saisir le Robot JavaScript SDK via téléchargement direct.

Paramètres de module complémentaire

Afin de modifier les paramètres du module complémentaire, vous devez ajouter les paramètres ListenerPort et TokenExpiryInDays dans le fichier uipath.config du dossier d'installation. Par défaut, la section ne contient aucune clé.

Le fichier de configuration doit contenir les éléments suivants :

<robotJsSettings>
    <add key="ListenerPort" value="2323" />
    <add key="TokenExpiryInDays" value="30" />
</robotJsSettings><robotJsSettings>
    <add key="ListenerPort" value="2323" />
    <add key="TokenExpiryInDays" value="30" />
</robotJsSettings>

Attribut	Description
`ListenerPort`	Le `UiPath.RobotJS.ServiceHost.exe` commence un HttpListener sur le port configuré et contient les informations sur les autres auditeurs locaux de la session d'utilisateur active sur ce système. Veuillez noter que la valeur du port doit correspondre à celle configurée dans les paramètres SDK.
`TokenExpiryInDays`	Toute demande provenant d’un nouveau domaine doit obtenir le consentement de l’utilisateur pour permettre l’accès aux UiPath Robots à partir d’une application Web. Ces consentements sont valables pour le nombre de jours mentionnés dans ce paramètre.