Verbinden von Daten und Verwalten von Feeds

Site-Manager können über die Feeds, die für eine ArcGIS Hub-Site verfügbar sind, den öffentlichen Site-Inhalt mit externen Katalogen verknüpfen. Dadurch erhöht sich die Auffindbarkeit für Suchmaschinen und Drittanbieterkataloge. Feeds erlauben Site-Managern und -Besuchern, über Änderungen am Site-Katalog auf dem Laufenden zu bleiben.

Verwenden von Katalog-Feeds

Mithilfe von ArcGIS Hub-Feeds können Sie über Änderungen am 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. Bei Auswahl dieser Option wird ein Fenster geöffnet, in dem die Feeds und der zum Hinzufügen eines Feeds erforderliche Code angezeigt werden. Hub unterstützt folgende Feeds:

  • 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 (<Site-URL>/api/search/definition)
  • RSS (<Site-URL>/api/feed/rss/2.0)

DCAT-Feeds

Jede Site verfügt über einen Katalog (Content-Bibliothek) mit den Inhalten, die Sie über die Site freigeben möchten. Wenn Sie den Katalog Ihrer Site verbinden möchten, können 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.

Vorsicht:

Nur Datenelemente, die öffentlich freigegeben wurden, sind im Katalog "<DCAT type>.json" enthalten. Private Inhalte in Ihrer Organisation können derzeit nicht mit der DCAT-Katalogmethode freigegeben oder verbunden werden.

Hinweis:

Der Datenkatalog jeder Site generiert eine öffentliche Feed-Ausgabe-URL, die mit DCAT US 1.1 unter <siteURL>/data.json konform ist. Anfang 2022 wurde ArcGIS Hub offiziell auf einen neuen Endpunkt unter <siteURL>/api/feed/dcat-us/1.1.json migriert. Lesen Sie den Blogbeitrag Upcoming changes to DCAT configurations on ArcGIS Hub sites, um mehr zu erfahren.

OGC API – Records

Sie können die OGC Records API nutzen, um räumliche Ressourcen über standardisierte Sammlungen und Ressourcen-Metadaten zu erkunden. Mit diesem Feed können Sie den Katalog einer Hub-Site programmgesteuert abfragen, filtern und durchsuchen. Mit dem 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 Anwendungsfällen zählen das Rendern von Features auf einer Karte in anderen Werkzeugen wie ArcGIS Online Map Viewer, GIS-Desktop-Anwendungen, OWSLib usw.

RSS-Feeds

RSS ist ein Format für die Web-Content-Syndizierung. Es ist eine Standardmethode für die Bereitstellung von Metadaten zu Katalogeinträgen, insbesondere für Kataloge, die häufig aktualisiert oder ergänzt werden. 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. 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. 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.

Konfigurieren und Verwalten von Feeds

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 ArcGIS 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.

  1. Klicken Sie auf die Schaltfläche zum Bearbeiten Bearbeiten, um die Site im Bearbeitungsmodus zu öffnen.
  2. Klicken Sie, um das Site-Menü in der oberen Navigationsleiste zu öffnen, und wählen Sie Content-Bibliothek aus.
  3. Klicken Sie auf die Schaltfläche Weitere Aktionen Weitere Aktionen, und wählen Sie Feeds konfigurieren aus.
  4. Wählen Sie einen zu konfigurierenden Feed aus. 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.
  5. Wählen Sie Speichern aus.

Beispiel für ein Standardschema

ArcGIS 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 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

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 die Hub V3-API, die neueste Version der Hub-API, abgerufen werden. Bei den Werten für die Schlüssel “platform”, “bureauCode” und “programCode” handelt es sich um Zeichenfolgenliterale.

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. Bei den entsprechenden Werten kann es sich um eine Zeichenfolgeliterale oder eine Vorlage handeln, mit der ein Schlüssel aus der Hub V3-API abgerufen wird. Für Vorlagen können Sie jeden von der V3-API zurückgegebenen Schlüssel (oberste Ebene oder geschachtelt) angeben.

Beispiel: Auf der ArcGIS 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 die Hub V3-API (https://hub.arcgis.com/api/v3/datasets/c7a223914778420db8bf000b4eb6ec6f) auf die Layer-ID c7a223914778420db8bf000b4eb6ec6f zugreifen. Wenn das Element über mehrere Layer verfügt, müssen Sie die Layer-Nummer am Ende der Element-ID hinzufügen (`<Element-ID>_<Layer-Nummer>`).

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 der Hub V3-API fügen Sie im Feed-Editor einen Vorlagenwert für einen beliebigen Hub V3-API-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 Content-Elements 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 die Ausgabe so ändern, dass sie mit umfangreichen 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 Formate (Distributionen) eines Datasets verweisen. Distributionen sind Paketformate, die die Nutzung als Web-Service, Download oder API erlauben.

Site-Manager 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.

Nachdem Sie sichergestellt haben, dass die Erweiterungen installiert sind, prüfen Sie, 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 http://yourOpenDataSite/data.json als URL ein.
    • Geben Sie der Harvest-Quelle einen Namen, der dem Titel auf 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.
    • Klicken Sie abschließend auf Save.
  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 data.json-Datei und berücksichtigt alle Ihre Datasets. Sie können sehen, was geharvestet wird, indem Sie die Harvest-Quelle anzeigen. Alle Beschreibungen, Tags und Dataset-Verteilungen aus Hub können über die CKAN-Instanz aufgerufen werden.

Hinweis:

Es kann zu Verzögerungen kommen, wenn Sie zum ersten Mal eine Vorschau einer .csv- oder .json-Datei anzeigen, da Hub einen Cache der Daten generiert. CKAN kann während der Datenverarbeitung nicht bestimmen, wie damit verfahren werden soll. Das nächste Mal, wenn Sie eine Vorschau der Datei anzeigen, tritt dies nicht auf.