Deployments: PreProd/Stage am 24.06.2025, Produktion am 30.06.2025

Versionen: Suchdienst Backend 11.0.3, Sammlerdienst 7.1.0, Bereitstelldienst 6.11.0, Fachvalidator Library 12.3.5, Konverter Library 1.6.1

Add​

Sammlerdienst​

• Der Sammlerdienst akzeptiert und verarbeitet jetzt XZuFi 2.3.1.
• Das Sammlerdienstkonzept für XZuFi 2.3.1 steht im Downloadbereich des Produktportals zur Verfügung.
• Implementieren der UebergeordnetesObjektKlasse am ZustaendigkeitTransferObjekt zum Identifizieren des Zuständigkeits-Typs.
• Description in der OpenAPI-Spezifikation um Hinweis zur Schnittstellenversionierung erweitert.

Suchdienst Backend​

• Der Suchdienst unterstützt jetzt die Verarbeitung von XZuFi 2.3.1 Daten.

• Daten im neuen XZuFi 2.3.1 Format werden in die bestehenden Modelle überführt, um eine Abwärtskompatibilität zu unseren Konsumenten zu gewährleisten.

• Neue JZuFi APIs bieten die Möglichkeit XZuFi Daten in beiden XZuFi Standards als JSON-Repräsentation zu laden. Dafür ist der Accept-Header-Parameter zu setzen. Siehe dazu auch die überarbeitete OpenAPI Dokumentation im Produktportal.

• Neue APIs

  • /v3/servicedescriptions/jzufi
  • /v2/organisationunits/jzufi
  • /v3/relations/{ars}/jzufi

• Description in der OpenAPI-Spezifikation um Hinweis zur Schnittstellenversionierung erweitert.

Bereitstelldienst​

• Bereitstellung einer Metrik für die Zugriffsstatistik nach XZuFi-Version.
• Erweiterung des Endpunktes bereitstelldienst/api/v2/verwaltungsobjekte zur optionalen Übertragung der gewünschten XZuFi-Version als Parameter.
• Verwenden der uebergeordnetesObjektKlasse aus XZuFi 2.3.1 zum Identifizieren des Zuständigkeit-Typs.
• Description in der OpenAPI-Spezifikation um Hinweis zur Schnittstellenversionierung erweitert.

Suchdienst Frontend​

• Fallback auf Gemeinde in der Ortsanzeige bei ARS-Auflösung via BKG.
• Erlaubt im Rahmen der von xZuFi 2.3 eingeführten Zugangskanäle duplizierte Modul-Codes.

Fix​

Suchdienst Frontend​

• Security: Behebt Schwachstelle CVE-2025-32997.
• Security: Behebung der Schwachstelle CVE-2025-27789.
• Hinweis auf Verlassen der Vertrauensdomäne taucht bei bestimmten Links nicht auf.
• Rendering der (Detail)- Modulblöcke überarbeitet.
• Ortsnamen auf 50 Zeichen begrenzt.

Removed​

Suchdienst Backend​

• Die abgekündigte Schnittstelle /suchdienst/v4/organisationunits/detail wurde entfernt.

Deployment in Produktion am 29.04.2025

Add​

Sammlerdienst Backend​

• Der Sammlerdienst ist in der Lage, parallel XZuFi 2.2 und 2.3.1 Daten zu verarbeiten.

Validator Service​

• Erweiterung der Validator Benutzer um die API-Funktionalität.

Changed​

Dokumentation​

• In den veröffentlichten Dokumenten wurde die "alte" Bezeichnung Leistungsbeschreibung durch Leistung ersetzt:

  1. Anbindungsanleitung des Bereitstelldienstes,
  2. XZuFi Validator Handbuch,
  3. Konzept Online Gateway Sammlerdienst,
  4. Konzept Online Gateway Suchdienst

• Der FIM-Katalog Downloader wurde auf allen PVOG Umgebungen separat realisiert.

Fixed​

Suchdienst Backend​

• Auch an den Locations-Endpunkten ist jetzt die Abfrage mit Ortsnamen von maximal 70 Zeichen möglich.

  suchdienst/api/v3/locations/suggestions

  suchdienst/api/v3/locations/details

Deployment in Produktion am 08.04.2025

Add​

Sammlerdienst Backend​

• Der Zerteiler verarbeitet XZuFi 2.3.1.
• DeltaDetektor und PushVerarbeiter verarbeiten XZuFi-Version 2.3.1.

XZuFi-Konverter​

• Während der Konvertierung aufgetretene Änderungen im XZuFi-Dokument werden als Protokoll ausgegeben. 
• Die Konverter API wurde veröffentlicht. (/api/konverter/portalverbund-konverter-rest-api) 

Produktportal​

• Auf dem Produktportal wurde ein Glossar ergänzt.

Change​

XZuFi-Konverter​

• Die openCode-Dokumentation wurde in der README um Einbindungsinformationen erweitert.

Validator​

• VAL0011 wurde angepaßt, um sms, callto und skype im Auskunftshinweismodul zu verarbeiten.

Produktportal​

• Das Produktportal hat ein neues Design bekommen.

Fix​

Suchdienst Backend​

• Der FIM-Katalog Downloader funktioniert auch mit doppelten Leistungsschlüsseln im FIM-Katalog.

Suchdienst Frontend​

• Die Begrenzung der Ortsnamen wurde auf 70 Zeichen erweitert.
• Die Ausgabe von Links mit Leerzeichen am Ende wurde korrigiert.

Deployment in Produktion am 18.03.2025

Add​

Sammlerdienst​

• Zur Vorbereitung der parallelen Verarbeitung von XZuFi 2.2 und XZuFi 2.3.1 Daten wurde die Datenhaltung erweitert. Damit kann pro Datensatz die XZuFi Version festgelegt werden.

• Zusätzlich zum Anlegen und Ändern von Push-Datensätzen wird das Löschen von Datensätzen geloggt.

Suchdienst Frontend​

• Bei der Ortspräzisierung werden nur Suchergebnisse im Feld Hausnummer angezeigt, wenn diese zur Ermittlung des korrekten Regionalschlüssels notwendig sind.

Changed​

Bereitstelldienst​

• Die Dokumentation des Anbindungsleitfadens Bereitstelldienstes wurde um den Abruf von XZuFi 2.3.1 Daten erweitert.

Fixed​

Suchdienst Frontend​

• Der Präzisierungsdialog ist nun scrollbar. Damit wird die mobile Ansicht des Suchclients optimiert.

Validator Service​

• Das Herunterladen von großen Reports aus dem Validator Frontend ist als Zip-Datei umgesetzt.

Deployment in Produktion am 25.02.2025

Add​

Bereitstelldienst​

• Der Export des Datenbestandes auch in XZuFi-Version 2.3.1 wurde ermöglicht.
• Eine Import-Verarbeitung von XZuFi 2.3.1 für Testzwecke ist realisiert. 

Validator Frontend​

• Die parallele Verarbeitung für XZuFi 2.2. und XZuFi 2.3.1 Daten ist umgesetzt.  

Validator Backend​

• Es ist die Verarbeitung vom XZuFi 2.3.1 Dateien in der Validator API möglich.
• Der Fachvalidator wurde auf OpenCode.de veröffentlicht (Siehe Blogbeitrag).

Changed​

Konverter Library​

• Die Verarbeitung von PV-Schema für XZuFi 2.3.1 ist ergänzt.

Dokumentation​

• Im Validatorhandbuch wurden Informationen zu XZuFi 2.3.1 ergänzt.

Validator Backend​

• Der FIM-Katalog wird vom neuen FIM-Portal heruntergeladen. 

Fixed​

Suchdienst Frontend​

• Ein inkorrektes Verhalten beim Ortswechsel mit bereits ausgewählter Leistung wurde behoben.
• Der Präzisierungsdialog bei der Ortssuche zeigt Fehlermeldungen an, falls der Ort nicht bekannt ist.

Validator Frontend​

• Eine Meldung weist auf die fehlende Schemeagency ID bei der Validierung hin.

Deployment in Produktion am 04.02.2025

Add​

Sammlerdienst​

• Optimierung der Verarbeitung von geplanten Aufgaben wie der Validierung des Gesamtbestandes bei gleichzeitig eintreffenden Push-Nachrichten.

Suchdienst​

• Warnungsfreie Verarbeitung von Codelisten mit abweichendem Codelisten Schema

Suchdienst Frontend​

• Anpassung der Endpunkte und des Suchclients für die Suche nach Gemeinde-ARS
• Anzeige der ausgewählten Gemeinde oberhalb der Seitennavigation

Validator Backend​

• Die Speicherdauer von Validator-Statistiken ist jetzt konfiguierbar. 
• Das Validatorhandbuch wurde angepaßt.

Fixed​

Sammlerdienst​

• Wiederholt gesendete Push-Nachrichten werden nicht mehr mit der Fehlermeldung der ersten Verarbeitung abgewiesen.

Suchdienst​

• Doppelte Logeinträge im Push-Verfahren werden verhindert.

Suchdienst Frontend​

• PLZ-Vorschläge werden besser optisch hervorgehoben.  

Validator Service​

• Große json-Dateien können performanter heruntergeladen werden.

Deployment in Produktion am 16.01.2025

Changed​

Validator Backend​

• Fachvalidator Fallback-Leistungskatalog überschreibt Datenbank

Fixed​

Suchdienst API​

• Korrektur an v7/servicedescriptions

Suchdienst Frontend​

• Korrektur bei der Hervorhebung der PLZ-Vervollständigung

Deployment in Produktion am 10.12.2024

Add​

Bereitstelldienst​

• Die Tabelle Verwaltungsobjekte wurde um das Feld 'xzufiversion' erweitert.

Sammlerdienst​

• ValidationContext wurde für XZuFi 2.3 erweitert.

Validator​

• ValidationContextInterface wurde um XZuFi Version 2.3 ergänzt.
• Der ValidatorService hat ein nutzerfreundlicheres Design erhalten. Außerdem werden neue Validierungsstatistiken, auch als csv-Datei, zum Download bereit gestellt.

Fixed​

Sammlerdienst​

• Die Konfiguration des Fachvalidator Snapshots wurde erneuert.

Suchdienst Frontend & Backend​

• Die Schwachstelle CVE-2024-21538 wurde behoben.

Validator​

• HTTP-Header Size wurde vergrößert um Bearer Token Informationen nicht zu beschränken.

Deployment in Produktion am 26.11.2024

Add​

Produktportal ​

• Im Bereich Dokumentation/Suchdienst wird im Absatz Linkgenerator die Funktionsweise erläutert und das Tool zur Verfügung gestellt.

Fixed​

Suchdienst​

• Die Beschreibung des Endpunktes /v2/locations/reverse wurde korrigiert.

Suchdienst Frontend & Backend​

Die Qualität der Funktionalitäten mit Ortsbezug wurde (basierend auf BKG Daten) allgemein verbessert:

• Anhand verschiedener Kriterien wird im Suchdienst Frontend aus der API-Antwort ein ARS ausgewählt. Bei unklarer Datenlage wird jetzt in weiteren Fällen zur Präzisierung (PLZ, ggf. Straße und Hausnummer) der Orteingabe aufgefordert. Damit ist es wesentlich unwahrscheinlicher, versehentlich an einem unbeabsichtigten Ort (unpassender ARS) zu suchen.
• Die API des Suchdienstes zum Auflösen von ARS wurde dahingehend verbessert, dass jetzt in nahezu allen Fällen der jeweils geeignetste Ort zur Gemeinde ermittelt wird. Dies geschieht auf Basis der Bewertung der Datensätze seitens des BKG (unter der Berücksichtigung der Hausadressen).

Deployment in Produktion am 28.10.2024

Add​

Produktportal​

• Der Release Kalender wird im Produktportal veröffentlicht (Releases/Release Kalender).

Changed​

Sammlerdienst​

• Die Anzahl der Log-Meldungen pro verarbeiteter Push-Nachricht ist auf das Wesentliche reduziert. Damit entstehen nur noch halb so viele Log-Meldungen bei der Darstellung einer Push-Nachricht.

Suchdienst Frontend​

• Im Suchfrontend ist die Vorbelegung einer Suchanfrage möglich.
• Die Auflösung der dynamischen OnlineDienst Parameter ist möglich.

Validator Frontend​

• Das Validator-Frontend ist um die Darstellung der Datenbestand-Statistiken erweitert.

Fixed​

OpenAPI Dokumentation (Swagger)​

• Das Beispiel am Endpunkt /v2/relations/ars/jzufi ist aktualisiert.