Das Formularschema des OZG-Hubs ist die technische Grundlage aller digitalen Antragsformulare, die auf dem Behördenserviceportal, service-bw und Amt24 erstellt und betrieben werden.
Als Open-Source-Projekt auf openCode steht das Schema allen Interessierten zur Verfügung: frei nutzbar, offen lizenziert und technologieunabhängig. Es leistet damit einen wichtigen Beitrag zur digitalen Souveränität und föderalen Zusammenarbeit in der Verwaltungsdigitalisierung.
Zugang zum Formularschema auf openCode
Auf openCode finden Sie alles, was zur Nutzung und Weiterentwicklung des Formularschemas benötigt wird:
- Repository mit aktuellen Schema-Dateien, Versionsverlauf und Changelog
- Issue-Tracker zur Meldung von Fehlern und Verbesserungsvorschlägen
- Diskussionsforum für den Austausch mit anderen Anwendern
Das Formularschema lebt von der aktiven Beteiligung seiner Community und der gemeinsamen Weiterentwicklung. Es richtet sich an Entwickler und Online-Dienste-Hersteller, die bestehende Formulare verbessern oder das Schema erweitern möchten.
Was ist das Formularschema?
Das Formularschema ist ein JSON-Schema, das die Erstellung digitaler Formulare im JSON-Standard durch automatische Vervollständigung und Konformitätsprüfung unterstützt.
Es beschreibt den Aufbau und die Struktur von Formular-JSON-Dateien: welche Bausteine ein digitales Formular enthalten darf, wie diese angeordnet werden und wie sie zusammenspielen. Auf dieser Grundlage entstehen einheitlich strukturierte Online-Formulare und eine konsistente, valide Datenerhebung.
Aufbau eines Formular-JSONs
Die Struktur eines Formulars ist hierarchisch aufgebaut: Abschnitte bilden die oberste Ebene, darunter folgen Feldgruppen, Zeilen und Formularmodule. Detaillierte Informationen zum Aufbau finden Sie in der Dokumentation für Online-Dienste-Hersteller (zugangsbeschränkt) oder den Serviceportale-Guidelines.
Nutzen & Vorteile des Formularschemas
- Standardkonforme Formularerstellung: Durch die Nutzung des offenen JSON-Standards sind die Formulardateien interoperabel und unabhängig von einer spezifischen Plattform nachnutzbar.
- Auto-Vervollständigung: In kompatiblen Entwicklungsumgebungen werden zulässige Felder, Eigenschaften und Werte direkt vorgeschlagen.
- Automatische Konformitätsprüfung: Formular-JSONs lassen sich gegen das Schema prüfen, wodurch Fehler in der Struktur oder bei einzelnen Modul-Konfigurationen frühzeitig erkannt werden.
- Einbindung externer Bezugsquellen: Das Schema erlaubt die Integration externer Datenquellen sowie das Festlegen von Vertrauensniveaus für datenschutz- und sicherheitsrelevante Anwendungsfälle.
- Unterstützung der Frontend-Entwicklung: Die konkrete Darstellung im Frontend gibt das Schema nicht vor, denkt sie aber konsequent mit – etwa durch Sichtbarkeitsbedingungen oder Validierungsmeldungen.
Zusammenhang mit dem Formulardesigner
Das Formularschema und der Formulardesigner des OZG-Hubs gehören untrennbar zusammen: Das Schema bildet die technische Grundlage; der Formulardesigner die grafische Oberfläche, mit der Sie schnell und einfach Formulare gestalten können. Das Formular-JSON muss so nicht selbst geschrieben werden.