OmniBelegService:CSV2XMLConverterKonfiguration: Unterschied zwischen den Versionen

VisuellWikitext

@@ Zeile 1: / Zeile 1: @@
-folgt
+{{DISPLAYTITLE:CSV2XMLConverter - Konfiguration}}
+== 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:
+[[Datei:CSV2XMLConverter config Mainform.png|rahmenlos|880x880px]]
+=== 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.
+[[Datei:CSV2XMLConverter config EmailForm.png|rahmenlos|673x673px]]
+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 ====
+{| class="wikitable"
+|+
+!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 ====
+{| class="wikitable"
+!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 ====
+{| class="wikitable"
+!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:
+[[Datei:CSV2XMLConverter config FeldMappingForm.png|rahmenlos|1067x1067px]]
+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 [[OmniBelegService:XMLFormatbeschreibung|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.