Aufruf der ETL/Excel-Datenübernahme

Dieses Programm dient zum Aufruf und Starten der Datenübernahme aus den EXCEL-Dateien aus Verfügbare und vorgefertigte Übernahmeprozesse. Eine detaillierte Beschreibung findet sich unter Datenübernahme aus Fremdsystemen per Microsoft Excel.

Der Aufruf der Datenübernahme erfolgt über das Programm „Aufruf der ETL/EXCEL-Datenübernahme – OP81055R". Im Menü ist es unter Administration -> Anwendungsmanagement -> Datenübernahme -> ETL/EXCEL-Datenübernahme zu finden. Es ist ebenfalls über die Befehlszeile mit dem Programmkürzel OP81055 oder dem Kürzel "dü" aufzurufen.

Zum Start des Übernahmeprozesses gibt es Pflichtparameter und optionale Angaben, die die Übernahme beeinflussen.

Pfad für EXCEL-Dateien: Beinhaltet den Pfad, in welchem die notwendigen EXCEL-Dateien liegen. Es müssen immer alle vorhanden sein, jedoch kann der Datenbereich in den einzelnen EXCEL-Dateien leer sein, um eine Übernahme auszuschließen.

Pfad für Log-Dateien: In diesem Pfad werden die Log-Dateien pro Übernahmebereich abgelegt.

Prüflauf: Gibt an, ob eine Übernahme „simuliert“ werden soll. Es werden keine physischen Datenoperationen durchgeführt, sondern nur die Daten auf Gültigkeit geprüft. Die Log-Dateien werden bei fehlerhaften Sätzen trotzdem befüllt.

Vor dem Einfügen löschen: Gibt an, ob ein Satz, sofern dessen Schlüssel in der DB-Datei schon vergeben ist, zunächst gelöscht und dann neu eingefügt wird. Falls nicht angehakt und der Schlüssel ist vergeben, wird eine Fehlernachricht in das Log geschrieben.

Datensatz prüfen: Gibt an, ob die Datensätze auf Gültigkeit geprüft werden sollen. In der Regel sollte dieser Parameter immer gesetzt sein, sonst ist die Qualität der Daten gefährdet. Ist der Haken aktiviert, werden alle Prüfungen durchlaufen, die auch bei einer manuellen Eingabe über den Client und den entsprechenden Verwaltungsprogrammen abgearbeitet werden.

Mit der Bestätigung der Maske wird der Übernahmeprozess gestartet. Es besteht die Möglichkeit, ihn interaktiv oder per Jobwarteschlange auszuführen.

Logs zur Datenübernahme

Grundsätzlich gibt es pro Teil- und Anwendungsbereich einen Ordner, der die Logdateien enthält. Die genauen Dateinamen sind den Unterkapiteln der Dokumentation "Verfügbare und vorgefertigte Übernahmeprozesse" zu entnehmen.
Logdateien sind immer nach Fehlern (error) und Hinweisen (hint) kategorisiert. In den Fehlerprotokollen (Dateiname enthält error) sind Datensätze enthalten, die nicht übernommen werden konnten. Die Hinweislogs beinhalten Datensätze, die eingefügt wurden, jedoch eine Nachricht zur Anzeige brachten.
Sowohl bei Fehler- als auch bei Hinweislogs wird der komplette Datensatz in das Log geschrieben, so wie die Daten beim oxaion-Server ankamen. In der Datensatzzeile folgt den eigentlichen Daten die Fehlermeldung bzw. die Hinweismeldung.
Beispiel:

Zur serverseitigen Verfolgung der Übernahme wird im server.log protokolliert, welcher Schritt aktuell ausgeführt wird. Falls der Prozess aus technischen Gründen abbrechen sollte, wird die Ursache ebenfalls im server.log festgehalten. Die relevanten Log-Einträge werden mit „DÜ ETL: " gekennzeichnet.
Beispiel:
DÜ ETL: Starte Job: class standard_datenuebernahme.due_stuecklisten_0_1.DUE_Stuecklisten
DÜ ETL: Starte Job: class standard_datenuebernahme.due_arbeitsplaene_0_1.DUE_Arbeitsplaene
DÜ ETL: Fehler DUE_Arbeitsplaene \\NTSRV\puboxa\Arbeit\Jakob\DÜ_Log3_JJ\papnkp\error_papnkp.csv (Der Prozess kann nicht auf die Datei zugreifen, da sie von einem anderen Prozess verwendet wird)
DÜ ETL: Fehler Komplette_Datenuerbenahme Child job running failed