UiPath Documentation
robot
latest
false
Guide du développeur UiPath Robot
  • Robot JavaScript SDK
    • À propos du Robot JavaScript SDK
    • Étapes de configuration
Important :
La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.

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

Remarque :

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.

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.

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:

  1. Exécutez la commande suivante à la racine du répertoire de votre projet:

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

CDN

Pour CDN:

  1. 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:

  1. Ouvrez le fichier uipath.config dans le dossier d'installation.
  2. Ajoutez les paramètres ListenerPort et TokenExpiryInDays à 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>
AttributDescription
ListenerPortLe 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.
TokenExpiryInDaysToute 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.

Cette page vous a-t-elle été utile ?

Connecter

Besoin d'aide ? Assistance

Vous souhaitez apprendre ? UiPath Academy

Vous avez des questions ? UiPath Forum

Rester à jour