SDK – Konfigurationsschritte

Voraussetzungen

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

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

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.

Hinweis: Je nach verwendetem Browser müssen unterschiedliche Einstellungen konfiguriert werden. Wenn Sie beispielsweise Google Chrome verwenden, führen Sie die Schritte in der Dokumentation URL-Zulassungsliste von Google Chrome 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.

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.

Konfigurationsschritte