X4 Produktdokumentation
X4 Produktdokumentation
Breadcrumbs

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.