Installation

Das Action Center ist jetzt für die lokale Installation verfügbar, sodass Sie Aktionen auf einer dedizierten Benutzeroberfläche anstelle der Registerkarte Aktionen in der entsprechenden Orchestrator-Instanz verwalten können.

Obwohl das Action Center von einer vorhandenen Orchestrator-Instanz abhängt, kann es auf einem separaten Server oder demselben Server wie der Orchestrator installiert werden.

Die Authentifizierungs- und Autorisierungsaspekte werden über eine entsprechende Identity Server-Instanz und eine Orchestrator-Instanz verwaltet, wie während der Action Center-Installation beschrieben.

Kompatibilität

Orchestrator

Kunden, die das Action Center innerhalb des Orchestrators nutzen, müssen keine zusätzlichen Schritte ausführen, sondern nur die Action Center-Instanz auf eine vorhandene Orchestrator-Instanz (2021.10) verweisen. Alle vorhandenen Aktionen sehen die Endbenutzer im neuen Action Center-Portal gemäß der in einem entsprechenden Orchestrator-Mandanten definierten Zugriffssteuerung.

Erfahren Sie mehr über die Ab- und Aufwärtskompatibilität zwischen dem Action Center und dem Orchestrator.

Unterstützte Topologien

Einzelknotenszenarien

• Action Center, das auf demselben Server wie Orchestrator ausgeführt wird (unterschiedlicher Port).
• Action Center, das auf einem einzelnen Knotenserver ausgeführt wird und auf eine separate Orchestrator-Instanz mit einem einzelnen Knoten verweist.

Szenarien mit mehreren Knoten

• Orchestrator mit mehreren Knoten hinter einem Lastenausgleich:

  • Eine einzelne Action Center-Instanz, die auf einem anderen Server installiert ist und auf die Orchestrator-Lastenausgleich-URL verweist.
  • Das Action Center ist auf allen Orchestrator-Knoten installiert, die jeweils auf die Orchestrator-Lastenausgleich-URL verweisen.
  • Geschäftsanwender, die Zugriff auf eine Action Center-URL mit Lastenausgleich haben.

Orchestrator-Einstellungen zum Akzeptieren von Speicher-Bucket-Anforderungen aus Action Center

Funktionen in Action Center, die auf Orchestrator-Speicher-Buckets basieren (Bilder und PDF-Rendering bei Formularaktionen, Dokumentklassifizierungs- und Dokumentvalidierungsaktionen), erfordern die folgenden Konfigurationsänderungen in Orchestrator, um wie erwartet zu funktionieren:

1. Akzeptieren von Action Center-Anforderungen an Orchestrator
   1. Wechseln Sie zum Orchestrator-Installationsordner.
   2. Öffnen Sie die Datei UiPath.Orchestrator.dll.config mit Administratorberechtigungen.
   3. Finden Sie unter dem Tag <appSettings> den folgenden Schlüssel: <add key="AcceptedRootUrls" value="http://{your_localhost_name}:{port_number}" />. Wenn Sie den Schlüssel in der Datei nicht finden können, fügen Sie ihn selbst manuell hinzu.
   4. Hängen Sie die Action Center-URL an den zuvor gefundenen oder manuell hinzugefügten Schlüssel an (z. B. "https://{Action_Center_host}:{port_number}").
      Hinweis: Ersetzen Sie die Werte in den Klammern durch Ihre eigenen. Beispiel: <add key="AcceptedRootUrls" value="http://localhost:1234,https://laptop-batman:555" />
      Wichtig:

      • Stellen Sie sicher, dass der Wert des Schlüssels AcceptedRootUrls keine Leerzeichen enthält.
      • Fügen Sie den PORT-Wert nur dann hinzu, wenn er sich von 80 oder 443 (Standardports) unterscheidet.
2. Überprüfen Sie, ob das Verb OPTIONS in IIS für die Orchestrator-Website zulässig ist:
   1. Navigieren Sie zu IIS.
   2. Wählen Sie „UiPath Orchestrator“ in der Liste Sites aus.
   3. Doppelklicken Sie auf Filtern von Anfragen, um das Fenster Filtern von Anfragen zu öffnen.

   4. Gehen Sie zur Registerkarte HTTP-Verben und suchen Sie nach dem Verb OPTIONS in der angezeigten Liste.

      Falls das Verb OPTIONS nicht in der Liste vorhanden ist:

      1. Klicken Sie mit der rechten Maustaste in das Fenster und wählen Sie Verb zulassen aus.
         
         

         

         
         
      2. Geben Sie OPTIONS ein und klicken Sie auf OK.
         
         

         

         
         
3. Setzen Sie IIS zurück, damit die Änderungen wirksam werden.

   Für andere Speicher-Buckets wie Amazon S3 und Azure finden Sie unter CORS/CSP-Konfiguration Details zur Konfiguration der CORS- und CSP-Einstellungen.

Kommandozeilenparameter

Es ist möglich, die gesamte UiPath-Suite mithilfe der Befehlszeile zu installieren oder zu aktualisieren, sofern Sie über das Windows-Installationsprogramm für UiPath Action Center (UiPathActionCenter.msi) verfügen. In der folgenden Tabelle sind alle verfügbaren Parameter aufgeführt, die Sie mit Orchestrator verwenden können, zusammen mit einigen Beispielen.

Parameter	Beschreibung
/q	Hilft Ihnen, die angegebenen UiPath-Funktionen im Hintergrund zu installieren, ohne die Benutzeroberfläche anzuzeigen.
/L*V <LogFile>	Erstellt eine Installationsprotokolldatei im angegebenen Speicherort. Sie können die Datei an unser Supportteam weitersenden, wenn Sie aus irgendwelchen Gründen Probleme während des Installationsvorgangs haben.
HOST_NAME	Der Hostname des Geräts, auf dem das Action Center installiert ist.
WEBSITE_PORT	Ein nicht verwendeter Port auf dem Server. Verwenden Sie einen anderen Port als Orchestrator, wenn er auf demselben Server installiert ist. Wenn nicht angegeben, wird der Standardwert (443) verwendet, um HTTPS zu aktivieren.
CERTIFICATE_SUBJECT	Der Name des SSL-Zertifikats, das Sie zum Sichern von Verbindungen mit dem Action Center verwenden möchten. Wenn nicht angegeben, wird standardmäßig der vollständige Computername verwendet. Geben Sie den Fingerabdruck an, wenn mehrere Zertifikate mit demselben Betreff vorhanden sind.
INSTALLDIR	Ermöglicht die Installation von Action Center an einem benutzerdefinierten Speicherort. Standardmäßig ist es unter C:\Program Files (x86)\UiPath\ActionCenterinstalliert. Warnung: Sie benötigen Lese- und Schreib-Berechtigungen für das Installationsverzeichnis.
PORT_FIREWALL	Ermöglicht Ihnen die Auswahl, ob für diesen Port automatisch Firewall-Regeln hinzugefügt werden. Die verfügbaren Optionen sind: 0 - Es werden keine Firewall-Regeln hinzugefügt. 1 - Firewall-Regeln werden hinzugefügt.
PORT_DO_VALIDATE	Ermöglicht Ihnen die Auswahl, ob die Verfügbarkeit von Websiteports überprüft wird. Die verfügbaren Optionen sind: 0 - Es wird keine Validierung durchgeführt. 1 - Eine Validierung wird durchgeführt. Der Standardwert ist 1.
APPPOOL_IDENTITY_TYPE	Der Typ des Anwendungspools, den Sie für Action Center verwenden. Die verfügbaren Optionen sind: SpecificUser und ApplicationPoolIdentity.
APPPOOL_USER_NAME	Der Benutzername, mit dem der Anwendungspool ausgeführt wird. Dieser Parameter muss nur dann einbezogen werden, wenn APPPOOL_IDENTITY_TYPE auf USER festgelegt wurde.
APPPOOL_USER_PASSWORD	Das Passwort des Benutzers, der den Anwendungspool ausführt. Dieser Parameter muss nur dann aufgenommen werden, wenn APPPOOL_IDENTITY_TYPE auf USER festgelegt wurde.
ORCHESTRATOR_URL	Die URL der Orchestrator-Instanz. Wird vom Action Center für die gesamte Kommunikation mit Orchestrator verwendet.
IDENTITY_URL	Die URL der Identity Server-Instanz.
ACTION_CENTER_URL	Die Basis-URL von Action Center.
IDENTITY_INSTALLATION_TOKEN	Das Zugriffstoken aus dem Identitätsverwaltungsportal. Weitere Informationen finden Sie unter Zugreifen auf das Identitätsverwaltungsportal .
REGISTER_APP_URL	Das Flag, das zum Aktualisieren der Action Center URL verwendet wird. Standardmäßig auf true festgelegt.

Beispiele

Diese Beispiele wurden unter der Annahme erstellt, dass Sie schon in dem Verzeichnis sind, in dem sich der Installer UiPathActionCenter.msi befindet. Sie können dies mit dem folgenden Befehl machen, zum Beispiel: cd D:\UiPathActionCenter.msi.

Action Center bereinigen

msiexec /i UiPathActionCenter.msi^
HOST_NAME="ACTION_CENTER_HOSTNAME"^
WEBSITE_PORT="444"^
CERTIFICATE_SUBJECT="ACTION_CENTER_HOSTNAME"^
INSTALLDIR="C:\Program Files (x86)\UiPath\ActionCenter"^
APPPOOL_IDENTITY_TYPE="ApplicationPoolIdentity"^
PORT_FIREWALL="1"^
ORCHESTRATOR_URL="https://ORCHESTRATOR_URL"^
IDENTITY_URL="https://ORCHESTRATOR_URL/identity"^
ACTION_CENTER_URL="https://ACTION_CENTER_HOSTNAME:444/"^
IDENTITY_INSTALLATION_TOKEN="eyJhbGciOiJSUzI1NiIsImtpZCI6IkUyNjk3MDQzQjE1Q0QwRDlBMjBCQkZGODVGQjkyMTk2NkI4N0VFQTQiLCJ0eXAiOiJKV1QiLCJ4NXQiOiI0bWx3UTdGYzBObWlDN180WDdraGxtdUg3cVEifQ.eyJuYmYiOjE1OTkwNjk0NTQsImV4cCI6MTU5OTA3MzA1NCwiaXNzIjoiaHR0cHM6Ly9ndXJwcmVldHVpcGF0aC9pZGVudGl0eSIsImNsaWVudF9pZCI6ImdlbmVyYXRlZENsaWVudCIsImF1ZCI6IklkZW50aXR5U2VydmVyQXBpIiwic2NvcGUiOlsiSWRlbnRpdHlTZXJ2ZXJDbGllbnRNYW5hZ2VtZW50Il19.MV9ehC8D5uBcg8PFRb8FPHv05oeFRwZgJURv2GUcmUxvQo3hzdjsxomMXoCHJiNQlqLxqsIzYrgfjwKcpVEchfyWl6HcqKvT_1s8eC3DP9qdrQJtuCrBJqgUcC99v3NaJ6UbdKYVtFDiPlIEetmqsl5ET2Dp0lNxxWle5Zp_p91U-I7SqRHz8lOm0oG0pyKeft53S7jM5Jj2Utr7bLb46ci2cmLgrwsH3Mu7rKOUCtfGHgaNvXoW5XZh9s2OYitZ-XRkCuncjXKoo9pSz7jq8MqVaLnxVRcFrpH2kDRfUew4CMeMJ-lx75maxWyElp9RnxDPykD6wXJAIPFsnuTqQA"^
/L*V "C:\InstallationLogs.log"^
/q

Aktualisieren einer vorhandenen Action Center-Installation

Bei einem solchen Upgrade müssen Sie zwei Parameter in der Befehlszeile übergeben, nämlich IDENTITY_INSTALLATION_TOKEN und REGISTER_APP_URL.

Im folgenden Befehlszeilenbeispiel wird die Action Center-Installation mit einem Knoten im Hintergrund aktualisiert und eine Protokolldatei generiert.

msiexec /i UiPathActionCenter.msi^
REGISTER_APP_URL="true"^
IDENTITY_INSTALLATION_TOKEN="eyJhbGciOiJSUzI1NiIsImtpZCI6IkUyNjk3MDQzQjE1Q0QwRDlBMjBCQkZGODVGQjkyMTk2NkI4N0VFQTQiLCJ0eXAiOiJKV1QiLCJ4NXQiOiI0bWx3UTdGYzBObWlDN180WDdraGxtdUg3cVEifQ.eyJuYmYiOjE1OTkwNjk0NTQsImV4cCI6MTU5OTA3MzA1NCwiaXNzIjoiaHR0cHM6Ly9ndXJwcmVldHVpcGF0aC9pZGVudGl0eSIsImNsaWVudF9pZCI6ImdlbmVyYXRlZENsaWVudCIsImF1ZCI6IklkZW50aXR5U2VydmVyQXBpIiwic2NvcGUiOlsiSWRlbnRpdHlTZXJ2ZXJDbGllbnRNYW5hZ2VtZW50Il19.MV9ehC8D5uBcg8PFRb8FPHv05oeFRwZgJURv2GUcmUxvQo3hzdjsxomMXoCHJiNQlqLxqsIzYrgfjwKcpVEchfyWl6HcqKvT_1s8eC3DP9qdrQJtuCrBJqgUcC99v3NaJ6UbdKYVtFDiPlIEetmqsl5ET2Dp0lNxxWle5Zp_p91U-I7SqRHz8lOm0oG0pyKeft53S7jM5Jj2Utr7bLb46ci2cmLgrwsH3Mu7rKOUCtfGHgaNvXoW5XZh9s2OYitZ-XRkCuncjXKoo9pSz7jq8MqVaLnxVRcFrpH2kDRfUew4CMeMJ-lx75maxWyElp9RnxDPykD6wXJAIPFsnuTqQA"^
/L*V "C:\InstallationLogs.log"^
/q

Hinweis: Bei Installationen mit mehreren Knoten ist der Parameter REGISTER_APP_URL für sekundäre Knoten optional.

Deaktivieren Sie das Flag zum Aktualisieren der Action Center-URL für sekundäre Knoten wie folgt:

• Automatisches Upgrade – Legen Sie den Flagwert auf „false“ fest (REGISTER_APP_URL="false").
• Interaktives Upgrade – Deaktivieren Sie das Kontrollkästchen für sekundäre Knoten.

Action Center wird deinstalliert

msiexec /uninstall UiPathActionCenter.msi