18 Posts getaggt mit "Information"

Mit dem PVOG Release 9.15. wurde für den Suchdienst der neue Endpunkt /v1beta2/onlineservices veröffentlicht.

Der Endpunkt liefert Onlinedienste innerhalb des angefragten ARS-Bereichs. Die Filterung erfolgt entlang der ARS-Hierarchie sowohl nach oben als auch nach unten.

Filterung nach oben: Bei der Suche nach der ARS 091 (Oberbayern) werden Onlinedienste mit Zuständigkeit für 091 sowie für übergeordnete Ebenen geliefert, z.B. Bayern (09) oder Bund (00).

Filterung nach unten: Bei der Suche nach 091 werden zusätzlich Onlinedienste für untergeordnete Ebenen bis hinunter zur Gemeindeebene geliefert, z.B. München (091620000000).

Beispiele zu den Ergebnissen der Abfrage

1. Abfrage mit <= 1000 Ergebnisse Beispiel: https://stage.pvog.fitko.net/suchdienst/api/v1beta2/onlineservices?ars=100

Für die ARS 100 werden im ersten Schritt alle Ergebnisse der Abfrage (725 hits) der insgesamt 725 Ergebnisse (totalHits) angezeigt.

2. Abfrage mit > 1000 Ergebnissen Beispiel: https://stage.pvog.fitko.net/suchdienst/api/v1beta2/onlineservices?ars=090

Für die ARS 090 werden im ersten Schritt der Abfrage 1000 Ergebnisse (hits) der insgesamt 1590 Ergebnisse (totalHits) angezeigt.

Die weiteren Onlinedienste können durch das Setzen des „nextPageToken“ abgefragt werden.

Beispiel:

https://stage.pvog.fitko.net/suchdienst/api/v1beta2/onlineservices?ars=090&nextPageToken=L100042.OD.12184_43865

Einschränkung über Leika

Als weiterer Parameter kann in der Abfrage die Ergebnismenge auf eine Leistung aus dem Leistungskatalog eingeschränkt werden. Das Ergebnis sind die Onlinedienste, die für eine Leistung mit dem konkreten Leistungsschlüssel, zuständig sind.

https://stage.pvog.fitko.net/suchdienst/api/v1beta2/onlineservices?ars=090&leikaIds=99050012104000

Response

Antwortschema

Das Schema der Antwort ist auf dem Produktportal abgebildet und ermöglich die gezielte Weiterverarbeitung der Ergebnisse.

Parallel zum Produktportal kann auch die Swagger Dokumentation zum Ausprobieren verwendet werden.

Geben Sie gern Feedback zur vorgestellten beta API, z. b. in der User Group oder über das Helpdesk-Formular auf dem PVOG Produktportal!

Mit dem PVOG Release 9.15. wurde für den Suchdienst der neue Endpunkt /v1beta1/onlineservices veröffentlicht.

Der Endpunkt gibt die Organisationseinheiten zurück, die einem Onlinedienst zugeordnet sind. Der Test des Endpunktes kann über das Produktportal oder die Swagger Dokumentation erfolgen.

Beispiel: https://stage.pvog.fitko.net/suchdienst/api/v1beta1/onlineservices/L100012.OD.277549726/organisations

Ergebnis: Es werden alle zugeordneten Organisationseinheiten und die zugehörige Leistung ausgegeben.

Schema der Antwort

Die Beschreibungen der Rollen der Organisationseinheiten für den Onlinedienst sind an zwei Codelisten angelehnt:

• urn:xoev-de:fim:codeliste:xzufi.organisationseinheitsrollefueronlinedienst (ZSOD OE referenziert in 2.3.1)
• urn:xoev-de:fim:codeliste:xzufi.zustaendigkeitsrolle (XZuFi 2.2)

Bitte geben Sie gern Feedback zum neu veröffentlichten Endpunkt, z.B. in der User Group oder über das Helpdesk-Formular auf dem PVOG Produktportal!

Der Validator Service wurde im Zuge der Einführung der Hochverfügbarkeit redundant ausgelegt, sodass nun zwei Validator Dienste parallel betrieben werden können. Diese Redundanz gewährleistet, dass im Falle eines Ausfalls eines Dienstes die bereits begonnenen Validierungsaufgaben nahtlos von dem anderen Dienst übernommen werden können, um eine unterbrechungsfreie Verarbeitung sicherzustellen.

Zur Unterstützung dieser Funktionalität wurde im Validierungsprozess ein neuer Status STUCK implementiert, der sowohl bei der Nutzung der Validator API als auch im Validator Service Anwendung findet. Dieser Status wird aktiviert, wenn innerhalb von fünf Minuten keine Aktualisierung der Validierung erfolgt, was darauf hinweist, dass die Verarbeitung vorübergehend pausiert, jedoch nicht abgebrochen wird. Die Fortsetzung der Verarbeitung erfolgt automatisch, sobald vorherige Tasks abgeschlossen sind, wodurch eine konsistente und zuverlässige Weiterbearbeitung gewährleistet wird.

Der Status STUCK wird über die API-Endpunkt /v1/{id}/fortschritt kommuniziert, sodass externe Systeme oder Nutzer den aktuellen Stand der Validierung nachvollziehen können. Im Frontend wird in diesem Fall eine Meldung angezeigt, die den Nutzer darüber informiert, dass die Validierung angehalten wurde und in Kürze fortgesetzt wird. Diese Maßnahmen tragen dazu bei, die Stabilität und Transparenz des Validierungsprozesses in einer hochverfügbaren Systemumgebung zu erhöhen.

Werden die Suchdienst APIs des PVOG benutzt, um z.B. nach einer Leistung zu suchen, kommen die Ergebnisse in einer bestimmten Reihenfolge zurück. Diese wird dann in der Servicesuche Bund und ggf. anderen angebundenen Portalen umgesetzt.

Bei der Navigation über Lebenslagen auf der Servicesuche Bund anstelle der Suche, werden die Ergebnisse nur nach der ID sortiert. Auch die Reihenfolge der Organisationseinheiten oder Onlinediensten, die an einer Leistung zurückgegeben werden, nutzt die ID der Einträge.

Wie kommt die Reihenfolge zustande?​

Die Ergebnisse der Suche über die Schnittstellen werden primär nach dem Score sortiert. Der Score gibt an, wie gut ein Suchtreffer zu dem eingegebenen Suchtext passt. Bei gleichem Score wird die ID der Leistung herangezogen.

Score​

Der Score setzt sich aus verschiedenen Faktoren zusammen. Um den Score zu berechnen, werden die folgenden Felder (Deutsch und Englisch) berücksichtigt In der Leistungsbeschreibung und Spezialisierung (unabhängig von der spezialisierten GebietsID):

• Leistungsbezeichnung (Leistungstextmodul Code 02)
• Leistungsbezeichnung II (Leistungsname) (Leistungstextmodul Code 03)
• Volltext (Leistungstextmodul Code 06)
• Teaser (Leistungstextmodul Code 24)
• UrsprungsportalModul – Titel
• BegriffImKontext – Begriff

In Onlinediensten:

• Bezeichnung des Onlinedienstes (nicht Name des Onlinedienst-Links)
• Beschreibung des Onlinedienstes (nicht Name des Onlinedienst-Links)

Dabei werden Schreibfehler in der Suche ausgeglichen und es wird bei Leistungsbezeichnungen auch in Teilen von Wörtern gesucht (z.B. ist die Suche nach „Wahl“ auch beim Begriff „Wahlschein“ erfolgreich).
Die einzelnen Felder sind dabei unterschiedlich gewichtet und die Ergebnisse jeden Eintrags werden relativ zu allen vorhandenen Leistungen bewertet, um den Score zu erstellen.

ID der Leistung​

Die berücksichtigte ID setzt sich zusammen aus der SchemeAgencyID des Redaktionssystems und der vom Redaktionssystem vergebenen ID. Bei einer Sortierung nach ID werden also alle Leistungen eines Redaktionssystems zusammen ausgegeben (aufgrund der übereinstimmenden SchemeAgencyID).

Wie kann die Reihenfolge durch das Redaktionssystem beeinflusst werden?​

Das Redaktionssystem kann auf verschiedenen Wegen Einfluss auf die Berechnung des Scores nehmen. Da der Algorithmus aber sehr komplex und vielschichtig ist und die Scores auf Basis der gesamten Datenbank und nicht nur auf einem einzelnen Datensatz berechnet werden, kann nicht konkret vorhergesagt werden, wie sich einzelne Anpassungen auf den Score eines Eintrags auswirken. Um die Reihenfolge zu bearbeiten, können Redaktionssysteme testweise Anpassungen an einzelnen berücksichtigten Modulen vornehmen. Anschließend kann an der Suchdienst API geprüft werden, ob sich die Reihenfolge durch die vorgenommenen Anpassungen geändert hat.

Wie kann Feedback gegeben werden?​

Sollte auffallen, dass Ergebnisse der Suchdienst API häufig in nicht gewünschter Reihenfolge zurückgeliefert werden oder sich ein anderes Vorgehen für einen der beschriebenen Fälle gewünscht werden, kann dies gerne an den PVOG Support gemeldet werden. Dies kann über das Helpdesk Formular auf dem Produktportal passieren oder durch eine Mail an dataportpvogsupport@dataport.de. Bei einem größeren festgestellten Bedarf können hier alternative Lösungswege evaluiert werden, z.B. dass auch die Organisationseinheiten auf Detail-Seiten eine bestimmte Ordnung bekommen. Hier könnten bspw. Organisationseinheiten mit kommunaler Verantwortung über Organisationseinheiten auf Landesebene zurückgegeben werden.

Die Umstellung der PVOG-Produktivumgebung auf die neue Domain pvog.fitko.net erfolgt am 02.02.2026. Nachfolgend erhalten Sie den genauen Zeitplan sowie wichtige Hinweise zum Ablauf:

Zeitlicher Ablauf am 02.02.2026​

• Ab 7:30 Uhr:

  Die Redaktionssysteme werden angehalten. Ab diesem Zeitpunkt nimmt das PVOG keine aktualisierten Daten an, bis der Umzug abgeschlossen ist.

• Suchdienst:

  Der Suchdienst bleibt während der gesamten Umstellung verfügbar. Die neue Domain (pvog.fitko.net) und die bisherige Domain (pvog.fitko.de) werden für mehrere Wochen parallel produktiv betrieben. Ein zeitgenauer Umstieg ist daher nicht erforderlich. Während des Parallelbetriebs wird in den HTTP-Responses ein entsprechender Header zur Kennzeichnung gesendet.

• Geplanter Schwenk:

  Der Schwenk auf die neue Domain ist für den Zeitraum zwischen ca. 14:00 und 15:00 Uhr vorgesehen. Bitte beachten Sie, dass der Schwenk auch zu einem späteren Zeitraum passieren kann.

• Bereitstelldienst:

  Während des eigentlichen Schwenks ist der Bereitstelldienst nicht erreichbar. Bis zum Schwenk ist die alte Domain (pvog.fitko.de) verfügbar. Nach Abschluss des Schwenks müssen die Daten vom Bereitstelldienst über die neue Domain (pvog.fitko.net) abgerufen werden.

Wichtige Hinweise:

• Bitte prüfen Sie, ob Sie PVOG-Endpunkte in eigenen Anwendungen oder Prozessen nutzen, und stellen Sie sicher, dass die Zugriffe nach dem Schwenk auf die neue Domain umgestellt werden.
• Informieren Sie ggf. Ihre technischen Ansprechpartner und Entwicklerteams über den Ablauf und die notwendigen Anpassungen.
• Weitere Informationen zum Domainumzug finden sich im Blogbeitrag Umzug auf pvog.fitko.net.

Für Rückfragen stehen wir Ihnen selbstverständlich gerne unter dataportpvogsupport@dataport.de zur Verfügung.

Vielen Dank für Ihre Aufmerksamkeit und Unterstützung!

Mit jeder neuen Version (Release) vom PVOG wird auch der XZuFi-Konverter auf openCode aktualisiert. Damit Sie den Konverter problemlos nutzen können, ist es wichtig, dass die Version des Konverters zur PVOG-Version der Umgebung (Demo - Stage/Prod - Prod) passt.

Um die Zuordnung zu erleichtern, wurde ab Release 9.1 ein sogenanntes „Tag“ eingeführt.

• Dieses Tag finden Sie auf openCode unter folgendem Link: openCode–XZuFi-Konverter Tags
• In der jeweiligen Release Note ist genau beschrieben, welche Koverter Version zu diesem PVOG-Release gehört.

Ein Beispiel: Für das PVOG-Release 9.2.1 benötigen Sie den Konverter mit der Version / dem Tag 1.6.5.

Hier zeigen wir die Verknüpfung zu openCode:

Der Konverter kann direkt heruntergeladen werden.

Welche PVOG-Version aktuell auf Ihrer Umgebung installiert ist, können Sie jederzeit im Releasekalender nachsehen. Diese Übersicht wird regelmäßig aktualisiert und enthält immer das Datum der letzten Änderung.

Nutzen Sie für neue Anfragen gerne den direkten Weg über das Produktportal!

Unter Ressourcen/Helpdesk findet sich ein Formular, über welches eine Anfrage für den PVOG Support erstellt werden kann. Hier müssen Name und E-Mail-Adresse neben einer Zusammenfassung und dem Anliegen mitgegeben werden. Analog zum Kontakt per Mail wird dadurch in unserem Helpdesk ein Ticket eröffnet. Die weitere Kommunikation zur Bearbeitung der Anfrage läuft im Regelfall über Mails.

Die Mail-Adresse dataportpvogsupport@dataport.de ist selbstverständlich weiterhin erreichbar. Auch diese Nachrichten laufen über das Ticketsystem des Helpdesks.

Es ist geschafft! Seit dem 30.6.2025 verarbeitet das PVOG mit Release 9.1.2 in der Produktivumgebung XZuFi 2.3.1 Daten. Als erstes Redaktionssystem liefert Bremen täglich Daten im XZuFi 2.3.1 Format.

Am Bereitstelldienst können XZuFi 2.3.1 Daten abgerufen werden. Die Details zum Abruf sind in der Beschreibung des Endpunktes auf dem Produktportal erläutert.

Auch der Suchdienst unterstützt jetzt die Verarbeitung von XZuFi 2.3.1 Daten. Neue JZuFi Endpunkte ermöglichen den Abruf in beiden XZuFi Standards. Siehe dazu auch die überarbeitete OpenAPI Dokumentation im Produktportal.

Die gelieferten XZuFi Daten werden in beide Richtungen konvertiert. Das bedeutet, vorhandene 2.2 Daten werden beim 2.3.1 Abruf konvertiert. In die andere Richtung werden gelieferte 2.3.1 Daten beim XZuFi 2.2 Abruf konvertiert. Durch die Weiterentwicklung des Standards kann es dabei zu Informationsverlusten kommen. Die aktuellen Konvertierungsregeln sind in openCode veröffentlicht, dürfen dort gerne von Ihnen kommentiert werden, und werden ständig im Rollout weiterentwickelt.

Wir freuen uns auf den Austausch mit den liefernden Redaktionssystemen der Länder und der nachnutzenden Portale, um den neuen Standard XZuFi 2.3.1 in die Praxis zu bringen!

Im Rahmen der Umstellung auf hochverfügbares PVOG übernehmen wir zum 4.6.25 die Vorgaben des FITKO-Domain Konzeptes für die Erreichbarkeit der Umgebungen:

• stage.pvog.fitko.net (ab 4.6.25)
• pvog.fitko.net (ab 10/25)

Die Demo-Umgebung inkl. aller Dienste und Endpunkte wird nur noch mittelfristig zur Verfügung stehen.

Zum Herbst 2025 wird die PreProd/Stage-Umgebung aufgewertet und der Zugriff auf die Demo-Umgebung für regelmäßige Tests der Redaktionssysteme und angeschlossenen Systeme eingeschränkt.

In Vorbereitung der Aufwertung leiten wir die Adresse stage.pvog.fitko.net auf die aktuelle Demo-Umgebung. Das bedeutet für Sie:

• Ab dem 4.6.25 erreichen Sie die Demo-Umgebung unter der neuen Adresse stage.pvog.fitko.net
• Im Herbst migrieren wir die aktuellen Demo-Daten in die PreProd/Stage Umgebung und Sie können ohne weitere Änderungen in der "neuen" PreProd/Stage-Umgebung weiterarbeiten.
• Die bestehende PreProd/Stage-Umgebung ist bis zur Aufwertung erreichbar unter pvog-preprod.fitko.de

Hier die visuelle Darstellung:

Die positiv verlaufenden Tests in der Nutzung des PVOGs mit XZuFi 2.3.1. Funktionalität geben uns die Möglichkeit, die reguläre Releaseplanung wieder aufzunehmen.

Am 17.06.2025 wird das PVOG Release 9.0 mit der parallelen Verarbeitung von XZuFi 2.2 und XZuFi 2.3.1 erstmalig auf der Demo-Umgebung installiert, um dann im gewohnten Prozess über die PreProd/Stage-Umgebung (24.6.2025), ab 30.06.2025 auf der Produktivumgebung zur Verfügung zu stehen.

Damit ist ein großer Meilenstein erreicht. Den aktuellen Releasekalender finden Sie auf dem Produktportal.

Für die ersten XZuFi 2.3.1 Tests der Redaktionssysteme und angeschlossenen Systeme nutzen Sie gern unsere PreView-Umgebung. Sprechen Sie uns gern an - dataportpvogsupport@dataport.de.