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.

Deployment in Produktion am 15.10.2024

Changed​

Suchdienst Frontend​

• Im Präzisierungsdialog der Ortssuche muss die Straße nur dann eingegeben werden, wenn zu einer PLZ mehrere ARS existieren.
• Im Präzisierungsdialog der Ortssuche zeigt die Autovervollständigung der Hausnummer jetzt eindeutige Vorschläge an.

Validator Backend​

• Die Endpunkte der Datenbestand-Statistiken des Validator-Backends ermitteln nun aus den Anfragen, die zugeordneten SchemeAgencyIds aus den Security-Token. Bei fehlenden oder falschen SchemeAgencyIds reagieren die Endpunkte mit einem HTTP-Status 403 (Forbidden). Der Übersicht-Endpunkt filtert das Ergebnis nach erlaubten Redaktionssytemen (SchemeAgencyIds).

Validator Frontend​

• Das Validator-Frontend wurde um die Darstellung der Datenbestand-Statistiken erweitert werden. Es ist jetzt möglich, mit Accounts pro SchemeAgencyId Validierungsergebnisse aus dem Sammlerdienst abzufragen.

Fixed​

Suchdienst Backend​

Die OpenAPI-Spezififkation der REST-API (9.17.4) wurde an diversen Stellen präzisiert.

• ID-Felder werden an notwendigen Stellen als Pflicht gekennzeichnet.
• Felder mit Datumsangaben sind mit dem Format date gekennzeichnet.
• Boolean-Felder sind an notwendigen Stellen als Pflicht gekennzeichnet. An den Request-Parametern gab es keine Änderung.

Suchdienst Frontend​

• Im Präzisieren-Dialog der Ortseingabe kam es vor, dass für bestimmte Grenzfälle bestehend aus PLZ und Straße, mehrfach die gleiche Hausnummer zur Auswahl stand. Jetzt ist die Auswahl der Hausnummer eindeutig.

Deployment in Produktion am 24.09.2024

Added​

Suchclient​

• Es wurde die automatische Vervollständigung der Eingaben durch Vorschlagsinhalte im Ortseingabefeld ergänzt. Die Vervollständigung startet mit Wortbeginn, wobei der vervollständigte Teil grau dargestellt wird und sich mit weiteren Eingaben dynamisch ändert. Sind keine geeigneten Vorschläge vorhanden, wird nichts angezeigt.

Validator​

• Für die Validierung des Gesamtbestandes der PUSH-Redaktionssysteme wurden weitere Endpunkte geschaffen. Diese liefern Statistik- und Protokollierungsinformationen. Neu ist die Möglichkeit der Überprüfung aller vorhandenen Statistik-Datensätze für ein Redaktionssystem, inklusive der Häufigkeit aller Fachvalidator-Funde.

Changed​

Validator-Service​

• Der Path für Swagger-UI wurde auf den Standardwert (/api/swagger-ui/index.html) gesetzt. Vorher war Swagger nicht ohne vorherige Authentifizierung erreichbar.

Fixed​

Suchdienst​

• Korrektur der 'v5/organisationunits/detail'. Es werden Formulare an der Organisationseinheit mehrsprachig ausgegeben.

Suchclient​

• Behebt ein Problem mit einem leeren Anker im Inhaltsverzeichnis der Detailseite, der zu einer Fehlerseite führte.

Deployment in Produktion am 03.09.2024

Features​

Suchdienst Frontend​

• Formulare (Geschäftsobjekte) mit direktem Leistungsbezug werden unter Formulare angezeigt. Mehrere Formulare (jeweils mit Beschreibung, Hinweis, Gültigkeit..) sind optisch voneinander getrennt.  Ist ein Formular-Objekt vorhanden, wird das Textmodul Formular nicht mehr ausgegeben.

Added​

Validator Backend​

• Für die Validierung des Gesamtbestandes der PUSH-Redaktionssysteme wurde ein weiterer Endpunkt geschaffen. Dieser nutzt ein ZIP-Archiv ähnlich der herunterladbaren PULL Import-Archive. Die Validierung erfolgt asynchron. Der Validationsreport sowie statistische Informationen werden in einer Datenbank zum späteren Abruf vorgehalten.

Validator Service​

• Ein neuer Validator im Warnmodus ist eingerichtet: VAL0064 prüft, ob ein importiertes Formular mindestens eine Organisationseinheit enthält. Warnmeldung: Ein Formular in einer Organisationseinheit muss mindestens eine Zuständigkeit enthalten.

Fixed​

Suchdienst​

• Die API '/v4/organisationunits/detail' findet wieder Organisationseinheiten, die mit unvollständigen ARS aufgerufen werden. Damit wird eine Regression aus 9.16.0 korrigiert.

Sammlerdienst​

• ZIP-Archive von PUSH-Redaktionssystemen werden mit korrektem relativen Pfad der XML-Dateien in der index.txt generiert.

Deployment in Produktion am 13.08.2024

Added​

Suchdienst​

• Die BKG-Endpunkte sind verfügbar siehe Blogbeitrag.

Changed​

Suchdienst Frontend​

• Die Ortssuche verwendet den BKG-Service. Ist der ARS innerhalb einer PLZ nicht eindeutig, hilft eine Straßensuche bei der Bestimmung des korrekten ARS.

Validator-Service​

• Die Verbindung vom Validator-Frontend zum Backend ist jetzt über OAuth2 abgesichert. Ein Betrieb mit der HTTP-Basic-Absicherung ist bis auf weiteres noch möglich.
• Http-Error-Responses werden nun im Json-Format ausgegeben. Einige Fehlercodes wurden hinzugefügt (vb0404, vb0405, vb0406, vb0460, vb0461, vb0462).

Fixed​

Sammlerdienst​

• Die Antwort einer PUSH-Anfrage war im Fehlerfall nicht eindeutig. Es nicht ersichtlich war, welcher Schwere die Meldungen entsprachen. Stattdessen wird nun, wie im Erfolgsfall, die Message als JSON-Struktur zurückgeliefert.

Suchdienst​

• Die OpenAPI-Dokumentation der BKG-Endpunkte wurde korrigiert und präzisiert.
• Die OpenAPI-Dokumentation zum Endpunkt /v5/servicedescriptions/csv wurde korrigiert. Hier war ein falscher MediaType für die Response hinterlegt, sodass ein Aufruf des Endpunktes eine HTTP Response 406 (Not Acceptable) lieferte.

Deployment in Produktion am 23.07.2024

Added​

Suchclient​

• An der Organisationseinheit gelieferte Formulare an der Anlaufstelle (Zuständigkeit an der Organisationseinheit) werden im Frontend ausgegeben.

Suchdienst Backend​

• Es gibt eine neue Version des Endpunktes zum Abfragen von Organisationseinheiten: /v5/organisationunits/detail. Dieser liefert nun die, an der Organisationseinheit angelieferten, Formulare im neuen Feld (nestedForms).
• Das Feld forms (enthält die Links aus XZuFi Organisationseinheit.internetAdresse) wurde umbenannt in internetAddresses.

Changed​

Suchdienst Backend​

• Anfragen an den BKG Endpunkt v3beta2/locations/details erzielen jetzt schnellere und genauere Antworten.
• Bessere Unterstützung für Bremen und Bremerhaven umgesetzt.
• Suche nach exaktem Ortsteil-ARS an v3beta2/locations/ars ermöglicht.

Deprecated​

Suchdienst Backend​

• Der Endpunkt /v4/organisationunits/detail ist nun deprecated.

Deployment in Produktion am 02.07.2024

Fixed​

Suchdienst​

• Unvollständige PLZs sind an Location-Detail-Endpunkten wieder erlaubt.
• Einzelne fälschlicherweise herausgefilterte Treffer sind nun am v3beta2/locations Endpunkt wieder inkludiert.
• Der Fehler am v3beta2/locations Endpunkt, der bei Suchen mit PLZ auftrat, wenn Antworten des BKG vom Typ PLZ keinen ARS enthielten, wurde behoben.
• Bei nachträglicher Filterung an den v3beta2/locations Endpunkten wird das Limit eingehalten.

Added​

Sammlerdienst​

• Der Validator VAL0025, Gültigkeiten mit Widerspruch, prüft jetzt auch bei Push-Nachrichten die Gültigkeiten von Spezialisierungen gegen die Gültigkeiten ihrer Leistung.
• Der Push-Endpunkt liefert nun im Body das Validatorprotokoll als JSON zurück.

Changed​

Suchdienst​

• Änderung der Beta-Endpunkte 'Orte' von v3beta1 zu v3beta2. Die alten Beta-Schnittstellen entfallen ersatzlos.
• OpenAPI Security und Authorisierung für Admin-Endpunkte sind nun korrekt dokumentiert.
• Die ARS-Suche über v3beta2/locations wurde angepasst und berücksichtigt nun ARS-Hierarchien bei gekürzten oder mit '0' aufgefüllten Schlüsseln.

Validator-Service​

• Aufgrund von Änderungen in der Konfiguration des 'fachvalidator' von Version 8.0.1 erfolgten Anpassungen in der Konfiguration des Backends, um den gleichen Prüfungsumfang herzustellen.

Deployment in Produktion am 11.06.2024

Fixed​

Suchclient​

• Verbesserte Darstellung des "Externer Link Popup-Fensters" ohne abgeschnittene Inhalte
• Darstellung von Parametern in Links verbessert
• Automatische Weiterleitung nach Countdown beim Öffnen externer Links wurde korrigiert

Added​

Suchdienst​

• Die folgenden Endpunkte können nun prototypisch mit dem optionalen Parameter applyDynamicParams dynamische Parameter auflösen:
  • /v5/servicedescriptions/{ars}/detail
  • /v7/servicedescriptions/{ars}

Hinweis:

• Bei Organisationseinheiten (Code 003) sind unter Umständen Mehrdeutigkeiten möglich. In diesem Fall ist nicht spezifiziert, welche ID geliefert wird.
• Wenn zu einem dynamischen Parameter kein Wert ermittelt werden kann, wird er übersprungen, d. h. die Onlinedienst-URL enthält diesen nicht.

• Der Suchdienst übernimmt die mit der Leistung direkt verknüpften Formulare und speichert diese im neuen Index suchdienst_formulare. Der Endpunkt /v5/servicedescriptions/{ars}/detail liefert diese Formulare im neuen Feld forms.

Suchclient​

• Leistungen des Bundes sind auf der Ergebnisseite durch ein Banner gekennzeichnet
• eigenständige Formulare werden an der Leistung angezeigt und ersetzen dabei das Textmodul 'Formulare'

Changed​

Suchclient​

• Lebenslagen-Icons wurden ausgetauscht

Deployment in Produktion am 21.05.2024

Added​

Suchdienst​

• Die neue Endpunktversion /v7/servicedescriptions/{ars} führt nun eine implizite Suche nach LeiKa-ID durch, wenn genau ein Suchwert übergeben wird und dieser syntaktisch eine LeiKa-ID ist (14 Ziffern).

Validator-Service​

• Neuer Endpunkt v3/{id}/report. Ausgabe eines reduzierten Reports in der neuen Version.
• Neuer Endpunkt v2/{id}/komplettreport. Ausgabe eines kompletten Reports in der neuen Version.

Changed​

Suchclient​

• Markierung des Eingabetextes in den Vorschlägen der Ortssuche nur an suchrelevanten Stellen

Validator-Service​

• v2/{id}/report und v1/{id}/komplettreport haben nun den Status Deprecated
• Geschwindigkeitsverbesserung im Validator für HTML-Feldinhalte (VAL0053, ValidatorHtmlUnerlaubteElemente).

Removed​

Suchdienst​

• Der Endpunkt /v1/locations/reverse wurde entfernt.

Deployment in Produktion am 02.05.2024

Added​

Suchdienst​

• Vier neue Location-Endpunkte liegen jetzt in einer Beta-Version vor. Die Quelle der Daten ist das Bundesamt für Kartographie und Geodäsie (BKG). Weitere Infos zu den Schnittstellen sind hier zu finden. Die Pfade lauten wie folgt:
  • v3beta1/locations
  • v3beta1/locations/suggestions
  • v3beta1/locations/details
  • v3beta1/locations/ars
• Hinweis: Die in der Version 3 vorliegenden Schnittstellen binden das BKG als Datenquelle an. Die ARS entsprechen nicht in allen Fällen denen der ARS-Codeliste im xRepository (urn:de:bund:destatis:bevoelkerungsstatistik:schluessel:rs). Dies hat zur Folge, dass mit solchen ARS am Suchdienst keine Auflösung von Geschäftsobjekten garantiert werden kann.

Changed​

Suchdienst​

• Der Endpunkt /v2/organisationunits/titles enthält jetzt neben den ursprünglichen Feldern zusätzlich das Feld criteria mit den entsprechenden Zuständigkeitskriterien (siehe XZuFi 2.2 - Abschnitt II.2.9.4 Zuständigkeitskriterium)

Suchdienst Frontend​

• Verbesserung der Fehlererkennung und Weiterleitung im Fehlerfall