Loading data using 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 schnellen Datenzugriff und Extraktionen auf 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.

• 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:

Loading data using Theobald Xtract Universal requires that the command line tool (xu.exe) can be executed without additional authentication.

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

Das Hochladen von Daten in Process Mining (Automation Suite) erfordert Zugriff zum Speicherort der SQL Server-Datenbank, in die die extrahierten Daten hochgeladen werden müssen. Zum Einrichten einer SQL Server-Zielverbindung benötigen Sie die folgenden Einrichtungsparameter, um den Zugriff zum Speicherort der SQL Server-Datenbank zu authentifizieren.

• Server
• Datenbank
• Schema
• Rolle

Siehe 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. Hinweis: 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. Hinweis: 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. Achtung: 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 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 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, extractionsund 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	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 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.

Konfigurieren des Extraktionsskripts

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

Schritt	Aktion
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_as.zip -Datei für Ihre App-Vorlage herunter. Diese extract_theobald_as.zip -Datei enthält das extract_theobald.ps1 -Skript und die config.json -Datei.
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 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 .
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. 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.

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.

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.

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.

Fehlersuche und ‑behebung

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.

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> durch den Ausgabeordner, der für Ihre App-Vorlage in extract_theobald.ps1 angegeben ist.

Andere Extraktionsprobleme

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.

Nachfolgend sehen Sie ein Beispiel aus der Tabelle EKKN . 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 sichergestellt wird, 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.