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 in Process Mining (Automation Suite) zu laden. Weitere Informationen zu Theobald Xtract Universal (XU) finden Sie auf der offiziellen Theobald Software-Website .

Theobald Xtract Universal bietet einen schnellen Datenzugriff und Extraktionen in SAP ECC- und SAP HANA-Datenquellen. Allgemeine Anweisungen zur Verwendung von Theobald Xtract Universal (XU) 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.
• Theobald Xtract Universal installiert haben. Weitere Informationen zur Installation einer Aktualisierung Theobald Xtract Universal und zum Anpassen des Funktionsmoduls für die Tabellenextraktion in SAP finden Sie in der offiziellen Theobald Software-Dokumentation.

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 ein schreibgeschütztes benutzerdefiniertes Funktionsmodul, das in SAP installiert werden muss. Verwenden Sie den folgenden Link, um das benutzerdefinierte Modul herunterzuladen: Z_THEO_READ_TABLE-transport1.zip.

Hinweis:

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

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.

Setup credentials for the SQL Server database

Uploading data to Process Mining (Automation Suite) requires access to the SQL Server database location to which the extracted data needs to be uploaded. To set up a SQL Server destination connection you need the following setup parameters to authenticate access to the SQL Server database location.

• Server
• Database
• Schema
• Role

Aktivieren Sie das Abrufen der SQL Server-Datenbankparameter.

Laden von Daten mit Theobald Xtract Universal

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

1. Richten Sie den SQL-Benutzers zum Hochladen der Daten ein;
2. Importieren Sie die Vorlagenextraktionen;
3. Konfigurieren Sie die Quelle;
4. Konfigurieren Sie das Ziel;
5. Konfigurieren Sie das Extraktionsskript;
6. Führen Sie das Extraktionsskript aus.

Die Schritte werden unten im Detail beschrieben.

Einrichten des SQL-Benutzers zum Hochladen der Daten

Jede Prozess-App, die die Option zum Hochladen von Daten über den Extraktor nutzt, benötigt einen dedizierten SQL Server-Benutzer mit spezifischem Zugriff auf das Schema, das der Prozess-App zugeordnet ist.

Führen Sie die folgenden Schritte aus.

Schritt	Aktion	Syntax
1	Erstellen Sie eine Anmeldung. Die Anmeldung muss in der Master-Datenbank erstellt werden.	CREATE LOGIN <SQL_login_name> WITH PASSWORD = '<Password>'
2	Erstellen Sie einen Datenbankbenutzer für die Anmeldung. Dieser Benutzer muss in der AutomationSuite_ProcessMining_WareHouse-Datenbank erstellt werden.	CREATE USER <User_name> FOR LOGIN <SQL_login_name>
3	Weisen Sie den Benutzer der richtigen Datenbankrolle zu.	SP_ADDROLEMEMBER <Role>, <User_name>
4	Legen Sie das Standardschema für den erstellten Benutzer fest. Dieser Schritt ist nur zum Laden von Daten mit Theobald Xtract Universal erforderlich.	ALTER USER <User_name> WITH DEFAULT_SCHEMA = <Schema>

Importieren der Vorlagenextraktionen

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

Schritt	Aktion
1	Gehen Sie zur Seite App-Vorlagen und öffnen Sie die Dokumentationsseite für Ihre App-Vorlage.
2	Finden Sie den Abschnitt Laden von Daten mit Theobald Xtract Universal und laden Sie die Datei XU_template_extractions_as.zip für Ihre App-Vorlage herunter. Siehe App-Vorlagen. Diese XU_template_extractions_as.zip -Datei enthält die Ordner destinations, extractions und sources.
3	Kopieren Sie die Ordner aus der heruntergeladenen XU_template_extractions_as.zip -Datei in den config -Ordner von Xtract Universal. Der Speicherort dieses Ordners ist [XU_installation_path] /config.
4	Öffnen Sie Xtract Universal Designer und klicken Sie auf die Schaltfläche „Aktualisieren“, um alle Extraktionen zu laden.

Hinweis:

Sie können sich mit dem Standardbenutzer anmelden.

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

Konfigurieren der Quelle

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

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

Konfigurieren des Ziels

Führen Sie diese Schritte aus, um das SQL Server-Ziel in Theobald Xtract Universal zu konfigurieren.

1. Wechseln Sie zu Server – Ziele verwalten und bearbeiten Sie das SQL Server-Ziel.
2. Geben Sie die Einstellungen ein, um eine Verbindung mit Ihrem SQL Server-Ziel herzustellen.

Weitere Informationen finden Sie unter Abrufen der SQL Server-Datenbankparameter .

Konfigurieren des Extraktionsskripts

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

Schritt	Aktion
1	Gehen Sie zur Seite App-Vorlagen und öffnen Sie die Dokumentationsseite für Ihre App-Vorlage.
2	Finden Sie den Abschnitt Laden von Daten mit Theobald Xtract Universal und laden Sie die extract_theobald_as.zip -Datei für Ihre App-Vorlage herunter. Diese extract_theobald_as.zip -Datei enthält das Skript extract_theobald.ps1 und die Datei config.json .
3	Entpacken Sie den Inhalt der Datei extract_theobald_as.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 xu.exe finden. Beispiel: C:\MeinOrdner.
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 .
as_server	Der Teil der URL, der den Server bezeichnet, auf dem die App erstellt wird. Siehe Abrufen der SQL Server-Datenbankparameter.
as_organization	Der Teil der URL, der die Organisation der erstellten App angibt. Siehe Abrufen der SQL Server-Datenbankparameter.
as_tenant	Der Teil der URL, der den Mandanten der erstellten App angibt. Siehe Abrufen der SQL Server-Datenbankparameter.
as_app_ID	Die App-ID der erstellten App.
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. 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. 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.

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.

Manuelles Starten der Datei

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

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

Die Datenausführung erstellt auch eine Protokolldatei, die bei unerwarteten Ergebnissen helfen kann oder wenn der Datenupload mit dem Datenuploadprogramm fehlschlägt. 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 Theobald Software-Dokumentation Call über Befehlszeile . Wenn etwas mit dem Setup 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.

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 Datenerfassung fehlschlagen, da einige fehlerhafte Daten extrahiert werden. Sie können diese Daten mithilfe von Theobald Xtract Universal mit 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.

Fehlersuche und ‑behebung

Die Datenausführung erstellt auch eine Protokolldatei, die bei unerwarteten Ergebnissen helfen kann oder wenn der Datenupload mit dem Datenuploadprogramm fehlschlägt. 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 Theobald Software-Dokumentation Call über Befehlszeile . Wenn etwas mit dem Setup nicht stimmt, wird dies in der Fehlermeldung erwähnt.

Extraktionsprobleme mit CDPOS für Nicht-HANA-Systeme

In einigen älteren Nicht-HANA-Systemen ist CDPOS eine Clustertabelle und kann zu einem „Join with pool table“-Fehler wie unten führen.

Die Extraktion der Tabelle CDPOS enthält standardmäßig eine Verknüpfung mit der Tabelle CDHDR , um die Anzahl der Datensätze zu begrenzen, die extrahiert werden müssen. Führen Sie diese Schritte aus, um diesen Fehler zu beheben.

1. Bearbeiten Sie die CDPOS-Extraktion in Xtract Universal Designer, um CDHDR aus den Tabellen zu entfernen.

2. Ersetzen Sie CDHDR~UDATE between @extraction_start_date and @extraction_end_date durch:

   CHANGENR between @CHANGENR_min and @CHANGENR_max

3. Ersetzen Sie in extract_theobald.ps1 &"$xu_location\xu.exe" -s "$xu_server" -p "$xu_port" -n "CDPOS" -o "extraction_start_date=$extraction_start_date" -o "extraction_end_date=$extraction_end_date" durch den unten angezeigten Code.

&"$xu_location\xu.exe" -s "$xu_server" -p "$xu_port" -n "CDHDR_CSV" -o "extraction_start_date=$extraction_start_date" -o "extraction_end_date=$extraction_end_date"
CheckExtractionError('CDHDR_CSV')
$CDHDR = Import-Csv -Path "$xu_location\<app_template_specific>output\CDHDR_CSV.csv" -Delimiter "`t"
$CDHDR_sorted = $CDHDR | Sort-Object -Property CHANGENR
$CHANGENR_min=$CDHDR_sorted.GetValue(0).CHANGENR
$CHANGENR_max=$CDHDR_sorted.GetValue($CDHDR_sorted.Count-1).CHANGENR
&"$xu_location\xu.exe" -s "$xu_server" -p "$xu_port" -n "CDPOS" -o "CHANGENR_min=$CHANGENR_min" -o "CHANGENR_max=$CHANGENR_max"

Hinweis:

Dies ist ein allgemeines Beispiel, die Tabellennamen können für Ihre App-Vorlage unterschiedlich sein.

Hinweis:

Ersetzen Sie den Ausgabeordner <app_template_specific> &LT;app_template_specific>> mit dem Ausgabeordner, der für extract_theobald.ps1 Ihre App-Vorlage in angegeben ist.

Andere Extraktionsprobleme

Analysefehler

Wenn die Extraktion mit einem Analysefehler fehlschlägt (z. B. Unexpected ')'), überprüfen Sie die WHERE -Klausel der Extraktion, die fehlschlägt. Stellen Sie sicher, dass die Abstände um Klammern und die darin enthaltenen Werte korrekt sind. Inkonsistente Formatierungen können Probleme bei der Analyse verursachen.

Zum Beispiel sollte name in ('a', ‘b', ‘c’) zu name in ( ‘a’, ‘b’, ‘c’ ) aktualisiert werden.

Nachdem Sie die WHERE -Klausel korrigiert und die Extraktion gespeichert haben, führen Sie sie erneut aus.

Metadata

Während der Extraktion können unerwartete Fehler auftreten. Zum Beispiel:

23,O2C_VBAK,2023-05-16_08:46:54.984,4,FinishedErrors,Error,LiveDataExtraction,Theobald.Extractors.Table.TheoReadTableException: Length of the field VBTYP not valid. Given length is 000002 . Length in SAP is 000008

Dies kann daran liegen, dass die in den Vorlagenextraktionen definierten Eigenschaften nicht mit denen Ihres SAP-Systems übereinstimmen.

Wählen Sie in Theobald Xtract Universal die Schaltfläche Metadaten aktualisieren aus, um die Metadateneigenschaften zu aktualisieren, damit sie Ihr SAP-System widerspiegeln, und überprüfen Sie, ob das Problem behoben ist.

Probleme bei inkrementellen Extraktion

Wenn bei einer inkrementellen Extraktion in Theobald Xtract Universal ein Problem auftritt, können Sie die inkrementellen Einstellungen zurücksetzen, indem Sie die Extraktion öffnen und CDC-Ressourcen löschen auswählen.

Dadurch wird die Aufzeichnung der letzten erfolgreichen Extraktion entfernt. Bei der nächsten Ausführung der Extraktion wird die Tabelle vollständig geladen. Nachfolgende Extraktionen werden dann wieder inkrementell ausgeführt.

Sie können diese Option auch verwenden, wenn Sie die Extraktionskonfiguration ändern (z. B. beim Hinzufügen eines neuen Felds).

Timeout-Probleme

Während der Extraktion können Timeout-Probleme auftreten. Informationen zu den verfügbaren Timeout-Parametern finden Sie in der offiziellen SAP-Dokumentation .

Schlüssel duplizieren

Beim Hochladen von Daten mit Theobald Xtract Universal kann folgende Fehlermeldung auftreten:

Mögliche Ursache

Ein Feld, das für den Primärschlüssel der Tabelle verwendet wird, wird bei der Extraktion nicht abgerufen.

Lösung

Um dieses Problem zu lösen, müssen Sie überprüfen, ob alle Felder, die für den Primärschlüssel der Tabelle verwendet werden, bei der Extraktion abgerufen werden.

Die folgende Abbildung zeigt ein Beispiel aus der EKKN -Tabelle. Für diese Tabelle ist der Primärschlüssel nicht vollständig, da das Feld ZEKKN nicht abgerufen wird. Das Problem kann behoben werden, indem Sie sicherstellen, dass dieses Feld auch in der Extraktion verwendet wird.

Tipp:

Primärschlüssel in SAP-Tabellen erkennen Sie an dem Schlüsselsymbol, das vor dem Feldnamen angezeigt wird.