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

Deployment in Produktion am 09.04.2024

Fixed​

Suchdienst​

• Datentypen der REST Schnittstellen referenzieren wieder auf den korrekten Typen in der Dokumentation.
• Laut OpenAPI-Spec sind einige Parameter optional, obwohl sie zwingend nötig sind:

Beispiel​

Wird ein betroffener Service ohne entsprechenden Parameter aufgerufen, wird der Aufruf mit dem Status 400 (bad request) abgewiesen.
Mit diesem Bugfix wird die Dokumentation korrigiert.

Betroffene Endpunkte:

/v2/locations: Parameter q
/v1/locations/reverse: Dieser Endpunkt ist bereits deprecated. Betroffen sind die Parameter lat und lon
/v2/locations/reverse: Parameter lat und lon
/v2/locations/suggestions: Parameter q
/v2/relations/{ars}/jzufi: Parameter page ist jetzt als optional spezifiziert. Der Default war vorher schon mit 0 angegeben
/v7/servicedescriptions/: Parameter page und size sind jetzt als optional spezifiziert
/v3/servicedescriptions/leikaid: Parameter page und size sind jetzt als optional spezifiziert
/v2/servicedescriptions/leikahierarchy: Parameter page und size sind jetzt als optional spezifiziert

Added​

Validator Backend/Frontend​

• Die Ausgabe der Validatorkonfiguration erfolgt jetzt über den neuen Endpunkt /v1/validatorconfig.
• Die neuen Endpunkte v5/validiere und v1/$\{redsyscode}/redsyskonfig werden durch das Frontend angebunden.

Deployment in Produktion am 26.03.2024

Changed​

Validator Backend/Frontend:​

• Die Validatoren VAL0039, VAL0042 und VAL0051 wurden vom Warnung-Modus auf den Hinweis-Modus umgestellt.
• Der Validator VAL0040 wurde verschärft, dass auch die für PVOG relevante Leistungs-Referenz-Identifikatoren an Spezialisierungen und Zuständigkeiten die SchemeAgencyId des Redaktionssystems haben müssen.

Fixed​

Suchclient:​

• Behebung von Darstellungsproblemen unter Webkit/Safari.

Sammlerdienst:​

• Bei der Verarbeitung von Push-Nachrichten wurde nicht geprüft, dass das adressierte Redaktionssystem auch für den Push-Modus konfiguriert ist.