OmniBelegService:CSV2XMLConverterKonfiguration

Vorwort

Um zur Konfiguration zu gelangen muss man einmal zu dem Installations-Ordner navigieren (Standard-Pfad: C:\Program Files (x86)\OmniSeller\Shared\HTK.Omni.CSV2XML.Converter) und dort dann die "HTK.Omni.CSV2XML.Konfiguration.exe" öffnen.

Um Daten in der Konfiguration speichern zu können muss der Dienst beendet sein. Änderungen werden sowieso nur beim Neustart des Dienstes registriert.

Hauptfenster

Sobald man die Konfiguration startet öffnet sich folgendes Fenster:

obere Leiste

Das Menü oben hat einige Buttons die entsprechende Aktionen auslösen oder Funktionen aufrufen.

Speichern

In diesem Bereich können Änderungen gespeichert bzw. verworfen werden oder ein neues Convert-Format angelegt werden.

FeldMapping

Hier öffnet sich der Dialog für die FeldMappings. Weitere Informationen dazu weiter unten.

Email-Einstellungen

Hier kann eine Email-Konfiguration eingestellt werden.

Sollte beim Konvertieren ein Fehler auftreten und eine Datei nicht verarbeitet werden können werden die dort aufgeführten Adressaten per Email benachrichtigt.

Convert-Formate

auf der linken Seite befindet sich eine Liste mit den existierenden Convert-Formaten. Hier kann das entsprechende Format ausgewählt und bearbeitet werden.

Konfiguration

Nachdem das entsprechende Convert-Format ausgewählt wurde kann dieses nun konfiguriert werden. Es folgen nun die Konfigurations-Einstellungen

Allgemein

Bezeichnung	Beschreibung und Werte
Aktiv	steuert, ob von diesem Convert-Format Dateien eingelesen werden sollen oder nicht
ID	interne ID des Dienstes, kann nicht verändert werden
Name	Name des Convert-Formats. Dieser sollte sprechend gewählt sein und dieser wird im Fehler-Fall auch in der Email genannt falls diese Funktion aktiviert ist

Pfade

Bezeichnung	Beschreibung und Werte
CSV Einlesepfad	gibt den Pfad an, an dem der Dienst schauen soll ob neue Dateien bereit liegen
CSV Fehlerpfad	gibt den Pfad an, an den der Dienst die Dateien verschiebt, sollte es zu deinem technischen Fehler während der Konvertierung kommen
CSV Archivpfad	gibt den Pfad an, an den der Dienst die Dateien verschiebt, sollten diese erfolgreich verarbeitet worden sein
XML Ausgabepfad	gibt den Pfad an, an denen die generierten XML-Dateien gespeichert werden sollen

Datei Einstellung

Bezeichnung	Beschreibung und Werte
XML Datenstruktur	Wert "XMLOrder"; kann nicht verändert werden; gegebenenfalls mal für später gedacht falls andere Formate folgen werden.
File Delimiter	das Zeichen, welches die einzelnen Datensätze voneinander trennt
File Endung	Die Datei-Endung der einzulesenen Dateien. Schreibweise .[DateiEndung]; z.B. ".csv"
Header Zeilen	Anzahl der Zeilen, die als Header-Zeilen gelten und für diese keine Datei erstellt werden soll. Es darf nur eine Zahl eingetragen werden.

Feld-Mappings

Drückt man oben in dem Reiter den Button "FeldMappings für ausgewähltes Format öffnen" öffnet sich folgender Dialog:

Hier hat man die Möglichkeit, einzelne Spalten der CSV-Datei dann auf ein entsprechendes Feld der XML-Datei zu mappen. Es wurde versucht, die Felder entsprechend sauber zu gruppieren und zu benennen.

Eine genauere Format-Beschreibung des HTK OpenTrans XML-Formates finden Sie hier.

Die FeldMappings können exportiert bzw. importiert werden zur Datensicherung. In dem Installations-Ordner existiert ein "Export" Ordner, in dem dann die Datei "Export_<formatName>.csv2xml" exportiert wird.

Nach einem Import der FeldMappings muss dann noch einmal gespeichert werden.

Hinweis: Bei den FeldMappings muss aktuell die entsprechende Spaltennummer der CSV-Datei eingetragen werden. Die erste Spalte hat den Wert 0 statt 1 !

In einem kommenden Release ist aber eine Umsetzung der Excel Spaltenüberschriften mit Buchstaben angedacht.