XBau-Standard
Die Historie von XBau
IT-Planungsrat
Entscheidung 2017/37 - Standardisierungsagenda: Austausch im Bau- und Planungsbereich
"... Unter Bezug auf § 1 Absatz 1 Satz 1 Nummer 2 des Vertrags über die Errichtung des IT-Planungsrats und über die Grundlagen der Zusammenarbeit beim Einsatz der Informationstechnologie in den Verwaltungen von Bund und Ländern (IT-Staatsvertrag) beschließt der IT-Planungsrat die verbindliche Anwendung der Standards XBau und XPlanung für den Bedarf "Austauschstandards im Bau- und Planungsbereich".
Für IT-Verfahren, die dem Datenaustausch im Gegenstandsbereich der genannten Bedarfsbeschreibung dienen, werden folgende Fristen für die Konformität festgelegt:
- mit Beschlussfassung - für IT-Verfahren, die neu implementiert oder in wesentlichem Umfang überarbeitet werden,
- maximal fünf Jahre nach Beschlussfassung für andere IT-Verfahren.
Das Ziel von XBau
Die XBau-Leitstelle und die Gremien
● XLeitstelle übernimmt für XBau und XPlanung folgende Aufgaben:
-Bereitstellung und Grundbetrieb
-Release-Management
-Änderungsmanagement
-Support und Öffentlichkeitsarbeit
● Auftraggeber und Finanzierung auf Grundlage eines Beschlusses des IT-Planungsrates
● Fachliche Gremien zur Weiterentwicklung der Standards sind
-Expertengremium XBau
-Expertengremium (AG Modellierung) XPlanung
-ggf. werden zu einzelnen fachlichen Themen Unterarbeitsgruppen gebildet
● Website: https://xleitstelle.de/
● In Planung: Web-Zugriff zur Einsichtnahme in aktuelle CRs (in den nächsten Monaten)
● Standard zum Bauen wurde mit Version 2.3 in Kernstandard und Fachmodule aufgeteilt
XBau im Kontext des XöV-Frameworks
● XÖV-Standards sind Spezifikationen zum Datenaustausch in der öffentlichen Verwaltung
● technischer und organisatorischer Rahmen wird durch das XöV-Handbuch festgelegt
● Es gibt noch begleitende Dokumente wie Codelisten-Handbuch
● XöV-Rahmen definiert “Leitplanken”
-Struktur und Vorgehensweise bei Erstellung und Weiterentwicklung
-Nutzung der XöV-Bibliothek
-Technische Festlegungen wie UML-basierte Entwicklung und Pflege, Nutzung des XGenerator-Frameworks
-Basisdatentypen, grundsätzlicher Nachrichtenaufbau, Ausführung von Codelisten
-Zeichensatz-Codierung
● Veröffentlichung von XöV-Standards (auch XBau) erfolgt im XRepository (https://xrepository.de)
● Bestandteile des Standards sind über URNs (Uniform Resource Name) referenziert, z.B. urn:xoev-de:bmk:standard:xbau (Hinweis: XBau - Fachmodul Hochbau - diesen URN gab es schon vor der Trennung in Kernstandard- und Fachmodule)
● Konkrete Versionen werden über Versionskennung wie urn:xoev-de:bmk:standard:xbau_2.3 referenziert
● Hier liegen neben den Endfassungen auch Entwurfsversionen
● Einige Beispiele der Informationen im XRepository
Grundsätzliche Anatomie einer XBau-Nachricht
Basisnachrichtenstruktur: urn:xoev-de:kosit:standard:xinneres.basismodul
baugenehmigung.antrag.0200 |
Nachrichtenkopf (G2G, identifikation, leser, autor) |
Fachdaten (referenzAntragsservice, antragsteller, prozessmerkmale, bauvorhaben, beantragteAbweichung*, baulast*…) |
Anlagen* (Anlage: bezeichnung, primaerDokument, datum, versionsnummer, mimeType, dateinameAnhang, …) |
Wesentliche Datentypen
● Spezifikation XBau-Kernmodul
-Nachrichtenstruktur G2G (Behörde zu Behörde-Kommunikation)
- Struktur für Nachrichtenkopf (Identifikation, Leser, Autor → siehe XTA2/OSCI)
- Struktur zur Nachrichtenidentifikation
- Rückweisungsnachricht zur Fehlersignalisierung
- Übergreifende Prozessnachrichten
- Basisdatentypen Text, TextFormatiert, Decimal.XBau (zwei Nachkommastellen)
- Anlagen (Metadaten, Strukturen)
- Namen und Organisationen
- Übergreifende Codelisten
- Datentypen für Flurstück, Geobezug
● Hinweis zu TextFormatiert
- HTML5-Subset (!)
- “Flow Content" im Sinne der HTML5-Spezifikation (https://html.spec.whatwg.org/multipage/dom.html#flow-content-2)
- textOffice ist optional und muss inhaltsgleich sein
● Spezifikation XBau-Fachmodul Hochbau, u.a.
- Fach- und Prozessnachrichten für Hochbau für die einzelnen Verfahren
- Bauvorhaben
- Baubeschreibung
- Baustatistik
- Baulasten
- Angaben zum Verfahren
- Codelisten zum Hochbau
● Beide Schemata (Kerndatentypen und Hochbau) ergänzen sich
● Aufgrund der externen Referenzen die im Standard bereitgestellten Schemata im xsd_dev verwenden, hier sind die externen Referenzen (z.B. zu den OGC-Standards) aufgelöst und teilweise korrigiert.
● Die referenzierten Code-Listen werden ebenfalls bereitgestellt.
Codelisten in XBau
●In XBau werden drei Arten von XöV-Codelisten verwendet
- Typ 1: Der XBau-Standard bestimmt die Kennung und die Version der zu nutzenden Codeliste. Die Codeliste wird als XML-Enumeration in die XML Schema-Definitionen des Standards aufgenommen.
- Typ 3: Der XBau-Standard bestimmt die Kennung der zu nutzenden Codeliste. Die Version der wird erst bei der Nachrichtenübermittlung festgelegt. Die Code-Liste wird im XRepository publiziert. Dieser Ansatz ermöglicht die Nutzung von "dynamischen" Codelisten, zu denen häufig neue Versionen veröffentlicht werden. Beispiel hierfür ist die Code-Liste urn:xoev-de:xbau:codeliste:anlagen
- Typ 4: die grundsätzliche Nutzung einer Codeliste ist im XBau-Standard vorgesehen, die konkret zu nutzende Codeliste aber (noch) nicht in der Spezifikation des Standards benannt werden kann. Hierzu finden sich aber Default-Listen im XRepository. Solche Listen sind z.B. länderspezifische Listen wie urn:xoev-de:xbau:by:codeliste:verfahrensart
● Details zu Code-Listen finden sich hier: https://www.xoev.de/xoev/xoev-produkte/codelisten-handbuch-18762
Binäre Anlagen
● Binäre Anlagen (wie PDF-Dokumente) stellen einen wesentlichen Teil der fachlichen Kommunikation dar, z.B. die Übermittlung von Bauzeichnungen.
● Die Codeliste urn:xoev-de:xbau:codeliste:xbau-mimetypes ist eine Typ 4-Codeliste (siehe später) und ist der Default der unterstützten Dateitypen (aktuell PDF und BIM-Formate)
● Diese Code-Liste kann in Abstimmung mit den Kommunikationspartnern angepasst werden, für das EfA-Szenario wird der Standard genutzt.
● Es sind in XBau-Kernmodul unterschiedliche Verfahren für den Transport von Anlagen (in XBau auch Primärdokumente bezeichnet) vorgesehen
- Transport mit der Nachricht als Anhang
- Verlinkung auf einen externen Datenbestand
● Anlagen als Anhang
- Anlagen werden mit der Nachricht versendet
- In XBau eingebettet (bis Version 2.2 möglich) oder ab Version 2.3 parallel der XML-Nachricht aber im gleichen Nachrichten-Container übertragen.
● Anlagen als Referenz
- Der Link identifiziert die Anlage (Primärdokument) in einem Quellsystem (das sich in Kontrolle der Behörde (!) befindet) eindeutig.
- Sinnvoll für Nachrichten, die innerhalb einer Behörde versendet werden, um eine Dopplung von Daten zu vermeiden.
- Darf aber explizit nicht für Antrags- bzw. Anzeigenachrichten verwendet werden.
- Wird im EfA-Bauen-Kontext nicht verwendet!
Metadaten für Anlagen
● Anlagearten definieren, um was es sich bei einer Anlage handelt.
● Hilft bei großen Bauvorhaben, eine inhaltliche Struktur bereitzustellen
● Die Auswertung der Metadaten und die Darstellung obliegt der technischen Implementierung
● Code-Liste urn:xoev-de: xbau:codeliste:anlagen sieht Kategorien (volle hunderter) und konkrete Dokumentarten (z.B. Nachweis über die Einhaltung der Grundrissfläche und Höhenlage) vor
● Ist ab XBau Version 2.3 eine Typ 4-Codeliste
● Im Rahmen von EfA-Bauen wird die im XRepository veröffentlichte Code-Liste verwendet.
● Code 9999 → Weitere, nicht näher spezifizierte Anlage. Sollte aber nur in Ausnahmen verwendet werden.
Die DIN SPEC 91379
DIN SPEC 91379 „Zeichen in Unicode für die elektronische Verarbeitung von Namen und den Datenaustausch in Europa; mit digitalem Anhang“
Die Entscheidung 2019/53 des IT-Planungsrates legt fest:
In Ergänzung seiner Entscheidung 2019/16 legt der IT-Planungsrat fest, dass alle IT-Verfahren, die dem Bund-Länder übergreifenden Datenaustausch oder dem Datenaustausch mit Bürgern und Wirtschaft dienen, spätestens zum 1. November 2024 konform zur DIN SPEC 91379 sein müssen.
→ neuer Datentyp in XBau 2.3: dinspec91379:datatypeC (definiert in der XöV-Bibliothek)
→ Tests der einzelnen Verfahren notwendig, ob die Verarbeitung aller dieser Unicode-Zeichen klappt
→ neue XöV-Basisschemata ab XBau 2.3 integriert (KoSIT-Latinchars v1.2.1)
Überblick über die Prozesse
● In XöV-Standards werden nicht nur Nachrichtenstrukturen sondern auch Nachrichtensequenzen definiert.
● XBau 2.3 adressiert folgende fachlichen Abläufe
- Bauberatung
- Akteneinsicht
- Baugenehmigungsverfahren
- Vorbescheidverfahren
- Abweichungsverfahren
- Teilbaugenehmigung
- Antragsverfahren Grundstücksteilung
- Abgeschlossenheitsbescheinigung
- Benachrichtigung von Informationsempfängern
- Prüfung bautechnischer Nachweise
- Genehmigungsfreistellung
- Baulastenverfahren
- Überwachungspflichtige Anlagen
- Anzeigen
- Anzeige des Bauzustands
- Abfrage beim Verzeichnis der Kammern
●Anhang “IV.B Übersicht über alle Nachrichten” des XBau-Standards führt eine Tabelle mit allen enthaltenen Nachrichten und einer Kurzbeschreibung auf.
Beispiele: Die wichtigsten XBau-Nachrichten im Prozesskontext
Prozessnachrichten
● Prozessnachrichten sind XBau-Nachrichten, die zwar im Kontext eines Prozesses, aber nicht an einer bestimmten Stelle im Ablauf und ggf. mehrfach ausgetauscht werden können.
● Mit Prozessnachrichten können z.B. Änderungen durch das Fachverfahren an eine Plattform gesendet werden (prozessnachrichten.aenderungProjektraumdaten.0100)
● Fachübergreifende Prozessnachrichten aus dem Kernmodul sind
- Rückweisung (Fehlernachricht)
- Eingangsbestätigung
- Aktenzeichen
- Rücknahme (eines Antrags, eine Behördenbeteiligung)
- Befundliste formelle Prüfung
- Zustellung Schreiben (Schreiben von Bauaufsicht an Antragstellung)
- Fachliche Kommunikation (Nachricht an Bauaufsicht von Antragstellung)
- Einstellung Dokumente (Übermittlung von Dokumente an einen Projektraum)
Fehlersignalisierung in XBau 2.x
● Fehlersignalisierung gibt es auf mehreren Ebenen
- Netzwerkebene (TCP-Layer, z.B. Connect Timeout)
- http-Protokollebene bzw. TLS-Fehler
- XTA2-Webservices (SOAP-Faults) bzw. OSCI-Protokollfehler
- XBau-Nachrichtenebene (Rückweisungsnachrichten)
● Auf XBau-Nachrichtenebene signalisiert der Leser Fehler mit der Nachricht 1100 dem Autor der Ursprungsnachricht zurück
● Adressierung erfolgt über DVDV oder Postfachname (siehe XTA2)
● Fehlerstufe I
- die Nachricht verstößt gegen die Regeln der XBau-Spezifikation (Schemaverstöße oder Regelverstöße, die nicht im Schema abgebildet sind, wie z.B. Codelisten-Bezeichner oder Code-Bezeichner, die im Standard oder in referenzierten Codelisten nicht vorgesehen sind)
● Fehlerstufe II
- sind dagegen solche Fehler, die erst beim Abgleich der Daten der Nachrichteninstanz mit dem eigenen Datenbestand bzw. Prozesskontext auffallen. Es handelt sich also um Verstöße, die im Zusammenhang der fachlichen Plausibilisierung der empfangenen Daten auftreten.
- Mögliche Fehlercodes: siehe urn:xoev-de:xbau:codeliste:xbau-fehlerkennzahlen_2.1
Beispiele für Fehler auf XBau-Nachrichtenebene
Ressourcen zu XBau 2.x:
XLeitstelle: https://xleitstelle.de
XRepository: https://www.xrepository.de/suche
XöV-Standards: https://www.xoev.de/
Infos zur DIN SPEC 91379: https://www.xoev.de/string-latin-4813