DCAT-AP.de Download

Die mit smart.finder SDI verwalteten Metadatensätze können im DCAT-AP.de -Format heruntergeladen werden. Hierzu muss smart.finder SDI in Kombination mit der Open Source Software DCAT-AP.de-Bridge betrieben werden.

Aktuell ist smart.finder SDI mit Version 2.3.0 der DCAT-AP.de-Bridge kompatibel.

Damit Metadatensätze im DCAT-AP.de-Format heruntergeladen werden können, müssen folgende Punkte zutreffen:

  • Die smart.finder SDI-App ist so konfiguriert, dass sie die DCAT-AP.de-Bridge verwenden kann.

  • Der Metadatensatz hat die Sichtbarkeit public oder stammt aus einem externen Katalog.

  • Der Metadatensatz besitzt das Schlüsselwort opendata.

  • Der Metadatensatz ist vom Typ dataset oder series.

Konfiguration der DCAT-AP.de-Bridge

Laden Sie die DCAT-AP.de-Bridge von GitHub herunter und folgen Sie den Anweisungen zur Installation. Die Konfigurationsdatei der DCAT-AP.de-Bridge lautet camel-oai-pmh.properties. Für die Verwendung mit smart.finder SDI sind folgende Properties in dieser Datei zu konfigurieren:

db.item.csw.URL

Die URL auf die CSW-Schnittstelle des smart.finder SDI

db.item.csw.hopCount

Die Tiefe der Suchanfrage gegen externe Kataloge.

Damit Metadaten aus externen Katalogen heruntergeladen werden können, muss der Wert auf 1 gesetzt werden. Der Wert 0 bedeutet, dass nur lokale Metadaten für die DCA-AP.de-Bridge verwendet werden. Der Standardwert der DCAT-AP.de-Bridge ist 0.

Konfiguration der smart.finder SDI-App

Um diese Funktion zu aktivieren, müssen Sie das Bundle sfsdi_dcat-ap-download in Ihre App einbinden.

Der Name der Standard-App von smart.finder SDI lautet full-page-sdi. Wenn Sie smart.finder SDI im Standalone Modus betreiben, finden Sie diese unter [TOMCAT_HOME]/webapps/smartfinder-sdi/js/apps/full-page-sdi. Wenn Sie smart.finder SDI in map.apps betreiben, erreichen Sie die App über den map.apps Manager.

Konfiguration

  1. Ergänzen Sie in der app.json-Datei für Ihre App das Bundle sfsdi_dcat-ap-download:

    {
     "load": {
        "allowedBundles": [
            "BundleA",
            "BundleB",
            "Bundle...",
            "sfsdi_dcat-ap-download"
        ]
     }
    }
  2. Konfigurieren Sie die Variable dcatbridge.url in der application.properties-Datei von smart.finder SDI:

    dcatbridge.url=https://dcat-bridge.example.com

    Alternativ können Sie in der app.json an der DcatApDownloader-Komponente die Property urlTemplate konfigurieren:

    {
      "bundles": {
        "sfsdi_dcat-ap-download": {
          "DcatApDownloader": {
            "urlTemplate": "@@dcatbridge.url@@/omdf/gp-csw/rdf/${id}.rdf"
          }
        }
      }
    }

    Ersetzen Sie die Variable @@dcatbridge.url@@ durch die URL Ihrer DCAT-AP.de-Bridge. Achten Sie darauf, dass der anschließende Pfad und insbesondere die Variable ${id} erhalten bleiben. Die Variable wird zur Laufzeit automatisch durch die ID des herunterzuladenden Metadatendokuments ersetzt.

Konfigurationsparameter der Komponente DcatApDownloader

Eigenschaft Standardwert Beschreibung

urlTemplate

@@dcatbridge.url@@/omdf/gp-csw/rdf/${id}.rdf

Optional. Zeichenkette, die die Vorlage für die URL zu einem DCAT-AP.de-Metadatendokument definiert. Die darin enthaltene Variable @@dcatbridge.url@@ wird zur Laufzeit mit dem Wert der Eigenschaft dcatbridge.url aus der application.properties-Datei von smart.finder SDI ersetzt. Anstatt die Variable urlTemplate in der app.json zu konfigurieren, sollte deshalb vorzugsweise die Variable dcatbridge.url in der application.properties-Datei gesetzt werden.

Die Variable ${id} wird zur Laufzeit automatisch durch die ID des herunterzuladenden Metadatendokuments ersetzt und muss nicht separat konfiguriert werden.

Wenn Sie die DCAT-AP.de-Bridge auf einem anderen Host oder Port als smart.finder SDI betreiben, müssen Sie die URL der DCAT-AP.de-Bridge dem Konfigurationsparameter proxy.allowedServerUrls hinzufügen. Ansonsten wird die Anfrage an die DCAT-AP.de-Bridge aufgrund von CORS Fehlern blockiert.