Roboter – Konfigurationsschritte

Voraussetzungen

Damit Ihre Automatisierungsprojekte vom Roboter-JavaScript-SDK profitieren können, müssen die folgenden Voraussetzungen erfüllt sein:

Studio and Robot version 2021.10 or greater installed
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. Sie können wie unten beschrieben automatisiert werden.

Dialogfeld „Browserzugriff“

Dieser Schritt bezieht sich auf den Browser, der Berechtigungen zum Öffnen des UiPath Assistant anfordert.

Automatisches Akzeptieren des Browserzugriffsdialogs

It can be automated by adding the uipath-web://* value as a trusted (allowed) URL in the browser's settings. The uipath-web://* refers to the UiPath Robot web protocol handler.

Note: Based on the browser used, different settings need to be configured. For example, if you are using Google Chrome, follow the steps described in the Google Chrome URLAllowlist documentation.

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.

Die in der Variablen verwendeten Werte müssen die URLs Ihrer benutzerdefinierten Anwendung oder Webseite sein und durch Semikolon getrennt werden. 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 npm-Paket ist mit TypeScript-Bindungen verfügbar. Um es in Ihr Projekt aufzunehmen, müssen Sie den folgenden Befehl im Stammverzeichnis Ihres Projekts ausführen:

npm install --save @uipath/robotnpm 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

Um Add-On-Einstellungen zu ändern, müssen Sie die Parameter ListenerPort und TokenExpiryInDays in der Datei uipath.config aus dem Installationsordner hinzufügen. Standardmäßig enthält der Abschnitt keine Schlüssel.

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`	Der `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. Bitte beachten Sie, dass der Portwert hier mit dem in den SDK-Einstellungen konfigurierten Wert übereinstimmen muss.
`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.

Robot developer guide

Konfigurationsschritte