É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 2021.10 ou ultérieure installée
Module complémentaire JavaScript UiPath installé sur la machine 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

Elle peut être automatisée en ajoutant la valeur uipath-web://* comme URL approuvée (autorisée) dans les paramètres du navigateur. La uipath-web://* indique le gestionnaire de protocole Web du UiPath Robot.

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.

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.3.2/UiPathRobot.js"></script>
</body><body>
...
...
<script href="//download.uipath.com/js/1.3.2/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.