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.