Nach oben

Verbinden von Daten und Verwalten von Katalog-Feeds

In diesem Thema

  1. Verwenden von Katalog-Feeds
  2. Konfigurieren und Verwalten von Feeds
  3. Verbinden von Katalogen über Hub-Feeds

Editoren öffentlicher Sites können die für eine ArcGIS Hub-Site verfügbaren Feeds verwenden, um den öffentlichen Inhaltskatalog der Site mit externen Katalogen zu verbinden. Katalog-Feeds erleichtern die Interoperabilität zwischen Datenkatalogen und können die Auffindbarkeit über Suchmaschinen und Kataloge von Drittanbietern verbessern. Manager und Besucher können zum Überwachen von Änderungen an Inhaltskatalogen Feeds abonnieren.

Verwenden von Katalog-Feeds

Mithilfe von Hub-Feeds können Sie über Änderungen an einem Site-Katalog, wie z. B. neu hinzugefügte Inhalte, auf dem Laufenden bleiben. Für alle öffentlichen Hub-Sites mit öffentlichen Katalogelementen wird die Schaltfläche Feeds erkunden auf der Site-Fußzeile und auf der Suchoberfläche angezeigt. Zwar sind Feeds für alle öffentlichen Sites standardmäßig aktiviert, Site-Editoren können Feeds für öffentliche Sites jedoch deaktivieren. Wählen Sie die Schaltfläche Feeds erkunden, um die Feed-URL und die API-Erkunden-Seiten der Site anzuzeigen. Hub unterstützt folgende Feeds:

  • RSS (<Site-URL>/api/feed/rss/2.0)
  • DCAT US 1.1 (<Site-URL>/api/feed/dcat-us/1.1.json)
  • DCAT AP 2.1.1 (<Site-URL>/api/feed/dcat-ap/2.1.1.json)
  • OGC-API – Records (<siteURL>/api/search/definition)

RSS-Feeds

RSS (Really Simple Syndication) ist ein Format für Web-Feeds, mit dem häufig aktualisierte Inhalte in standardisierter Form veröffentlicht werden können, sodass Benutzer diese automatisch abonnieren und Aktualisierungen erhalten können. RSS-Feeds enthalten allgemeine Metadaten, z. B. Titel, Beschreibung und Veröffentlichungsdatum, für alle öffentlich verfügbaren Inhalte, die für die Site freigegeben wurden. Benutzer können damit über Änderungen am Suchkatalog auf dem Laufenden bleiben. Der Feed kann auch per Pull in einen RSS-Reader (Aggregator) übertragen werden, um die Inhalte auf einer anderen Site anzuzeigen. Hub entspricht der GeoRSS-Spezifikation.

DCAT-Feeds

Jede Site verfügt über einen Inhaltskatalog, der die Elemente enthält, die Sie über die Site freigeben möchten. Die Verwendung von DCAT zur Beschreibung von Kataloginhalten kann die Auffindbarkeit verbessern und Anwendungen den Zugriff auf Metadaten aus mehreren Katalogen ermöglichen. Außerdem ermöglicht es die Suche nach Datasets über verschiedene Kataloge hinweg.

Verbinden Sie den Katalog Ihrer Site, indem Sie eine öffentliche Feed-Ausgabe-URL freigeben, die automatisch für jede öffentliche Hub-Site generiert wird. Hub unterstützt zwei DCAT-Feeds: DCAT US 1.1. und DCAT AP 2.1.1. Dieser Katalog-Feed (z. B. www.yourhubsite.gov/api/feed/dcat-us/1.1.json) ist mit DCAT US 1.1 konform. Sie können auch den Inhalt Ihres Site-Katalogs mit dem DCAT-Konfigurationseditor in Hub bearbeiten.

Tipp:

Nur öffentlich freigegebene Datenelemente und deren Layer werden im <DCAT type>.json-Katalog angezeigt. Private Inhalte in Ihrer Organisation können derzeit nicht mit der DCAT-Katalogmethode freigegeben oder verbunden werden.

OGC-API – Records

Verwenden Sie die OGC-API – Records, um räumliche Ressourcen über standardisierte Sammlungen und Ressourcen-Metadaten zu erkunden. Sie können den Katalog einer Hub-Site programmgesteuert abfragen, filtern und durchsuchen, einschließlich öffentlicher und privater Elemente (sofern Sie über ein gültiges Token für private Elemente verfügen). Mit dem OGC-API – Records-Explorer können Sie API-Endpunkte testen und einen Katalog durchsuchen, ohne die Suchoberfläche des Site-Clients nutzen zu müssen. Zu den gängigen Anwendungsmöglichkeiten zählen das Rendern von Features auf einer Karte in anderen Werkzeugen wie ArcGIS Online Map Viewer, GIS-Desktop-Anwendungen, OWSLib usw.

Konfigurieren und Verwalten von Feeds

Feeds sind für öffentliche Sites verfügbar, deren Katalog öffentliche Inhalte enthält. Site-Manager können in den Formaten DCAT US 1.1, DCAT AP 2.1.1 und RSS festlegen, welche Attribute und Werte auf den Ausgabe-Feed einer Site angewendet werden. Sie können die Standardkonfiguration von Hub beibehalten oder bestimmte Felder/Attribute selbst konfigurieren. Im Feed-Editor müssen Sie gültige Schlüssel angeben, die den Metadaten eines Datensatzes entsprechen. Feeds sind standardmäßig verfügbar, können jedoch im Workspace der Site deaktiviert werden.

Führen Sie die folgenden Schritte aus, um Feeds zu konfigurieren und zu verwalten:

  1. Öffnen Sie eine Site im Bearbeitungsmodus.
  2. Wählen Sie die Schaltfläche Site verwalten Einstellungen aus, um den Workspace der Site zu öffnen.
  3. Wählen Sie Einstellungen und dann den Bereich Feed aus.
  4. Wählen Sie Feeds aktivieren aus, um Feeds zu aktivieren. Wählen Sie unter Feeds einen Feed-Typ aus.
  5. Kopieren Sie den Code, und fügen Sie ihn im Editor Konfiguration an einer beliebigen Stelle nach einem Komma und vor der letzten Klammer ein.
    Hinweis:

    Einige Attribute können nicht bearbeitet werden.

    Tipp:

    Die Vorlage für RSS-Feeds verfügt über eine andere Struktur, die das Hinzufügen eines Schlüssels auf oberster Ebene nicht zulässt.

  6. Wählen Sie Speichern aus.

RSS-Feed-Konfiguration

Hub-Site-Editoren können festlegen, welche Metadaten angezeigt werden. Das heißt, dass sie die Standardwerte in den Metadaten überschreiben und Werte, die für Aktualisierungen durch Benutzer relevant sind, angeben können. Beispielsweise kann ein Site-Editor konfigurieren, dass bei Inhaltsaktualisierungen Metadatenwerte hervorgehoben und eine kurze Beschreibung sowie die verknüpfte geographische Position angezeigt werden.

Beispiel für das DCAT-Standardschema

Hub verwendet ein in JSON geschriebenes Schema, um zu bestimmen, welche Metadateneigenschaften für jeden Datensatz im entsprechenden Feed erscheinen. Nachfolgend ist das Standardschema gemäß DCAT US 1.1 abgebildet. Es enthält Schlüssel/Wert-Paare wie "title”: “{{name}}” und “description”: {{description}}. Für jeden Datensatz im Feed werden der Schlüssel ("title") und der als Vorlage verwendete Wert ("<Metadatentitel des Elements>") angezeigt. Der Entwurf des Schemas basiert auf der einfachsten Zuordnung zwischen den Metadaten des ArcGIS-Elements und dem Standard DCAT US 1.1.

Standardschema gemäß DCAT US 1.1

{
	"title": "{{name}}",
	"description": "{{description}}",
	"keyword": "{{tags}}",
	"issued": "{{created:toISO}}",
	"modified": "{{modified:toISO}}",
	"publisher": {
		"name": "{{source}}"
	},
	"contactPoint": {
		"fn": "{{owner}}",
		"hasEmail": "{{orgContactEmail}}"
	},
	"spatial": "{{extent}}"
}

Sie können das Attribut "spatial" von DCAT-US- und DCAT-AP-Feeds bearbeiten. In Hub wird in neuen Vorlagen (standardmäßig) die Elementausdehnung verwendet. Bei Elementen ohne Ausdehnungswert wird das räumliche Attribut entfernt. Sie können den Wert "spatial" durch den Alternativwert "spatial": "{{extent || 'SPATIAL_FALLBACK'}}" außer Kraft setzen und die Standardvorlage aktualisieren.

Beispiele für ein benutzerdefiniertes DCAT-Schema

Sie können das Schema anpassen, indem Sie Schlüssel/Wert-Paare hinzufügen, aktualisieren oder entfernen. Je nach Feed-Typ können einige Schlüssel nicht bearbeitet werden. Nachfolgend ist ein Beispiel für ein benutzerdefiniertes Schema gemäß DCAT US 1.1 abgebildet, das mehrere Änderungen enthält, darunter folgende:

  • Hinzufügen eines Schlüssel/Wert-Paares
  • Aktualisieren eines Schlüssel/Wert-Paares
  • Hinzufügen eines Fallbacks für ein Schlüssel/Wert-Paar
Tipp:

Die Pflege gültiger Feeds ist für die Interoperabilität und Auffindbarkeit Ihrer öffentlichen Hub-Inhalte unerlässlich. Konsultieren Sie die entsprechenden Ressourcen, bevor Sie Felder hinzufügen oder ändern, da dies dazu führen kann, dass der Feed ungültig wird (Hub überprüft keine Feeds). Ungültige Feeds können zu Problemen beim Verbinden von Kataloginhalten in Sites wie data.gov, data.europa.eu und anderen Orten führen, auf denen Feeds verwendet werden. Überprüfen Sie Ihre Feeds vor und nach der Anpassung mit dem DCAT US 1.1 Validator und dem DCAT AP Validator.

Benutzerdefiniertes Schema gemäß DCAT US 1.1

{
 "title": "{{name}}",
"description": "{{description}}",
	"keyword": "{{tags}}",
	"issued": "{{created:toISO}}",
	"modified": "{{modified:toISO}}",
	"publisher": {
		"name": "{{source}}"
	},
	"contactPoint": {
		"fn": "{{owner}}",
		"hasEmail": "{{orgContactEmail}}"
	},
	"culture": "{{culture}}",
	"summary": "{{snippet}}",
	"platform": "ArcGIS Hub",
	"bureauCode": [
		"010:86",
		"010:04"
	],
	"programCode": [
		"015:001",
		"015:002"
	]
}
Hinweis:

Das benutzerdefinierte Schema gemäß DCAT US 1.1 enthält fünf neue Schlüssel: “culture”, “summary”, “platform”, “bureauCode” und “programCode”. Für die Schlüssel “culture” und “summary” sind Vorlagenwerte vorhanden, die über OGC-API – Records, die neueste Version der Hub-API, abrufen. Die Schlüssel “platform”, “bureauCode” und “programCode” verfügen über Literalzeichenfolgewerte.

Beispiele für benutzerdefinierte Werte

In vielen Fällen möchten Site-Manager die Metadaten, die in einem Feed angezeigt werden, auf die Metadatenstandards einer Organisation abstimmen. Ein Schlüssel kann eine beliebige Literalzeichenfolge sein, beispielsweise “title” oder “”, in der Regel sollten Schlüssel jedoch einem Zielmetadatenstandard entsprechen. Die entsprechenden Werte können eine Literalzeichenfolge oder eine Vorlage sein, die einen Schlüssel von OGC-API – Records abruft. Für Vorlagen können Sie jeden von OGC-API – Records zurückgegebenen Schlüssel (oberste Ebene oder geschachtelt) angeben.

Beispiel: Auf der Hub-Feeds-Beispielsite unter dc.esri.com gibt es einen öffentlichen Layer mit dem Titel "USA Weather Watches and Warnings". Sie können JSON-Metadaten für dieses Dataset anzeigen, indem Sie über OGC-API – Records (https://hub.arcgis.com/api/search/v1/collections/all/items/c7a223914778420db8bf000b4eb6ec6f) oder https://hub.arcgis.com/api/search/v1/collections/all/items?id=c7a223914778420db8bf000b4eb6ec6f auf die Layer-ID c7a223914778420db8bf000b4eb6ec6f zugreifen.

Wenn Sie auf die obige Beispiel-API-Antwort zugreifen, sollten Sie eine JSON-Antwort sehen, die wie folgt beginnt:

Beispiel für benutzerdefinierte Werte gemäß DCAT US 1.1

"data": 
{
    "id": "c7a223914778420db8bf000b4eb6ec6f",
    "type": "dataset",
    "attributes": {
        "errors": [],
        "access": "public",
        "additionalResources": [],
  …
}

Wenn Sie einen Bildlauf nach unten ausführen, sehen Sie weitere Schlüssel, die Sie auswählen und als Vorlagenwerte im Editor verwenden können, wie z. B. "created", mit dem das Erstellungsdatum des Inhalts angegeben wird. Zum Verwenden eines Wertes aus OGC-API – Records fügen Sie im Feed-Editor einen Vorlagenwert für einen beliebigen OGC-API – Records-Schlüssel unter “attributes” ein. Wenn Sie beispielsweise "created" in Ihre Feed-Datensätze aufnehmen möchten, können Sie wie im folgenden Beispiel vorgehen:

Beispiel für benutzerdefinierte Werte gemäß DCAT US 1.1

{
…
 	"bureauCode": ["010:86","010:04"],
 	"programCode": ["015:001","015:002"],
 	"created": 1610151009000,
…
}
Im oben angeführten Beispiel müssten Sie dem benutzerdefinierten DCAT US 1.1-Schema die folgenden Zeilen hinzufügen:
{
…
  "bureauCode": [
   "010:86",
   "010:04"
],
  "programCode": [
   "015:001",
   "015:002"
],
  "created": "{{item.created}}"
…
}

Content Manager können einen Feed so konfigurieren, dass er zusätzliche benutzerdefinierte Verteilungen enthält. Sie werden an die vorhandenen Distributionen angefügt, die von Hub für die herunterladbaren Ressourcen eines Inhaltselements automatisch erstellt werden.

Verbinden von Katalogen über Hub-Feeds

Mit Hub-Feed-Editoren können Site-Manager die Beschreibung von Daten standardisieren. Site-Manager können festlegen, welche Metadatenwerte für die einzelnen Datasets des Feeds angezeigt werden sollen, bevor dieser geharvestet wird.

Verbinden mit Data.gov

In den Vereinigten Staaten können Sie Ihre Ausgabe so ändern, dass sie mit großen Data Clearinghouses, wie z. B. dem nationalen Katalog Data.gov, verwendet werden kann. Aufgrund dieser Interoperabilität können Sie diese Drittanbieter-Aggregatoren an die verschiedenen verfügbaren Distributionen eines Datasets verweisen. Distributionen sind Paketformate, die die Nutzung als Web-Service, Download oder API erlauben.

Site-Editoren können wählen, welche Attribute und Werte auf den Ausgabe-Feed gemäß DCAT US 1.1 einer Site angewendet werden sollen. Im Feed-Editor müssen Sie gültige Schlüssel angeben, die den Metadaten eines Datensatzes entsprechen.

Verbinden mit CKAN

Wenn Ihre Organisation Katalogsoftware wie CKAN verwendet oder mit anderen Organisationen arbeitet, die solche Software verwenden, können Sie den Datenkatalog Ihrer Hub-Site damit verbinden. Ihre CKAN-Instanz muss ordnungsgemäß konfiguriert sein, damit das Harvesten von Daten unterstützt wird. Als Erstes müssen Sie zwei Erweiterungen installieren und konfigurieren, die vom CKAN-Team entwickelt und verwaltet und von Data.gov und anderen Plattformen zum Harvesten von Datasets verwendet werden: die CKAN Harvesting-Erweiterung und die CKAN DCAT-Erweiterung.

Stellen Sie sicher, dass die Erweiterungen installiert sind, und prüfen Sie anschließend, ob die Harvester-Services "Gather_Consumer" und "Fetch_Consumer" im Hintergrund ausgeführt werden. In der CKAN-Dokumentation finden Sie weitere Informationen.

Harvesten des ArcGIS Hub-Katalogs

Führen Sie zum Harvesten des -Katalogs die folgenden Schritte aus:

  1. Rufen Sie Ihre CKAN-Harvest-Administratorseite auf, und melden Sie sich bei http://yourCKANinstance/harvest an.
  2. Wählen Sie Add harvest source aus, und geben Sie Informationen zu Ihrer Hub-Site an:
    • Geben Sie <siteURL>/api/feed/dcat-us/1.1.json als URL ein.
    • Geben Sie der Harvest-Quelle einen Titel, der dem Namen Ihrer Site entspricht. Füllen Sie optional das Beschreibungsfeld aus.
    • Wählen Sie DCAT JSON Harvester als Quellentyp aus.
    • Wählen Sie als Aktualisierungsintervall Manual aus.
    • Wählen Sie Speichern aus.
  3. Wählen Sie Admin und anschließend Reharvest aus.
  4. Führen Sie die Harvest-Aufträge auf Ihrer CKAN-Instanz aus.

    CKAN verarbeitet Ihre .json-Datei und berücksichtigt alle Ihre Datasets. Die Harvest-Quelle gibt an, was gesammelt wird. Metadaten zu Elementen und Layern, einschließlich Beschreibungen, Tags und Distributionen von Download-Formaten aus Hub sind über die CKAN-Instanz zugänglich.

Hinweis:

Katalog-Feeds verwenden automatisch Downloads API v1 (die zuvor verwendete Downloads-API ist veraltet).

Feedback zu diesem Thema?

In diesem Thema
  1. Verwenden von Katalog-Feeds
  2. Konfigurieren und Verwalten von Feeds
  3. Verbinden von Katalogen über Hub-Feeds