- Robot JavaScript SDK
- Über das Roboter-JavaScript-SDK
- Konfigurationsschritte
Voraussetzungen und Konfiguration für das Robot JavaScript SDK, einschließlich der Installation des UiPath JavaScript-Add-Ons und der Gewährung des Ursprungszugriffs.
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, muss der Zugriff auf Ihre benutzerdefinierte Anwendung oder Webseite gewährt werden, um eine Verbindung mit dem Roboter herzustellen. Der Zugriff wird über ein zweistufiges Dialogfeld geregelt – 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
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. So nehmen Sie es in Ihr Projekt auf:
-
Führen Sie den folgenden Befehl im Stammverzeichnis Ihres Projektverzeichnisses aus:
npm install --save @uipath/robotnpm install --save @uipath/robot
CDN
Für CDN:
-
Fügen Sie das folgende Skript-Tag vor dem schließenden
</body>-Tag hinzu:<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
Laden Sie das Roboter-JavaScript-SDK direkt herunter.
Add-on-Einstellungen
So konfigurieren Sie die Add-on-Einstellungen:
- Öffnen Sie die
uipath.config-Datei im Installationsordner. - Fügen Sie die Parameter
ListenerPortundTokenExpiryInDayszum Abschnitt<robotJsSettings>hinzu. Standardmäßig enthält der Abschnitt keine Schlüssel:
<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. |