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:

Schnittstellenformat auf dem lokalen Rechner speichern
Schnittstellenformat auf dem lokalen Rechner speichern

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:

Beispiel: Schnittstellenformat
Beispiel: Schnittstellenformat

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.

Dialog zum Importieren einer dem Schnittstellenformat entsprechenden Datei
Dialog zum Importieren einer dem Schnittstellenformat entsprechenden Datei

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.