PVOG – ein Produkt der Fitko
EntwicklungsressourcenFöderale IT-StandardsQuellcode
Zum Hauptinhalt springen

Reihenfolge der Suchdienst Ergebnisse

3 Minuten Lesezeit

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.

Wartungsarbeiten für Deployments PVOG Release 9.13

Eine Minute Lesezeit

Die planmäßigen Deployments für PVOG Release 9.13 finden an folgenden Tagen zwischen 7:30 Uhr und 9:00 Uhr statt:

  • 10.02.2026 (Dienstag) - Demo-Umgebung (stage.pvog.fikto.net)
  • 17.02.2026 (Dienstag) - PreProd/Stage-Umgebung (pvog-preprod.fitko.de)
  • 24.02.2026 (Dienstag) - Prod-Umgebung (pvog.fitko.net)

Im Regelfall sollte dies nicht zu Beeinträchtigungen führen.

Falls es in diesem Zeitraum zu kurzfristigen Beeinträchtigungen kommt, bitten wir dies zu entschuldigen. Sollten Sie Fragen haben, wenden Sie sich gern an den PVOG Support unter dataportpvogsupport@dataport.de.

Parallel zu den Blogbeiträgen werden die Wartungsarbeiten per Mail an den Verteiler der Anbindungsteilnehmer versandt. Wenn Sie keine E-Mail erhalten, aber Informationen zur Verfügbarkeit des PVOG benötigen, nehmen wir Sie gern in den Verteiler auf.

Die ReleaseNote zum Release 9.13 wird nach dem Demo Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

Umzug auf pvog.fitko.net - Zeitlicher Ablauf

2 Minuten Lesezeit

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!

API Keys

Eine Minute Lesezeit

Die Verwendung von API Keys ermöglicht schnellere und zielgerichtetere Unterstützung durch den PVOG Support bei Problemen oder API‑Änderungen.

API Keys können über das Formular auf dem Produktportal angefordert werden.

Zusätzlich ermöglicht die Nutzung von API Keys eine bessere Möglichkeit zur Benachrichtigung und Betreuung der API‑Konsumenten bei wichtigen Änderungen. Weitere Informationen sind hier auf dem Produktportal nachlesbar.

Wartungsarbeiten für Deployments PVOG Release 9.12

Eine Minute Lesezeit

Die planmäßigen Deployments für PVOG Release 9.12 finden an folgenden Tagen zwischen 7:30 Uhr und 13:00 Uhr statt:

  • 20.01.2026 (Dienstag) - Demo-Umgebung (stage.pvog.fikto.net)
  • 27.01.2026 (Dienstag) - PreProd/Stage-Umgebung (pvog-preprod.fitko.de)
  • 02.02.2026 (Montag) - Prod-Umgebung (pvog.fitko.de)

In diesem Release wird es während des Deployments auf der Prod-Umgebung zu Beeinträchtigungen kommen. Grund hierfür ist der Umzug auf den Hochverfügbarkeitscluster.

Die entstehenden Beeinträchtigungen bitten wir zu entschuldigen. Sollten Sie Fragen haben, wenden Sie sich gern an den PVOG Support unter dataportpvogsupport@dataport.de.

Parallel zu den Blogbeiträgen werden die Wartungsarbeiten per Mail an den Verteiler der Anbindungsteilnehmer versandt. Wenn Sie keine E-Mail erhalten, aber Informationen zur Verfügbarkeit des PVOG benötigen, nehmen wir Sie gern in den Verteiler auf.

Die ReleaseNote zum Release 9.12 wird nach dem Demo Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

Wartungsarbeiten für Deployments PVOG Release 9.11

Eine Minute Lesezeit

Achtung! Abweichender Releaseprozess zum Jahresbeginn!

Die planmäßigen Deployments für PVOG Release 9.11 finden an folgenden Tagen zwischen 7:30 Uhr und 9:00 Uhr statt:

  • 7.1.2026 (Mittwoch) - Demo-Umgebung (stage.pvog.fikto.net)
  • 12.1.2026 (Montag) - PreProd/Stage-Umgebung (pvog-preprod.fitko.de)
  • 15.1.2026 (Donnerstag) - Prod-Umgebung (pvog.fitko.de)

Im Regelfall sollte dies nicht zu Beeinträchtigungen führen.

Falls es in diesem Zeitraum zu kurzfristigen Beeinträchtigungen kommt, bitten wir dies zu entschuldigen. Sollten Sie Fragen haben, wenden Sie sich gern an den PVOG Support unter dataportpvogsupport@dataport.de.

Parallel zu den Blogbeiträgen werden die Wartungsarbeiten per Mail an den Verteiler der Anbindungsteilnehmer versandt. Wenn Sie keine E-Mail erhalten, aber Informationen zur Verfügbarkeit des PVOG benötigen, nehmen wir Sie gern in den Verteiler auf.

Die ReleaseNote zum Release 9.10 wird nach dem Demo Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.

Validator API – neue Endpunkte

2 Minuten Lesezeit

Die Hauptaufgabe des Validators besteht in der technischen und fachlichen Prüfung der XZuFi-Dokumente, die über den Sammlerdienst in den Datenbestand des PVOG übernommen werden sollen. Dabei werden sowohl die Validierungsregeln als auch die technische Funktionalität der PVOG-Komponente Validator kontinuierlich weiterentwickelt, um eine zuverlässige und präzise Datenkontrolle zu gewährleisten.

Die Redaktionssysteme können zu übermittelnde Daten mithilfe spezieller Schnittstellen direkt gegen den Validator prüfen, bevor sie an den Sammlerdienst gesandt werden. Diese Validierung kann entweder manuell über den Validator Service oder maschinell per Validator APIs jeweils pro PVOG Umgebung erfolgen. Die Prüfergebnisse liegen direkt vor.

Im November 2025 wurden im Zuge dieser Weiterentwicklung zwei neue Validator Endpunkte eingeführt, die nicht abwärtskompatibel sind und speziell auf die Anforderungen technischer Dienstleister mehrerer Redaktionssysteme zugeschnitten sind.

Diese Umstellung auf die SchemeAgencyID dient der verbesserten Datenkontrolle und Systemzuordnung. Gleichzeitig wurde angekündigt, dass die bisherigen Schnittstellen validator-backend/api/v5/validiere und validator-backend/api/v6/validiere bis Mai 2026 abgekündigt werden, was eine Umstellung auf die neuen Endpunkte erforderlich macht.

Die Nutzung der Validator-Schnittstellen ist nicht öffentlich zugänglich, sondern setzt einen Benutzer mit entsprechendem Authentifizierungstoken voraus, um die Sicherheit und Integrität der Datenverarbeitung zu gewährleisten.

Redaktionssysteme, die Interesse an einem Zugang zum Validator Service oder einem automatisierten Abruf der Validatorergebnisse haben, werden gebeten, sich an den PVOG Support zu wenden, um entsprechende Zugänge und Unterstützung zu erhalten.

Für Nutzer des manuellen Validator-Services ergeben sich durch die Einführung der neuen Endpunkte keine Änderungen, sodass der bisherige Workflow unverändert fortgeführt werden kann.

Informationen zum PVOG auf dem Produktportal

2 Minuten Lesezeit

Das Portalverbund Online-Gateway (PVOG) fungiert als integrative Plattform, die die Verwaltungsportale und Redaktionssysteme des Bundes sowie der Länder miteinander verknüpft und kontinuierlich weiterentwickelt wird. Die fortlaufende Entwicklung des PVOG wird transparent gestaltet, indem Interessierte die Möglichkeit erhalten, diese Prozesse in regelmäßigen Veranstaltungen wie der monatlichen UserGroup sowie dem Sprint Review am Ende jedes Entwicklungszyklus, jeweils donnerstags, zu verfolgen und aktiv zu begleiten.

Für fachliche Rückfragen zur Funktionsweise des PVOG, den Zugriffsmöglichkeiten auf die bereitgestellten Daten sowie allgemeine Anliegen steht der PVOG Support über den Helpdesk des Produktportals PVOG Helpdesk | PVOG Produktportal oder per E-Mail zur Verfügung.

Das Produktportal des PVOG wird zukünftig als umfassende Informationsquelle erweitert. Was ist neu?

  • Der Bereich Dienste / Bereitstelldienst wurde um FAQ ergänzt. Hier wird zum Beispiel die Frage beantwortet, wer Zugriff auf die PVOG Daten über den Bereitstelldienst bekommen kann.
  • Die Antworten im Bereich Dokumentation / FAQ haben den Fokus auf allgemeine Fragen zum PVOG, wie zum Beispiel die Releaseplanung.
  • Im Glossar werden einzelne Begriffe erläutert. Melden Sie sich gern, wenn für Sie relevante Begriffe nicht enthalten sind.
  • Um die Anliegen der UserGroup und die angesprochenen Themen des monatlichen Treffens für Interessierte zu veröffentlichen, wurde dieser Bereich des Produktportals um die Präsentationen und Protokolle der letzten sechs Treffen ergänzt. Hier finden Sie auch den Termin der nächsten User Group.
  • Das Sprint Review am Ende jedes Sprint berichtet über die technische Weiterentwicklung des PVOGs. Um auch hier die Informationen weiter zu verbreiten, sind die Präsentationen des Sprint Reviews als Download einsehbar.

Technische Erkennung abgekündigter Schnittstellen

Eine Minute Lesezeit

Das PVOG wird kontinuierlich in seinen Komponenten weiterentwickelt; auch hinsichtlich der Schnittstellen, über die Daten aus den Redaktionssystemen abgerufen und bereitgestellt werden.

Die Weiterentwicklung der Schnittstellen manifestiert sich in der Einführung neuer API-Versionen bei größeren Verbesserungen. Dies führt dazu, dass ältere API-Versionen nach einem definierten Zeitraum abgeschaltet werden, um die Schnittstellen effizient mit neuen Funktionalitäten erweitern zu können.

Die Abschaltung veralteter API-Versionen ist somit ein notwendiger Schritt zur Sicherstellung der Weiterentwicklung und Modernisierung der Schnittstellen.

Nutzer werden über die Abkündigung (Deprecation) von Schnittstellen auf mehreren Wegen informiert:

Header Darstellung beispielhaft im Suchdienst

Technisch signalisiert eine als deprecated gekennzeichnete API in der Antwort den Header „x-pvog-deprecated: true“, während aktuelle Schnittstellen diesen Header nicht enthalten. Dies ermöglicht eine automatisierte Erkennung veralteter Schnittstellen durch die Nutzer.

(Text überarbeitet von LLMoin)

Wartungsarbeiten für Deployments PVOG Release 9.10

Eine Minute Lesezeit

Achtung! Abweichender Releaseprozess wegen Jahresende!

Die planmäßigen Deployments für PVOG Release 9.10 finden an folgenden Tagen zwischen 7:30 Uhr und 13:00 Uhr statt:

  • 3.12.2025 (Mittwoch) - Demo-Umgebung (stage.pvog.fikto.net)
  • 8.12.2025 (Montag) - PreProd/Stage-Umgebung (pvog-preprod.fitko.de)
  • 11.12.2025 (Donnerstag) - Prod-Umgebung (pvog.fitko.de)

Im Regelfall sollte dies nicht zu Beeinträchtigungen führen.

Falls es in diesem Zeitraum zu kurzfristigen Beeinträchtigungen kommt, bitten wir dies zu entschuldigen. Sollten Sie Fragen haben, wenden Sie sich gern an den PVOG Support unter dataportpvogsupport@dataport.de.

Parallel zu den Blogbeiträgen werden die Wartungsarbeiten per Mail an den Verteiler der Anbindungsteilnehmer versandt. Wenn Sie keine E-Mail erhalten, aber Informationen zur Verfügbarkeit des PVOG benötigen, nehmen wir Sie gern in den Verteiler auf.

Die ReleaseNote zum Release 9.10 wird nach dem Demo Deployment auf dem Produktportal unter Neuigkeiten/Release Notes veröffentlicht.