IDEV-Online-Hilfe
8.4 Schnittstellenformate
Für einige Statistiken müssen Meldungsdateien erstellt und gesendet werden. Diese Meldungsdateien können über separate Anwendungen erstellt und anschließend zusammen mit einem Online-Formular gesendet werden. Damit diese Dateien in einem systemkonformen Format erstellt werden können, besteht die Möglichkeit, die entsprechenden Schnittstellenformate für ein Formular zu speichern, die Meldedaten in dieses Format einzugeben und das Schnittstellenformat abschließend wieder in ein Formular zu importieren.
Schnittstellenformat speichern
Um Meldedaten in ein Schnittstellenformat einzufügen, muss das entsprechende Schnittstellenformat zuvor lokal gespeichert werden. Nach dem Klick auf Schnittstellenformat speichern erscheint der Dialog Ihres Browsers zum Dateidownload:
Die evtl. im Dialog angezeigten Sicherheitshinweise sind browsertypisch und wurden nicht von der Webapplikation generiert. Zum Speichern der Datei müssen die Anweisungen des Dialogs befolgt werden.
Aufbau Schnittstellenbeschreibung:
Eine Schnittstellenbeschreibung wird als TXT-Datei gespeichert und ist nach folgendem Muster aufgebaut:
Pro Formularfeld wird eine Kurzbeschreibung, ein Variablenname mit nachfolgendem Gleichheitszeichen ("=") und einem Leerraum für den einzusetzenden Wert der Variablen, der durch ein kaufmännisches Und-Zeichen ("&") abgeschlossen wird, verwendet. Die einzelnen Felder sind per Tabulator voneinander getrennt.
Wichtig:
Damit die in dieses Schnittstellenformat eingefügten Meldungsdaten korrekt eingelesen und verarbeitet werden können, müssen folgende Regeln beachtet werden:
Variablennamen dürfen nicht verändert werden.
Gleichheitszeichen ("=") sowie Und-Zeichen ("&") dürfen nicht gelöscht werden.
Die erläuternden Kurzbeschreibungen müssen entfernt werden.
Vor und nach einem Variablenwert dürfen keine Leerzeichen stehen.
Nach dem abschließenden kaufmännischen Und-Zeichen ("&") darf kein Tabulator verwendet werden.
Sonderzeichen müssen unter Verwendung der Regeln des URL-Encoding maskiert werden.
Checkboxen, Radiobuttons oder Auswahlfelder müssen mit den entsprechenden Codes belegt werden.
Handelt es sich bei Feldern um indizierte Substrukturen, werden diese wie folgt indiziert:
Personen#0.Name >>> f1#0.f1
Personen#1.Name >>> f1#1.f1
Der Index beginnt jeweils mit 0. Es ist zusätzlich ein anzahl-Feld #anzahl einzufügen, das die Anzahl der Subsätze enthält, also z.B.
f1#anzahl = n
wobei n für die Anzahl der enthalten Subsätze steht.
Eventuell vorhandene, zur besseren Lesbarkeit eingefügte Leerzeichen sowie Zeilen, die nicht mit Werten gefüllt werden, können entfernt werden.
Schnittstellenformat importieren
Nachdem ein Schnittstellenformat mit den notwendigen Meldedaten versehen wurde, kann es wieder in ein Formular über die Aktion Schnittstellenformat importieren importiert werden.
Im angezeigten Dialog Importieren einer Datei nach dem Schnittstellenformat kann nun die zuvor aufbereitete Datei ausgewählt und geladen werden. Die Daten werden anschließend im Formular angezeigt.