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.

Deployment in Produktion am 07.11.2023

Changed​

• Suchdienst/Suchclient: Die Reihenfolge der Elemente auf der Detailseite wurde angepasst, sodass die Anlaufstellen jetzt an zweiter Position angezeigt werden.
• Suchdienst: Die Ausgabe der Leistungsbeschreibung-Endpunkte wurde angepasst und die folgenden Umbenennungen von Modul-Titeln wurden vorgenommen:
  • Deutsche Modul-Titel:
    • "Volltext" zu "Beschreibung"
    • "Teaser" zu "Kurzinfo"
    • "Rechtsgrundlagen" zu "Rechtsgrundlage(n)"
    • "erforderliche Unterlagen" zu "Erforderliche Unterlagen"
    • "zuständige Stelle" zu "Zuständige Stelle"
  • Englische Modul-Titel:
    • "Full text" zu "Description"
    • "Teaser" zu "Quick info"
    • "Expenses & charges" zu "Expenses & Charges"
    • "Legal basis" zu "Legal basis(s)"

Fixed​

• Suchclient: Es wurde ein Fehler behoben, durch den kurzzeitig auf der Detailseite irrtümlicherweise eine Fehlermeldung auftauchen konnte.
• Suchdienst: Es wurde ein Fehler behoben, durch den fälschlicherweise die Beschreibung des Onlinedienstes statt der Bezeichnung des Onlinedienstes angezeigt wurde, wenn ein Onlinedienst-Link keinen Titel hat.

Deployment in Produktion am 17.10.2023

Added​

• Ab Release 8.1.1 wird bei Endpunkten, die als deprecated markiert sind, in den Antworten der Dienste der HTTP-Header X-PVOG-DEPRECATED mit dem Wert true gesetzt.

Deployment in Produktion am 26.09.2023

Added​

• Sammlerdienst: Unterstützung für Leistungen im Gemeinsamen Vollzug umgesetzt.

Changed​

• Suchdienst: Das dem ARS-Postleitzahlen-Mapping zu Grunde liegende DESTATIS Gemeindeverzeichnis wurde auf den Stand vom 31.07.2023 aktualisiert.
• Suchdienst: Die folgenden Endpunkte wurden um den optionalen Parameter useArsHierarchy erweitert (default true); wird der Parameter auf false gesetzt, wird nur noch nach der exakten ARS gesucht:
  • /v7/servicedescriptions/{ars}
  • /v5/servicesdescriptions/{ars}/detail
  • /v3/servicedescriptions/leikaid
  • /v2/relations/{ars}/jzufi
• Validator-Backend/Frontend:Konfiguration erlaubter LeiKa-Typen für Bundesländer um Mischtypen 1:2, 1:2a und 1:2b erweitert. Bund um 1:2 und 6 erweitert.

Fixed​

• Sammlerdienst: Es wurde ein Fehler bei der Sicherstellung der Eindeutigkeit von Identifikatoren von Spezialisierungen behoben.
• Suchdienst: Das Schema für den Endpunkt /v2/relations/{ars}/jzufi wurde korrigiert
• Suchclient: Es wurde eine fehlerhafte Darstellung von Latin-Extended-Zeichen behoben.
• Suchclient: Es wurde ein Fehler bei der Darstellung der Lebenslange-Kacheln behoben, der zur Anzeige von ungültigen Kacheln führte.

Removed​

• Suchdienst: Folgende Schnittstellen wurden entfernt:
  • /v5/servicedescriptions/{ars}
  • /v4/servicedescriptions/{ars}/detail
  • /v2/servicedescriptions/leikaid
  • /v1/servicedescriptions/{ars}/jzufi
  • /v3/organisationunits/detail