- Robot JavaScript SDK
- À propos du Robot JavaScript SDK
- Étapes de configuration
Prérequis et étapes de configuration pour utiliser le Robot JavaScript SDK, y compris installer le module complémentaire JavaScript et autoriser l’accès au navigateur.
Prérequis
Les conditions préalables suivantes doivent être remplies pour que les projets d'automatisation utilisent le Robot JavaScript SDK:
- 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. Les deux boîtes de dialogue prennent en charge l'automatisation comme décrit dans les sections suivantes.
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 d'accès du 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.
En fonction du navigateur utilisé, différents paramètres doivent être configurés. Par exemple, si vous utilisez Google Chrome, suivez les étapes décrites dans la documentation de 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 .
La valeur de la variable doit contenir les URL de votre application personnalisée ou de votre page Web, séparées par des points-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 du répertoire de votre projet :
npm install --save @uipath/robot
npm 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
Les paramètres du module complémentaire sont configurés en ajoutant les paramètres ListenerPort et TokenExpiryInDays au fichier uipath.config dans le 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 démarre un HttpListener sur le port configuré et contient les informations sur les autres processus d'écoute locaux de la session utilisateur active sur ce système. La valeur du port doit correspondre à celle configurée dans les paramètres du 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. |
- Prérequis
- Autoriser l'accès
- Boîte de dialogue d'accès au navigateur
- Acceptation automatique de la boîte de dialogue d'accès du navigateur
- Boîte de dialogue d'autorisation du robot
- Accepter automatiquement la boîte de dialogue de consentement du robot
- Le robot JavaScript SDK
- NPM
- CDN
- Téléchargement direct
- Paramètres de module complémentaire