2020-22 DVDV-Dienste

XBAU-81
  • 2.2
Geprüft
Mi., 10.08.2022 - 14:57
Fertig
Mo., 05.10.2020 - 14:50
priority-icon Medium
  • Infrastruktur & Technik

Im Rahmen der Vorbereitung der DVDV-basierten Nachrichtenkommunikation ist ein DVDV-Eintragungskonzept erarbeitet worden.

OZG-Portale der Länder, die kommunalen Bauaufsichtsbehörden, die amtliche Statistik und weitere Behörden werden in das DVDV einzutragen – zusammen mit den Web Services, die sie über entsprechende IT-Dienstleister für den XBau-Nachrichtenaustausch anbieten.

Diese Dienste (Web Service Kommunikation via SOAP / WSDL) sind im Anhang F der XBau-Spezifikation zu benennen. Die entsprechenden WSDL-Dateien sind als Anlagen mit der XBau-Spezifikation auszuliefern.

Kommentare

YR, Dataport am: 2020-05-20

Namespace für WSDL

Als Namespace für die WSDL-Dateien wurde mit Hrn. Leuner abgestimmt:

 ** 

Textdoku Nachricht 0603

Im Zuge der Nachrichtenanalyse für die DVDV ist folgender Anpassungsbedarf aufgefallen:  

Textdoku IST zur Nachricht 0603:

  • Diese Nachricht unterrichtet die Bauaufsichtsbehörde über das Ergebnis der Prüfung, das dem Bauherrn von der Gemeinde übermittelt wurde

Textdoku SOLL zur Nachricht 0603:

  • "Mit dieser Nachricht informiert die Gemeinde die Bauaufsichtsbehörde über das Ergebnis der Prüfung. Mit der Nachricht 0602 hat die Gemeinde auch den Bauherrn benachrichtigt."

 

RTS-Nachrichten 1101 / 1102

Die Nachrichten 1101 und 1102 haben in der XBau-Spezifikation keine Verwendung

  • Sie sollen entfernt werden.
  • Die dazugehörigen Nachrichtenköpfe (Nachrichtenkopf.privat2G und Nachrichtenkopf.G2privat) können vorerst im Modell bleiben. Sie werden aus dem Spezifikationsdokument entfernt.

 

OSCI-Transportprofil

Es ist zu prüfen, ob ein OSCI-Transportprofil in die XBau-Spezifikation eingefügt werden soll.

Falls ja, sollte dieses mit Anpassungen von XInneres übernommen (z.B. Text Ref.-ID „XINNERES_DATA“ muss durch „XBAU_DATA“ ersetzt werden).

CP am: 2020-06-19

Die Dienste wurden in die Spezifikation eingearbeitet.

Der Dokutext zu Nachricht 0603 wurde angepasst (im veröffentlichten pdf noch nicht sichtbar).

Nachrichten 1101 und 1102 wurden entfernt.

QS durch XLeitstelle am: 2020-06-19

Der Namespace in der Spezifikation stimmt nicht mit dem am 20.05.2020 abgestimmten überein. Abgestimmt war: http://www.xleitstelle.de/xbau/schema/2/2/wsdl/

CP: Welche Vereinbarung bezieht er sich? Warum ist hier stattdessen der Namespace http://www.xleitstelle.de/xbau/2/2 gesetzt? Wie lässt sich das kurz begründen?

Ebenfalls stimmen die Dienstebezeichnungen in der Spezifikation nicht mit denen im DVDV Eintragungskonzept vorgegebenen Bezeichnungen überein. Vorgegeben war das Muster: XBau22-XYZ-AA2BB, wobei XYZ das Kürzel des jeweiligen Verfahrens darstellt, AA das Kürzel des Senders und BB das des Empfängers.

Beispiel: XBau-BGV-BAB2BH für die Kommunikation der Bauaufsichtsbehörde (BAB) zu Bauherr (BH) im Baugenehmigungsverfahren (BGV).
Hierbei sind Groß-/Kleinschreibung und Bindestriche zu beachten.

CP: Erledigt.

In der Spezifikation fehlen die WSDL-Dateien für die Abfrage beim Verzeichnis der Kammern (Kap. III.13). Die Dienstebezeichnungen hierfür liegen ja bereits vor:

bauvorlageberechtigung.anfrage.0930 ->           XBau22-ABV-BAB2AK                http://www.xleitstelle.de/xbau/schema/2/2/wsdl/XBau22-ABV-BAB2AK.wsdl

bauvorlageberechtigung.auskunft.0931 ->         XBau22-ABV-AK2BAB                http://www.xleitstelle.de/xbau/schema/2/2/wsdl/XBau22-ABV-AK2BAB.wsdl

CP: Sie sind nicht in der Spezifikation vorhanden, weil sie nicht im Eintragungskonzept (und auch nicht DVDV-Excel-Liste enthalten sind/waren). Woher stammen diese beiden WSDL-Dateien?

QS durch XLeitstelle am: 2020-10-06

Aus der QS vom 2020-06-19:

Der Namespace in der Spezifikation stimmt nicht mit dem am 20.05.2020 abgestimmten überein. Abgestimmt war: http://www.xleitstelle.de/xbau/schema/2/2/wsdl/

CP: Welche Vereinbarung bezieht er sich? Warum ist hier stattdessen der Namespace http://www.xleitstelle.de/xbau/2/2 gesetzt?

Wie lässt sich das kurz begründen?-> siehe in diesem CR-Dokument: Bearbeitet durch Schlüter/Rabenstein 20.05.2020

 

In der bis zur XBau Spezifikation 2.2 vom Januar 2020 ist sowohl in den XSD- als auch in den WSDL-Dateien stets der Namespace:

http(s)://www.leitstelle.de/xbau/schema/2/1  bzw.
http(s)://www.leitstelle.de/xbau/schema/2/2  verwendet worden.

Und auf der Webseite der xLeitstelle sind die Schemadateien beispielsweise so erreichbar:

https://xleitstelle.de/xbau/schema/2/2/xbau-basisdatentypen.xsd
https://xleitstelle.de/xbau/schema/2/2/xbau-codes.xsd

Entscheidend ist, dass die Schema- und WSDL-Dateien unter einer solchen Adresse (also mit /schema/) erreichbar sind. Wenn dies auch mit dem Namespace https://xleitstelle.de/xbau/2/2 funktioniert, ist alles o.k.

QS durch XLeitstelle am: 2020-11-02

Die geforderte Funktionalität:

  • Entscheidend ist, dass die Schema- und WSDL-Dateien unter einer solchen Adresse (also mit /schema/) erreichbar sind. Wenn dies auch mit dem Namespace https://xleitstelle.de/xbau/2/2 funktioniert, ist alles o.k.

wurde mir von YR/CP mündlich mehrfach zugesichert.

Insofern ist jetzt der Status geprüft