process-mining

2023.4

false

Wichtig :

Bitte beachten Sie, dass dieser Inhalt teilweise mithilfe von maschineller Übersetzung lokalisiert wurde.

Process Mining

BEREITSTELLUNG:

Automation Cloud Automation Cloud Public Sector Automation Suite Standalone

Last updated 17. Okt. 2024

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.

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.
Überprüfen Sie, ob der Netzwerkzugriff auf Ihr SAP-System offen ist; siehe SAP TCP/IP-Ports.
Gewähren Sie dem SAP-Benutzer Zugriff auf die SAP-Instanz; siehe Berechtigungsobjekte – SAP-Benutzerrechte für Tabelle.
Die folgenden Komponenten in Theobald Xtract Universal müssen in SAP angepasst werden: Z_THEO_READ_TABLE.
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.

Richten Sie den SQL-Benutzers zum Hochladen der Daten ein;
Importieren Sie die Vorlagenextraktionen;
Konfigurieren Sie die Quelle;
Konfigurieren Sie das Ziel;
Konfigurieren Sie das Extraktionsskript;
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`, `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	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.

Wechseln Sie zu Server – Ziele verwalten, und bearbeiten Sie das SQL Server-Ziel.
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.exe`finden. 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 `19700101`angegebene 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 `20991231`angegeben 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

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.

Bearbeiten Sie die CDPOS-Extraktion in Xtract Universal Designer, um CDHDR aus den Tabellen zu entfernen.
Ersetzen Sie CDHDR~UDATE between @extraction_start_date and @extraction_end_date durch:
CHANGENR between @CHANGENR_min and @CHANGENR_max
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"&"$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.