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.

Deployment in Produktion am 06.03.2024

Changed​

Suchdienst:​

• Wenn der Name eines Onlinedienstes in der Fremdsprache fehlt, dann wird der Onlinedienst nicht mehr verworfen. Zuvor wurde in dem Fall immer die deutsche Variante des Onlinedienstes verwendet.
• Bei Fristen mit fehlender `einheitBis` wird auf `einheit` zurückgegriffen.

Beispiel:​

{
    "fristauswahl": {
        "fristDauer": {
            "dauer": 1,
            "einheit": {
                "code": "WOCHE",
                "listURI": "urn:xoev-de:fim:codeliste:xzufi.zeiteinheit",
                "listVersionID": "1.1"
            },
            "dauerBis": 6
        }
    }
}

• Die `fristauswahl` wurde zuvor verworfen / ignoriert, da zu `dauerBis` keine `einheitBis` angegeben war.
• Mit diesem Change jedoch wird bei fehlender `einheitBis` auf `einheit` zurückgegriffen, d. h. das Beispiel wird wie folgt verarbeitet:

{
    "fristauswahl": {
        "fristDauer": {
            "dauer": 1,
            "einheit": {
                "code": "WOCHE",
                "listURI": "urn:xoev-de:fim:codeliste:xzufi.zeiteinheit",
                "listVersionID": "1.1"
            },
            "dauerBis": 6
            "einheitBis": {
                "code": "WOCHE",
                "listURI": "urn:xoev-de:fim:codeliste:xzufi.zeiteinheit",
                "listVersionID": "1.1"
            },
        }
    }
}

• Der HTML-Sanitizer wurde aus dem Suchdienst ausgebaut. Die Prüfung auf unerlaubte HTML-Elemente und Attribute wird durch den Fachvalidator im Sammlerdienst sichergestellt.
• Dadurch wird eine solche Überprüfung im Suchdienst nicht mehr benötigt.

Validator Backend/ Frontend:​

• VAL0038: Erweiterung der Konfigurationen für die Landesredaktionssysteme um die Mehrfachtypisierungen 1 und 2/3; 2 und 3; 2 und 3a; 2 und 3b; 2a und 3; 2a und 3b; 2b und 3; 2b und 3a; 2b und 3b.
• VAL0038: Erweiterung der Konfigurationen für das Bundesredaktionssystem um die Mehrfachtypisierung 1 und 2/3.
• Der Pfad zur Indexdatei sowie absolute Pfade innerhalb der Indexdatei (dort werden relative Pfade aus Sicherheitsgründen bevorzugt) müssen jetzt das https-Protokoll verwenden.
• Umbenennung der Konfiguration laenderliste.laender zu redaktionssystemliste.redaktionssystem
• Neuer Hinweis-Modus nicht mehr fälschlich als Warnung identifiziert. Fallback auf Fehlermeldung bei nicht erkanntem Validator Modus
• Fehlerbehandlung von "Bad Request" zum Start einer Validierung und Anpassung von Fehlermeldungen

Added​

Validator Backend/ Frontend:​

• Neuer Endpunkt "/v1/ {redsyscode}/redsyskonfig" wurde angelegt.
• Neuer Endpunkt "/v5/validiere" mit umbenanntem redsyscode-Parameter.

Fixed​

Suchdienst:​

• Die Filterung auf das Vorhandensein von PLZs am BKG-Location Endpunkt funktioniert wieder.

Deprecated​

Validator Service:​

• Endpunkt "/v1/ {landcode}/landkonfig" wurde abgekündigt.
• Endpunkt "/v4/validiere" wurde abgekündigt.

Deployment in Produktion am 06.02.2024

Added​

• Validator-Service: Neuer Modus 'Hinweis' eingeführt. Zu den Protokollmodi 'Error' und 'Warnung' wurde zusätzlich der Modus 'Hinweis' eingeführt. Hinweise werden immer im Protokoll ausgegeben, unabhängig davon, ob Fehler und Warnungen vorhanden sind.
• Validator-Service: VAL0062 (leistungMitFalscherLeiKaTypisierung) und VAL0063 (leistungMitUnvollstaendigerLeiKaTypisierung) wurden hinzugefügt. VAL0063 ist der erste Validator, der Hinweise liefert. Die Beschreibungen der beiden neuen Validatoren sind im Validator-Handbuch hinterlegt.

Changed​

• Validator-Service: VAL0038("Leistung mit unzulässiger Typisierung"): Erweiterung der Konfiguration für das Bundesredaktionssystem um die Mehrfachtypisierungen 1 und 2a; 1 und 2b; 1 und 3a; 1 und 3b. Erweiterung der Konfigurationen für die Landesredaktionssysteme um die Mehrfachtypisierungen 2a und 2b; 3a und 3b; 4a und 4b.
• Suchdienst: Die OpenAPI Dokumentation wurde dahingehend überarbeitet, dass jetzt die Felder 'summary' und 'description' gefüllt sind.
• Suchdienst: Leistungen im gemeinsamen Vollzug mit einem Bundes ARS (000000000000) werden nun für jedes Bundesland mit berechnet.
• Suchclient: Die Anzeige der Gültigkeitszeiträume von Leistungen wurde aktualisiert. Weiterhin wird bei einer bald ablaufenden Gültigkeit ein entsprechender Hinweis am Seitenbeginn dargestellt.
• Suchclient: Beim Verlassen der Domäne wird ein Hinweisfenster eingeblendet (BSI: Kontrolliertes Einbinden von Inhalten bei Webanwendungen).
• Suchclient: Auf Unterseiten wird neben dem Logo im Header nun auch der Seitentitel dargestellt.

Deployment in Produktion am 16.01.2024

Added​

• Suchdienst: Es gibt einen neuen Endpunkt zur Suche mit Geokoordinaten: v2/locations/reverse
  • Der neue Endpunkt nutzt zur Beantwortung der Anfrage im Hintergrund die API des Bundesamt für Kartographie und Geodäsie (BKG) und reduziert dann die Ergebnisse auf die Amtlichen Regionalschlüssel (ARS), die auch in der Codeliste urn:de:bund:destatis:bevoelkerungsstatistik:schluessel:rs enthalten sind. Für Stadtstaaten ist eine zusätzliche Transformation notwendig, da die vom BKG ausgegeben ARS für Stadtteile von Stadtstaaten nicht der Codeliste entsprechen.
  • Mit der neuen Version des Endpunkts ändert sich auch das Format der Ausgabe. Es verwendet die Felder name, ars, arsFederalstate, municipality und plz

Changed​

• Validator-Service: VAL0038: Die Typisierungs-Konfiguration sowohl für das Bundesredaktionssystem als auch die Landesredaktionssysteme wurde um die Mehrfachtypisierungen 1 und 3; 1 und 3a; 1 und 3b erweitert. Die Konfiguration für Landesredaktionssysteme wurde zusätzlich um die Mehrfachtypisierung 2a und 3a erweitert.
• Suchclient: Das Impressum und die Seite zum Datenschutz wurden aktualisiert

Deprecated​

• Suchdienst: Die Schnittstelle v1/locations/reverse wurde als Deprecated markiert.

Fixed​

• Suchdienst/Suchclient: Der Aufbau der Lebenslagen-Hierarchie wurde korrigiert. Jetzt wird für eine Lebenslage, deren letzten zwei Stellen nicht null sind, nicht mehr versehentlich eine zusätzliche Hierarchie-Ebene (unterhalb der Sub-Lage) generiert.

Deployment in Produktion am 23.11.2023

Changed​

• Suchclient: Das Impressum wurde um weiterführende Links zu den Seiten der FITKO und zum Produktportal ergänzt.

Fixed​

Hinweis: Die folgenden beiden Bug-Fixes wurden bereits am 14.11.23 per Hotfix auf Preprod/Prod eingespielt.

• Suchdienst: Es wurde eine Anpassung vorgenommen, sodass der Endpunkt /v3/servicedescriptions/leikaid wieder Ergebnisse liefert, wenn mit einer nicht 12-stelligen ARS angefragt wird.
• Suchdienst: Es wurde die Ausgabe des Endpunkts /v2/onlineservices/detail korrigiert, der jetzt wieder in den Zuständigkeiten (relations) das korrekte Tupel aus id, parentId und lbId liefert.