Installieren des UiPath-Datenextraktors

Der lokale UiPath-Datenextraktor muss in derselben Netzwerkumgebung wie die Datenquelle installiert werden (z. B. das SAP-System). Wenn SAP beispielsweise in einer privaten Cloud oder einem Rechenzentrum gehostet wird, sollte der UiPath-Datenextraktor in derselben Umgebung oder in demselben Netzwerksegment bereitgestellt werden, um eine zuverlässige und sichere Konnektivität zu gewährleisten.

Hinweis:

Wenn die Installation des UiPath-Datenextraktors im selben Netzwerk wie das SAP-System nicht möglich ist, ist es möglich, ihn außerhalb des privaten Netzwerks zu installieren. In diesem Fall müssen Sie die erforderlichen Ports (z. B. 33<xx>) auf dem SAP-System öffnen, wobei <xx> der SAP-Systemnummer entspricht, um eingehende und ausgehende Kommunikation zwischen dem UiPath-Datenextraktor und dem SAP-Server zu ermöglichen.

Wenn ein Proxy verwendet wird, muss er denselben 33<xx> -Port vom Proxy an den entsprechenden 33<xx> -Port auf dem SAP-System weiterleiten. Das liegt daran, dass der Theobald-RFC keine Verbindung mit benutzerdefinierten oder neu zugeordneten Ports unterstützt – er erwartet, dass die Verbindung mit dem Standardportformat basierend auf der SAP-Systemnummer hergestellt wird.

Weitere Informationen finden Sie in der offiziellen Theobald-Dokumentation zu Portanforderungen .

Die Installation des lokalen UiPath-Datenextraktors umfasst die folgenden Schritte.

1. Richten Sie Ihre UiPath Automation Cloud-Organisation ein.
2. Installieren Sie den UiPath-Datenextraktor in Ihrer lokalen Umgebung.
3. Installieren Sie das Theobald-RFC auf Ihrem SAP-Server.
   Hinweis: Dieser Schritt ist nur erforderlich, wenn der UiPath-Datenextraktor für die SAP-Datenextraktion installiert wird.

1. Einrichten der UiPath Cloud-Organisation

Führen Sie diese Schritte aus, um die UiPath Cloud-Organisation für den UiPath Data Extractor einzurichten.

1. Wechseln Sie in der Automation Cloud zu Administrator.
2. Wählen Sie die Kachel Externe Anwendungen aus, um eine externe Anwendung hinzuzufügen.
3. Wählen Sie auf der Registerkarte OAuth-Apps die Option +Anwendung hinzufügen.
4. Geben Sie einen beschreibenden Namen für die neue Anwendung in das Feld Anwendungsname ein. Zum Beispiel: „Lokaler Process Mining-Extraktor“.
5. Wählen Sie +Scopes hinzufügen aus.
   1. Wählen Sie Process Mining API-Zugriff aus der Liste der Ressourcen aus.
   2. Wählen Sie Anwendungs-Scope(s) und dann die Option ProcessMining.DataExtractor aus, um den Zugriff auf Process Mining zu aktivieren.
   3. Wählen Sie Speichern.
6. Wählen Sie auf der Seite Anwendung hinzufügen die Option Hinzufügen aus. Eine Bestätigungsmeldung wird angezeigt
7. Kopieren Sie die App-ID und den geheimen App-Schlüssel und fügen Sie sie ein, z. B. in Notepad.
   Hinweis: Sie benötigen die App-ID und den geheimen App-Schlüssel während der Installation des lokalen Datenextraktors in der lokalen Umgebung.
8. Wählen Sie Schließen aus.

2. Installieren des UiPath-Datenextraktors in der lokalen Umgebung

Voraussetzungen

Für den lokalen UiPath-Datenextraktor muss die .NET 8 ASP.NET Core-Runtime installiert sein. Sie können die neueste Version von der offiziellen Microsoft .NET-Website herunterladen.

Herunterladen des lokalen UiPath-Datenextraktors

Verwenden Sie den folgenden Link, um den lokalen UiPath-Datenextraktor herunterzuladen:

https://uipath.blob.core.windows.net/download/UiPathDataExtractor.zip

Installationsschritte

1. Extrahieren Sie das Installationspaket.
2. Öffnen Sie PowerShell als Administrator im extrahierten Ordner.
3. Konfigurieren Sie DataExtractor/appsettings.json mit Ihren Einstellungen.
   Hinweis: Sie benötigen die App-ID und den geheimen App-Schlüssel, die beim Einrichten der UiPath Cloud-Organisation gespeichert werden.
   Wichtig: Stellen Sie sicher, dass die in der ConnectionString definierten Benutzeranmeldeinformationen Zugriff auf die Tabellen haben, die Sie extrahieren möchten.

   {
   "UiPathURL": "https://cloud.uipath.com/<OrgName>/<TenantName>",
   "S2S": {
       "ClientId": "<Application id from UiPath admin portal>",
       "ClientSecret": "<Application secret from UiPath admin portal>"
   },
   "LogFilePath": "<OPTIONAL: Path to log file, otherwise will be in /Logs>",
   "Connections":[
      {
        "Type": "sapOnPrem",
        "Name": "<Connection Name>",
        "ConnectionString": "USER=<User>;PASSWORD=<Password>;LANG=<Language>;CLIENT=<ClientNumber>;HOST=<Host IP address>;SYSNR=<System number>;FUNCTIONMODULE=<Function module name>;"
      },
       {
         "Type": "sqlServer",
         "Name": "<Connection Name>",
         "ConnectionString": "Server=<ServerAddr>;Initial Catalog=<DatabaseName>;User Id=<User>;Password=<Password>;"
       }
    ]
   }

4. Führen Sie das Installationsskript mit dem folgenden Powershell-Befehl aus: ./Setup.ps1 -Install.

Hinweis: Führen Sie die folgenden Schritte aus, um SQL Server- oder SAP-Verbindungen hinzuzufügen, zu bearbeiten oder zu entfernen:

1. Bearbeiten Sie die appsettings.json -Datei und aktualisieren Sie die Werte nach Bedarf.
2. Führen Sie den Installationsbefehl ./Setup.ps1 -Install erneut aus.

Tipp: Für zusätzliche Skriptoptionen können Sie den folgenden Powershell-Befehl verwenden: ./Setup.ps1 -Help

3. Installieren von Theobald RFC auf Ihrem SAP-Server

Theobald Xtract Universal ist das SAP-zertifizierte Extraktionstool, das für die Datenextraktion aus SAP-Quellsystemen verwendet wird und über Remote Function Calls (RFC) in SAP integriert wird. Theobald Xtract Universal enthält das schreibgeschützte benutzerdefinierte Funktionsmodul Z_THEO_READ_TABLE-transport1, das in SAP installiert werden muss.

Der XtractCore/Transports -Ordner des UiPath-Datenextraktors enthält mehrere Versionen von Remote Function Calls (RFCs), die zum Lesen von Tabellen verwendet werden, zusammen mit einer README -Datei, die Details zu jeder Version enthält.

Weitere Informationen zur Konfiguration der SAP-Umgebung für die Ausführung mit dem UiPath-Datenextraktor finden Sie unter Einrichten von Theobald Xtract Universal (Schritte 2–4).

Deinstallieren des UiPath-Datenextraktors

Verwenden Sie den folgenden Powershell-Befehl, um den UiPath-Datenextraktor ./Setup.ps1 -Uninstall zu deinstallieren.

Alle zugrunde liegenden Dienste werden beendet und deinstalliert.