GDV-VU

Mit diesem Aapter können Daten im GDV Textformat gelesen und konvertiert werden.

Es stehen zwei Möglichkeiten zur Verfügung.

Konvertierung von Dateien im GDV-ASCII-Format in XML-Dateien
Konvertierung von XML-Dateien in Dateien im GDV-ASCII-Format

Zusätzlich können mit dem Adapter die Datumsfelder und die dezimalen Zahlenfelder in der GDV-Datei angepasst werden.

Datumsfelder

GDV-Datumsfelder können 8, 6, 4 oder 2 Zeichen lang sein und werden vom Adapter wie folgt in ein ISO-Datumformat konvertiert:

	GDV-Format	ISO-Format	Beispiel		Hinweis
8	12102022	TT-MM-JJJJ	12102022	12-01-2022	Auch unvollständige Datumsangaben wie 00002008 werden in das entsprechende Format konvertiert 00-00-2008
6	092022	MM-JJJJ	092022	09-2022
4	1022	MM-JJ	1022	10-22022	Auch unvollständige Datumsangaben wie 0000 werden in das entsprechende Format konvertiert 00-00
2	14	TT	14	14

Hinweis

Bei der Konvertierung von XML ins GDV-Format werden die Zahlen an die Länge des GDV-Feldes angepasst. Ist ein Feld im XML-Format kürzer als die für das GDV-Feld definierte Länge, dann werden die Zahlen mit vorangestellten Leerzeichen ergänzt.

Dezimale Zahlenfelder

Dezimale GDV-Zahlenfelder bestehen aus der Länge der Gesamtzahl und der Anzahl der Dezimalstellen. Dies heißt zum Beispiel, dass bei der Konvertierung ins XML-Format ein Zahlenfeld mit der Länge „4“ und zwei Nachkommastellen zu 54,34 wird.

Anzahl der Dezimalstellen	GDV-Inhalt	Konvertierter Wert
4, 3	1000	1.000
6, 5	001000	0.01000
4, 2	1200	12.00
1, 0	1	1
2, 0	01	1
4, 0	1234	1234
7, 7	1234567	0.1234567

Hinweis:

Bei der Konvertierung von XML ins GDV-Format werden die Daten im ISO-Format an die Länge des GDV-Feldes angepasst. Ist das Datum im ISO-Format länger als das GDV-Feld, dann wird das Datum gekürzt. Wird zum Beispiel ein ISO-Datum 2022-03-24 in ein GDV-Feld mit einer Länge von 4 Zeichen konvertiert, wird ein Datum 0322 eingefügt und die Tage des Originalformats ignoriert.

Eigenschaften (Properties)

Operation

Bestimmt, welche Operation der Adapter durchführt

Mögliche Werte:

GDV to XML: Konvertiert die GDV Daten in ein XML-Format.
XML to GDV: Konvertiert die XML Daten in ein GDV-Format.
Get supported sets: Zeigt alle verfügbaren “Sets” des ausgewählten GDV-Formats an.

Parameter

formattedXmlValues

Definiert die Formatierung der Datums- und Zahlenfelder beim Import/Export

Mögliche Werte

Active: Alle GDV Nummern und Datumfelder werden wie beschrieben angepasst. GDV_Datum wird in ein ISO-Datum umgewandelt. GDV-NumFeld wird in eine Integer- oder Dezimalzahl wie im Datentyp definiert umgewandelt.
Inactive: Daten im Zieldokument werden wie im Ausgangsdokument übernommen, das heißt, dass die Daten im XML-Dokument bereits im GDV-Format sein müssen.

trimXmlValues

Definiert, ob Leerstellen vor oder nach dem Ausgabewert gelöscht werden. Welche Leerzeichen gelöscht werden hängt vom „Alignment“ ab. Dieses gilt nicht, wenn eine XML-Datei importiert wird.

Mögliche Werte:

Active: Leerstellen bei den Ausgabewerten werden gelöscht. Das Löschen der Leerstellen ist abhängig von der eingestellten Ausrichtung (Alignment) – dies heißt, dass nur solche Leerstellen gelöscht werden, die auf der nicht definierten Seite (unaligned) stehen.
Inactive: Die Leerzeichen werden in der Ausgabedatei belassen.

createHeaderFooter

Definiert, ob in der Ausgabedatei eine Kopf – und Fußzeile mit den Werten <Vorsatz> und <Nachsatz> angelegt wird.

Mögliche Werte:

Active: “Vorsatz” und “Nachsatz” wird in der XML oder GDV Datei angelegt
Inactive: Die Elemente “Vorsatz” und “Nachsatz” werden nicht in der XML oder GDV-Datei angelegt.

gdvVersion

Definiert mit welcher GDV-Version die Daten importiert/exportiert werden. Zeigt die gewählte GDV-Version an

Mögliche Werte:

2009 – GDV-Version 2009
2013 – GDV-Version 2013
2015 – GDV-Version 2015
2018 – GDV-Version 2018

Statuswerte

`1`	Die Operation wurde erfolgreich ausgeführt.
`-1`	Die Operation ist aufgrund eines technischen Fehlers fehlgeschlagen.

Output

Abhängig von der gewählten Adapter-Operation wird ein XML-Dokument oder ein GDV-Dokument ausgegeben.

Bei der Operation XML to GDV wird bei korrekten Eingabedaten eine GDV-Datei erzeugt.

Wenn die Eingabedaten inkorrekt sind, wird eine XML-Datei mit Fehlern ausgegeben.