- Robot JavaScript SDK
- À propos du Robot JavaScript SDK
- Étapes de configuration
Prérequis et étapes de configuration du SDK Javascript du Robot: installation du module complémentaire JavaScript et configuration de l'accès à l'application.
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 JavaScript du UiPath Robot est exécuté, l'accès doit être accordé pour votre application personnalisée ou votre page Web afin de 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
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 du répertoire de votre projet:
npm install --save @uipath/robotnpm install --save @uipath/robot
CDN
Pour CDN:
-
Ajoutez la balise de script suivante avant 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
Téléchargez le Robot JavaScript SDK via téléchargement direct.
Paramètres de module complémentaire
Pour configurer les paramètres du module complémentaire:
- Ouvrez le fichier
uipath.configdans le dossier d'installation. - Ajoutez les paramètres
ListenerPortetTokenExpiryInDaysà la section<robotJsSettings>. Par défaut, la section ne contient aucune clé:
<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