Zum Hauptinhalt springen
Version

1.0.0

Weiterführende Informationen zur Leistung

Fachliche KategorieTechnische Kategorie
Stammdaten der LeistungXZuFi-basierte Parameter ohne direkten Onlinedienst-Bezug

Fachliche Bedeutung​

Angabe von zusätzlichen Informationen zur Leistung ohne speziell strukturierte Daten.

Die weiterführenden Informationen dienen den Nutzern als Auskunft, inwiefern und welche weiterführenden Informationen im Internet bereits veröffentlicht sind. In diesem Rahmen können auf weiterführende Informationen zum Beispiel auch Fachportale, Themenportale oder Broschüren verwiesen werden. Dies soll den Nutzenden tiefergehende Informationen und Umfeld-Informationen liefern. Der Parameter „weiterführende Informationen zur Leistung“ ist ein FIM-Modul und in den Landesredaktionssystemen nicht verpflichtend zu pflegen.

Wertemenge​

Eine komplexe Datenstruktur Textmodul, die die folgenden Elemente enthält:

Für eine detaillierte Darstellung dieser Datenstruktur wird hier auf die XZuFi-Dokumentation (öffnet in neuem Tab) verwiesen.

Verortung im Datenmodell​

Die weiterführenden Informationen werden in einem optionalen Element modulText, das Teil des Elements Leistung ist, abgelegt und mit dem Code "15" aus der Code-Liste urn:de:xzufi:codeliste:leistungstextmodulleika (öffnet in neuem Tab) gekennzeichnet.

Codebeispiel XZuFi 2.2​

info
  • Das folgende Codebeispiel zeigt nicht alle Features des modulText-Elements.
    <xzufi:leistung>

      <xzufi:modulText>
        <xzufi:positionDarstellung>14</xzufi:positionDarstellung>
        <xzufi:inhalt languageCode="de">Weiterführende Informationen zur Leistung</xzufi:inhalt>
        <xzufi:inhalt languageCode="en">Further information on the service</xzufi:inhalt>
        <xzufi:leikaTextmodul listURI="urn:de:xzufi:codeliste:leistungstextmodulleika" listVersionID="20201201">
          <code>15</code>
        </xzufi:leikaTextmodul>
        <xzufi:weiterfuehrenderLink languageCode="de">
          <xzufi:uri>https://www.hamburg.de/service/info/11252980</xzufi:uri>
          <xzufi:titel>Anzeigepflicht nach § 14 Sprengstoffgesetz Informationsseite</xzufi:titel>
        </xzufi:weiterfuehrenderLink>
        <xzufi:weiterfuehrenderLink languageCode="en">
          <xzufi:uri>https://www.hamburg.de/behoerdenfinder/hamburg/11252980</xzufi:uri>
          <xzufi:titel>Obligation to notify according to § 14 Explosives Act Information page</xzufi:titel>
          <xzufi:beschreibung>Currently this link is only available in German</xzufi:beschreibung>
        </xzufi:weiterfuehrenderLink>
      </xzufi:modulText>

    </xzufi:leistung>

Ermittlungsmöglichkeit PVOG API​

Zunächst ermittelt der Onlinedienst die Daten der Leistungsbeschreibung.

In der Response findet sich ein Element modulText[] das Informationen zu verschiedenen Kategorien enthält. Aus diesen Elementen muss der Onlinedienst dasjenige auswählen, bei dem das Element modulText[]:leikaTextmodul:code den Wert 15 enthält und dessen Element modulText[]:gueltigkeit[] leer ist oder mindestens ein Objekt enthält, dessen beginn und ende-Elemente den gewünschten Zeitpunkt umschließen.

Das so identifizerte modulText-Element enthält dann die weiterführenden Informationen.

Ermittlungsmöglichkeit FIT-Connect Routing API​

Der Onlinedienst benutzt den Endpunkt /routes mit den URL-Parametern zur Identifikation des gesuchten Adressaten, z.B. leikaKey = <LeikaId der Leistung> und ars = <ARS des gesuchten Gebiets> und erhält eine JSON-Datenstruktur als Response.

In dieser Datenstruktur enthält das Element route[]:furtherInformation:description die Texte aus dem inhalt-Element der XZuFi-Datenstruktur als internationalisierte Zeichenkette. Die Informationen aus den XZuFi-Elementen leikaTextmodulAbweichendeBezeichnung und weiterfuehrenderLink können nicht über die FIT-Connect Routing API ermittelt werden.

gefahr

Stand Q2/2024 wertet die FIT-Connect Routing API die Elemente modulText[]:gueltigkeit[] nicht aus. Es besteht daher das Risiko, dass die API Informationen liefert, die nicht mehr oder noch nicht gültig sind.

Ermittlungsmöglichkeit DVDV API​

(Der Parameter kann nicht über das DVDV-API ermittelt werden)

Best Practices​

Bezüglich hyperlinkErweitert sind unbedingt die Hinweise zu Internationalisierten Datenstrukturen zu beachten!