Laden von Daten mit Theobald Xtract Universal

Einleitung

Auf dieser Seite wird beschrieben, wie Sie Theobald Xtract Universal (XU) verwenden, um Daten aus Ihrem SAP-Quellsystem in eine Prozess-App zu laden. Weitere Informationen zu Theobald Xtract Universal (XU) finden Sie auf der offiziellen Theobald Software-Website .

Theobald Xtract Universal bietet schnellen Datenzugriff und Extraktionen auf SAP ECC- und SAP HANA-Datenquellen. Allgemeine Anweisungen zur Verwendung von Theobald Xtract Universal finden Sie in der offiziellen Theobald Software-Dokumentation Erste Schritte mit Theobald Xtract Universal.

Voraussetzungen

Dabei wird Folgendes angenommen:

• eine gültige Theobald Xtract Universal-Lizenz.
  Hinweis:

  Die Lizenz wird über UiPath zum Zweck von Process Mining bereitgestellt.

• installierte Theobald Xtract Universal. Weitere Informationen zum Installieren eines aktualisierten Theobald Xtract Universal und zum Anpassen des Funktionsmoduls für die Tabellenextraktion in SAP finden Sie in der offiziellen Dokumentation zu Theobald Software.

Hinweis: Das Laden von Daten mit Theobald Xtract Universal erfordert, dass das Befehlszeilentool ( xu.exe ) ohne zusätzliche Authentifizierung ausgeführt werden kann.

Einrichten von Theobald Xtract Universal

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.

Sie können den folgenden Link verwenden, um das benutzerdefinierte Modul herunterzuladen: Z_THEO_READ_TABLE-transport1.zip.

Achtung:

Die neueste Version der Z_THEO_READ_TABLE-transport1.zip-Datei ist immer enthalten, wenn Sie Xtract Universal herunterladen.

Führen Sie die folgenden Schritte aus, um Theobald Xtract Universal einzurichten.

1. Laden Sie die neueste Testversion von Theobald Xtract Universal von unserer Website herunter, siehe Testversion herunterladen. Installieren Sie Theobald Xtract Universal auf einem Windows Server/einer virtuellen Maschine.

2. Überprüfen Sie, ob der Netzwerkzugriff auf Ihr SAP-System offen ist; siehe SAP TCP/IP-Ports.

3. Gewähren Sie dem SAP-Benutzer Zugriff auf die SAP-Instanz; siehe Berechtigungsobjekte – SAP-Benutzerrechte für Tabelle.

4. Die folgenden Komponenten in Theobald Xtract Universal müssen in SAP angepasst werden: Z_THEO_READ_TABLE.

5. Konfigurieren Sie Theobald Xtract Universal für die erforderliche(n) App-Vorlage(n). Siehe App-Vorlagen.

Hinweis:

Die Schritte 2–4 erfordern eine Validierung durch Ihr SAP-Team.

SAS-URI (Shared Access Signature)

Um die Daten in die Process Mining Cloud hochladen zu können, benötigen Sie den Shared Access Signature (SAS)-URI des Azure-Blobspeichers, in den die extrahierten Daten hochgeladen werden sollen. Siehe Abrufen der Authentifizierungsanmeldeinformationen für eine App.

Laden von Daten mit Theobald Xtract Universal

Das Einrichten des Datenladens mit Theobald Xtract Universal erfordert mehrere Schritte.

1. Importieren Sie die Vorlagenextraktionen;
2. Konfigurieren Sie die Quelle;
3. Konfigurieren Sie das Extraktionsskript;
4. Einrichten des Daten-Uploaders;
5. Führen Sie das Extraktionsskript aus.

Die Schritte werden unten im Detail beschrieben.

Importieren der Vorlagenextraktionen

Führen Sie diese Schritte aus, um die Vorlagenextraktionen in Theobald Xtract Universal zu importieren.

1. Gehen Sie auf die Seite App-Vorlagen und öffnen Sie die Dokumentationsseite für Ihre App-Vorlage.

   Hinweis:

   Sie können sich mit dem Standardbenutzer anmelden.

   

   

2. Suchen Sie den Abschnitt Laden von Daten mit Theobald Xtract Universal und laden Sie die XU_template_extractions.zip -Datei für Ihre App-Vorlage herunter. Diese XU_template_extractions.zip -Datei enthält die Ordner destinations, extractionsund sources.

3. Kopieren Sie die Ordner aus der heruntergeladenen XU_template_extractions.zip -Datei in den config -Ordner von Xtract Universal. Der Speicherort dieses Ordners ist [XU_installation_path] /config.

4. Öffnen Sie den Theobald Xtract Universal Designer und klicken Sie auf die Schaltfläche zum Aktualisieren, um alle Extraktionen zu laden.

Eine Liste aller Extraktionen, die jeweils eine Tabelle aus dem SAP-System extrahieren, wird angezeigt. Die Vorlagenquelle heißt SAP und das Vorlagenziel heißt CSV.

Konfigurieren der Quelle

Führen Sie diese Schritte aus, um die SAP-Quelle in Theobald Xtract Universal zu konfigurieren.

1. Wechseln Sie zu Server – Quellen verwalten, und bearbeiten Sie die SAP-Quelle.
2. Geben Sie die Einstellungen auf den Registerkarten Allgemein und Authentifizierung ein, um eine Verbindung mit Ihrem SAP-System herzustellen.
3. Testen Sie die Verbindung.

Konfigurieren des Extraktionsskripts

Führen Sie diese Schritte aus, um das Extraktionsskript zu konfigurieren.

1. Gehen Sie auf die Seite App-Vorlagen und öffnen Sie die Dokumentationsseite für Ihre App-Vorlage.

2. Suchen Sie den Abschnitt Laden von Daten mit Theobald Xtract Universal und laden Sie die extract_theobald.zip -Datei für Ihre App-Vorlage herunter. Diese extract_theobald.zip -Datei enthält das extract_theobald.ps1 -Skript und die config.json -Datei.

3. Entpacken Sie den Inhalt der Datei extract_theobald.zip auf dem Server, auf dem Theobald Xtract Universal installiert ist.

4. Konfigurieren Sie die Variablen für das Skript in config.json wie unten aufgeführt.

Variable	Beschreibung
xu_location	Der Installationsordner von Xtract Universal. Dies ist der Ordner, in dem Sie die xu.exefinden. Beispiel: C:\\MyFolder.
xu_server	Adresse des Servers, auf dem Xtract Universal installiert ist. Der Standardwert ist localhost .
xu_port	Port des Servers, auf dem Xtract Universal installiert ist. Der Standardport einer Installation ist 8065 .
sas_uri	Der SAS-URI des Azure-Blobspeichers, in den die extrahierten Daten hochgeladen werden müssen. Siehe Abrufen der Anmeldeinformationen für den Azure-Blobspeicher.
end_of_upload_api	Die API, die aufgerufen wird, um die Datenverarbeitung in Process Mining zu starten, sobald alle Daten hochgeladen wurden. Siehe Abrufen der Anmeldeinformationen für den Azure-Blobspeicher.
extraction_start_date	Startdatum, das verwendet werden soll, um Extraktionen zu begrenzen. Nur Tabellen, auf die ein Datumsfilter angewendet wird, werden an diesem Datum gefiltert. Das Format ist YYYYMMDD. Der Standardwert ist keine durch das Startdatum 19700101angegebene Einschränkung. Hinweis: extraction_start_date muss einen Wert haben.
extraction_end_date	Enddatum, das verwendet werden soll, um Extraktionen zu begrenzen. Nur Tabellen, auf die ein Datumsfilter angewendet wird, werden an diesem Datum gefiltert. Das Format ist YYYYMMDD. Der Standardwert ist keine Einschränkung, die durch das Enddatum 20991231angegeben wird. Hinweis: extraction_end_date muss einen Wert haben.
language	Die Sprache, in der Daten aus dem Quellsystem extrahiert werden. Der Standardwert ist E.
exchange_rate_type	Der Wechselkurstyp, der für die Währungsumrechnung verwendet wird. Der Standardwert ist M.

Einrichten des Daten-Uploaders

Die Theobald Xtract Universal-Extraktion extrahiert Daten aus dem SAP-System und legt die Daten in .csv -Dateien in einem Ausgabeordner des Theobald Xtract Universal-Installationsordners ab. Der Daten-Uploader lädt die Dateien in den Azure-Blobspeicher hoch.

Führen Sie diese Schritte aus, um den Daten-Uploader einzurichten.

1. Laden Sie den DataUploaderherunter.
2. Speichern Sie die Datei im selben Ordner wie das extract_theobald.ps1 -Skript.

Ausführen des Extraktionsskripts

Um die Daten zu laden und sie zur Verwendung in Process Mining hochzuladen, müssen Sie die extract_theobald.ps1-Datei ausführen.

Der Zeitaufwand für diese Aufgabe hängt stark von den geladenen Datenmengen ab.

Die Ausgabe wird in den Blobspeicher hochgeladen, der die Verarbeitung in Snowflake auslöst.

Manuelles Starten der Datei

Führen Sie diesen Schritt aus, um die Datenausführung zu starten.

1. Führen Sie die Datei extract_theobald.ps1 aus, um die Datenausführung zu starten.

Bei der Datenausführung wird auch eine Protokolldatei erstellt, die bei unerwarteten Ergebnissen oder wenn der Daten-Upload mit dem Daten-Uploader fehlschlägt, hilfreich sein kann. Die Datei extraction.log enthält die Protokolle der letzten Datenausführung. Für jede fehlgeschlagene Extraktion wird ein Rückgabecode angezeigt. Weitere Informationen finden Sie in der offiziellen Dokumentation zu Theobald Software. Aufruf über die Befehlszeile . Wenn etwas mit der Einrichtung nicht stimmt, wird dies in der Fehlermeldung erwähnt.

Planen einer Aufgabe für die Datenausführung

Anstatt die Datei manuell auszuführen, können Sie mit der Aufgabenplanung von Windows eine Aufgabe planen, die das Batch-Skript für automatische Datenaktualisierungen ausführt.

Hinweis: Es wird empfohlen, das lokale SYSTEM-Benutzerkonto für die Ausführung der Aufgabe auszuwählen und beim Erstellen der Aufgabe in der Aufgabenplanung die Option Mit höchster Priorität ausführen im Fenster Aufgabe erstellen auszuwählen.

Die Ausgabe wird in den Blobspeicher hochgeladen, der die Verarbeitung in Snowflake auslöst.

Wichtig: Wenn Sie ein Intervall hinzufügen, für das keine Daten verfügbar sind, zeigen die Dashboards eine Fehlermeldung an.

Wenn die Extraktion erfolgreich ist, kann die Datenaufnahme fehlschlagen, da einige fehlerhafte Daten extrahiert werden. Sie können diese Daten mithilfe von Theobald Xtract Universal mithilfe der WHERE-Klausel herausfiltern. Weitere Informationen zur WHERE-Klausel finden Sie in der offiziellen Theobald-Dokumentation .

Hinweis:

Wenn Sie eine WHERE-Klausel haben, die Variablen verwendet (z. B. das Extraktionsdatum), können Sie nicht über die UI filtern.