- Robot JavaScript SDK
- À propos du Robot JavaScript SDK
- Étapes de configuration
Prérequis et configuration pour utiliser le Robot JavaScript SDK, y compris l’installation du module complémentaire UiPath JavaScript et les paramètres d’accès au navigateur.
Cette page couvre les prérequis et la configuration nécessaires à l'utilisation du Robot JavaScript SDK dans des applications Web personnalisées, y compris la configuration du navigateur et de l'accès au consentement du Robot, de l'installation du SDK et de la configuration du module complémentaire JavaScript.
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 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 d'accès du navigateur
La valeur uipath-web://*, ajoutée en tant qu'URL approuvée dans les paramètres du navigateur, automatise cette boîte de dialogue. La valeur 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
La variable d'environnement système UIPATH_ROBOTJS_ALLOWLIST accepte automatiquement la boîte de dialogue de consentement du robot.
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, exécutez la commande suivante à la racine de votre répertoire de projet:
npm install --save @uipath/robot
npm install --save @uipath/robot
CDN
Pour CDN, incluez le SDK avant la balise </body> de fermeture:
<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
Pour modifier les paramètres du module complémentaire, ajoutez 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