- Robot JavaScript SDK
- Über das Roboter-JavaScript-SDK
- Konfigurationsschritte
Voraussetzungen und Konfiguration für die Verwendung des Robot JavaScript SDK, einschließlich der Installation des UiPath JavaScript-Add-Ons und der Einstellungen für den Browserzugriff.
Diese Seite behandelt die Voraussetzungen und Konfigurationen für die Verwendung des Robot JavaScript SDK in benutzerdefinierten Webanwendungen, einschließlich der Einrichtung des Browsers und des Zugriffs auf die Roboterzustimmung, der Installation des SDK und der Konfiguration des JavaScript-Add-Ons.
Voraussetzungen
Folgende Voraussetzungen müssen erfüllt sein, damit Automatisierungsprojekte das Roboter-JavaScript-SDK verwenden können:
- Studio- und Roboterversion 2021.10 oder höher installiert
- Das auf der Robotermaschine installierte UiPath JavaScript Add-On
Zugriff zulassen
Wenn das UiPath Robot-JavaScript-Add-On ausgeführt wird, müssen Sie Zugriff auf Ihre benutzerdefinierte Anwendung oder Webseite gewähren, um eine Verbindung mit dem Roboter herzustellen.
Der Zugriff erfolgt über ein zweistufiges Dialogfeld. Beide Schritte müssen bestätigt werden, um RobotJS auszuführen. Beide Dialogfelder unterstützen die Automatisierung, wie unten beschrieben.
Dialogfeld „Browserzugriff“
Dieser Schritt bezieht sich auf den Browser, der Berechtigungen zum Öffnen des UiPath Assistant anfordert.
Automatisches Akzeptieren des Browserzugriffsdialogfelds
Der Wert uipath-web://*, der als vertrauenswürdige URL in den Browsereinstellungen hinzugefügt wurde, automatisiert dieses Dialogfeld. uipath-web://* bezieht sich auf den UiPath Robot-Webprotokollhandler.
Je nach verwendetem Browser müssen unterschiedliche Einstellungen konfiguriert werden. Wenn Sie beispielsweise Google Chrome verwenden, führen Sie die in der Dokumentation zu Google Chrome URLAllowlist beschriebenen Schritte aus.
Dialogfeld zur Zustimmung des Roboters
Das Dialogfeld „Roboterzustimmung“ wird verwendet, um die Verbindung zwischen dem Robot JavaScript SDK und dem Robot Executor zuzulassen.
Automatisches Akzeptieren des Roboter-Zustimmungsdialogs
Die Systemumgebungsvariable UIPATH_ROBOTJS_ALLOWLIST akzeptiert automatisch das Dialogfeld für die Roboter-Zustimmung.
Der Variablenwert muss die URLs Ihrer benutzerdefinierten Anwendung oder Webseite enthalten, getrennt durch Semikolons. Die URL sollte die Portnummer nur enthalten, wenn kein Standardport verwendet wird (80 oder 443).
Das Roboter-JavaScript-SDK
Dieses SDK bietet alle erforderlichen Methoden und Eigenschaften, die Sie in Ihre benutzerdefinierte Anwendung oder Webseite aufnehmen können. Sie können es wie folgt herunterladen:
NPM
Das Paket npm ist mit TypeScript-Bindungen verfügbar. Um es in Ihr Projekt aufzunehmen, führen Sie den folgenden Befehl im Stammverzeichnis Ihres Projektverzeichnisses aus:
npm install --save @uipath/robot
npm install --save @uipath/robot
CDN
Fügen Sie für CDN das SDK vor dem schließenden </body> -Tag ein:
<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>
Direkter Download
Sie können das Roboter-JavaScript-SDK auch direkt herunterladen.
Add-on-Einstellungen
Um Add-on-Einstellungen zu ändern, fügen Sie die Parameter ListenerPort und TokenExpiryInDays zur uipath.config -Datei im Installationsordner hinzu. Standardmäßig enthält der Abschnitt keine Tasten.
Die Konfigurationsdatei muss Folgendes enthalten:
<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 | Beschreibung |
|---|---|
ListenerPort | UiPath.RobotJS.ServiceHost.exe startet einen HttpListener auf dem konfigurierten Port und enthält die Informationen über andere lokale Listener aus der aktiven Benutzersitzung auf diesem System. Der Portwert muss mit dem in den SDK-Einstellungen konfigurierten übereinstimmen. |
TokenExpiryInDays | Jede Anforderung, die von einer neuen Domäne kommt, muss die Zustimmung des Benutzers haben, um den Zugriff auf UiPath Robots von einer Webanwendung aus zu ermöglichen. Diese Einwilligungen gelten für die genannte Anzahl von Tagen, die in dieser Einstellung angegeben sind. |