ITEBO: Nutzung des Datentyps "anwendungsspezifischeErweiterung"

XBAU-252
  • K 1.2
  • 2.3.1
Geprüft
Do., 27.04.2023 - 12:57
Fertig
Mi., 10.08.2022 - 13:51
priority-icon Medium
  • Spezifikation

Wir sind gerade in der Planung für die Ablösung der KIND-Schnittstelle durch XBau2. Hierzu hatten wir ja zusammen mit Prosoz und cit einige Nachrichten eingebracht, die dann auch in der Version 2.3 umgesetzt wurden. Unter anderem war dort auch der Datentyp „BezugErweitert", in dem der „apiKey" und die „anwendungsspezifischeErweiterung" als Kindelemente dabei.

Allerdings ist dieser neue der Datentyp nur in den Nachrichten 0201, 0203, 0205 und 0206 vorhanden. Das reicht nicht aus.

Kommentare

Antragsteller am 16.08.2022:

In der Nachricht 0100 wird als weiteres Kindelelement der Datentyp BeteiligteBauprojekt benötigt, um während eines Verfahrens neben Antragsteller und Entwurfsverfasser auch diverse weitere Beteiligte in Projekträume einladen/hinzufügen zu können. Aktuell wäre dies aufgrund des fehlenden Elements nur für Antragsteller und Entwurfsverfasser möglich.

EG22-03 19.09.2022

Bemerkungen:  

  • wird für alle Nachrichten benötigt, die von und an eine Webplattformen (Kollaborationsplattform) kommuniziert werden können

Bewertung:

  • Änderung bestehender Funktionalität 
  • Meinungsbild EG: es werden keine Risiken gesehen
  • Aufwand für EG: niedrig
  • Aufwand Umsetzung im Standard: niedrig

Status Umsetzung

In allen Nachrichten, die von und an eine Webplattform kommuniziert werden können (mit der Außnahme von Nachrichten 0410, 0411,0412, 0413 und 0414), ist die Erweiterung des Elementes bezug vom Datentyp BezugErweitert verfügbar.

QS durch XLeitstelle am 28.10.2022

Kein Befund.

Status = geprüft

QS durch Antragsteller am 03.11.2022

Beim „bezugerweitert“ habe ich gesehen, dass nun alle Nachrichten aus der Spezifikation Hochbau aufgelistet sind.

Wie verhält es sich allerdings mit den Nachrichten aus dem Kernmodul? Konkret werden wir daraus die Nachrichten 1141 und 1142 verwenden, um Informationen mit unserer Plattform austauschen zu können. Auch für diese Nachrichten ist der „bezugerweitert“ relevant, weil darüber ja grundsätzlich von der Plattform benötigte Informationen mitgegeben werden sollen. Habe ich das übersehen oder fehlt die Information hier noch, damit der „bezugerweitert“ auch bei diesen Nachrichten verwendet werden kann?

Das wäre für uns sehr wichtig, damit wir die Schnittstelle unserer aktuellen Lösung durch XBau2 ablösen und unser Kunden dann umstellen können.

Status zurück auf Umsetzung

Die Umsetzung des CRs wurde vervollständigt.

Änderungen im Kernmodul

  • Auch die Nachrichten des Kernmoduls wurden jetzt mit dem Typ BezugErweitert ausgestattet.
  • Es wurde der neue Datentyp AnbindungFachverfahren definiert, der zwei der Elemente separat
    anwendbar macht, die bisher nur im Typ xbau:BezugErweitert verfügbar waren (Elemente apiKey und anwendungsspezifischeErweiterung).
  • Dieser wurde zu den Nachrichten des Kernmoduls hinzugefügt, die bisher weder den Typ Bezug noch den Typ BezugErweitert enthielten.

Änderungen im Fachmodul XBau-Hochbau:

  • Alle Nachrichten, die im Zusammenhang von Antrags- oder Kollaborationsplattformen kommuniziert
    werden (das sind alle Nachrichten mit Ausnahme von 0410, 0411, 0412, 0413 und 0414) verfügen
    jetzt über das Objekt anbindungFachverfahren vom Datentyp xbauk:AnbindungFachverfahren des XBau-Kernmoduls
  • Dadurch sind die darin enthaltenen Elemente jetzt auch in Nachrichten anwendbar, die nicht über den Datentyp Bezug bzw. BezugErweitert verfügen.

Status erledigt

QS-Ergebnisse:

  • in allen Nachrichten muss die Reihenfolge der Basiselemente überprüft werden, besonders im Hinblick auf die Elemente bezug, referenzAntragsservice, antragsteller, prozessmerkmale, anbindungFachververfahren. Diese Reihenfolge sollte weiterhin möglichst einheitlich über alle Nachrichten sein
  • das Element anbindungFachververfahren muss immer optional eingefügt sein (in Nachricht 0930 mandatorisch z.B. ist es mandatorisch, das darf nicht sein)

Status Umsetzung

  • die Reihenfolge der Elemente wurde überprüft.
  • das Element 'anbindungFachverfahren' ist immer optional eingefügt.

QS-Kommentar aus BY am 30.11.2022

 

in der heute veröffentlichten Entwurfsfassung besteht an einer Stelle Anpassungsbedarf. Es handelt sich dabei um die Nachricht 0230 (Teilbaugenehmigung). Dorf wurde das bisherige Element „bezug“ durch das Element „anbindungFachverfahren“ ersetzt. Dies beruht vermutlich auf der Umsetzung des CR XBAU-252 Geprüft . Allerdings war dieser nach meinem Verständnis darauf gerichtet, den Datentyp "bezugErweitert" in alle Nachrichten aufzunehmen. Im Laufe der Bearbeitung des CRs wurde das Element "anbindungFachverfahren" entwickelt, das in Nachrichten aufgenommen werden sollte, die weder über das Element "bezug" noch "bezugErweitert" verfügen.

Wir benötigen in der Nachricht 0230 weiterhin das Element „bezug“ bzw. „bezugErweitert“, schon wegen der Möglichkeit auf einen in Papierform eingereichten Bauantrag Bezug zu nehmen. Falls tatsächlich das Element „anbindungFachverfahren“ zusätzlich erforderlich ist – was nach meinem Verständnis nicht Ziel des CRs war –, sollte dies zusätzlich als optionales Element aufgenommen werden und nicht ersetzend.

Dass das Element „bezug“ durch „anbindungFachverfahren“ ersetzt wird, ist mir nur an dieser einen Stelle aufgefallen. Im Übrigen wurde dies m.E. nicht so umgesetzt

Das Element 'anbindungFachverfahren' wird in den Nachrichten 0110 und 0230 durch das Element 'bezug' vom Typ 'bezugErweitert' ersetzt.