- Robot JavaScript SDK
- Über das Roboter-JavaScript-SDK
- Konfigurationsschritte
Voraussetzungen und Konfigurationsschritte für die Verwendung des Robot JavaScript SDK, einschließlich der Installation des JavaScript-Add-Ons und des Zulassens des Browserzugriffs.
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 in den folgenden Abschnitten beschrieben.
Dialogfeld „Browserzugriff“
Dieser Schritt bezieht sich auf den Browser, der Berechtigungen zum Öffnen des UiPath Assistant anfordert.
Automatisches Akzeptieren des Browserzugriffsdialogfelds
Dies kann automatisiert werden, indem Sie den Wert uipath-web://* als vertrauenswürdige (zulässige) URL in den Browsereinstellungen hinzufügen. 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
Dies kann automatisch zugelassen werden, indem die Systemumgebungsvariable UIPATH_ROBOTJS_ALLOWLIST hinzugefügt wird.
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, müssen Sie den folgenden Befehl im Stammverzeichnis Ihres Projektverzeichnisses ausführen:
npm install --save @uipath/robot
npm install --save @uipath/robot
CDN
Für CDN müssen Sie das SDK einschließen, bevor Sie das </body>-Tag schließen.
<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
Add-on-Einstellungen werden konfiguriert, indem die Parameter ListenerPort und TokenExpiryInDays der uipath.config -Datei im Installationsordner hinzugefügt werden. 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. |