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.

Zum Start des Übernahmeprozesses gibt es Pflichtparameter und optionale Angaben, die die Übernahme beeinflussen, dabei ist es notwendig, sich in der Firma anzumelden für die die Datenübernahme durchgeführt werden soll.

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

Pfade sind aus Sicht des oxaion-Application-Server anzugeben. Bspw. UNC-Pfad oder lokales Verzeichnis auf dem Server.

Logs zur Datenübernahme

Grundsätzlich gibt es pro Teil- und Anwendungsbereich einen Ordner, der die Logdateien enthält. Die genauen Dateinamen sind Verfügbare und vorgefertigte Übernahmeprozesse beschrieben.

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

Feld 1

Feld 2

Feld 3

Feld 4

Feld 5

Fehler/Hinweis

Wert 1

Wert 2

Wert 3

Wert 4

Wert 5

Betreffendes Feld + Meldung

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

Die Logs werden immer mit den Daten des aktuellsten Laufs überschrieben.

Bei den Log-Dateien handelt es sich um .csv Dateien die keinen Zeilenumbruch (bspw. in der Textfeldern) unterstützen, so dass eine Prüfung der Daten bspw. in Excel mühsam ist. Dazu wird empfohlen, mehrzeilige Bezeichnung erst nach Bearbeitung aller möglichen Meldungen zu laden.

Felder

Parameter für die Datenübernahme

FeldbezeichnungErklärung
Pfad der 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.

  • Keine Stichwörter