Konfigurieren von Grenz-Layern

Esri stellt Layer mit Grenz- und demografischen Informationen für verschiedene Teile der Welt zur Verfügung. Diese Layer, z. B. Bundesstaat-, Kanton-, Zählbezirk- und PLZ-Grenzen, enthalten zugehörige, lokale Informationen, die Portal-Mitglieder in ihren Karten, Apps, Analysewerkzeugen und Insights for ArcGIS verwenden können.

Sie können diese Layer in Ihrem Portal veröffentlichen, wenn Sie Insights for ArcGIS installiert haben oder wenn Ihr Portal nicht über Living Atlas of the World auf den Inhalt des ArcGIS Online zugreifen kann.

Als Portal-Administrator können Sie die gewünschten Definitionsdateien (.sd) für Grenz-Layer von My Esri herunterladen und gehostete Feature mit dem Werkzeug publishboundarylayers aus den Dateien veröffentlichen.

Hinweis:

Sie müssen alle in diesem Thema beschriebenen Werkzeuge mit einem integrierten Portal-Administratorkonto ausführen und über Port 7443 statt über einen Web Adaptor oder Load Balancer auf das Portal zugreifen.

Die Veröffentlichung kann über einen Ordner mit allen gewünschten Dateien, über einzelne Dateien oder durch die Bereitstellung einer Dateiliste im Textdateiformat erfolgen. Stellen Sie sicher, dass das zum Installieren von Portal for ArcGIS verwendete Konto über Lesezugriff für dieses Verzeichnis verfügt.

Die Veröffentlichung dieser Definitionsdateien (.sd) für Grenz-Services in Ihrem Portal hat folgende Auswirkungen:

• Jede .sd-Datei wird im Portal als Servicedefinitionselement hinzugefügt. Diese Dateien müssen im Portal bleiben, falls Sie die Grenz-Layer aktualisieren möchten, sobald aktualisierte Inhalte verfügbar sind.
• Für jede .sd-Datei, die Sie veröffentlichen, wird ein gehosteter Feature-Layer erstellt. Jeder gehostete Feature-Layer enthält mehrere Layer.
• Sowohl die Servicedefinitionselemente als auch die gehosteten Feature-Layer sind im Besitz eines internen Portal-Mitglieds namens "esri_boundaries". Ändern Sie den Besitz dieser Elemente nicht in einen anderen Benutzer.
• Alle Mitglieder Ihrer Portal-Organisation haben standardmäßig Zugriff auf die gehosteten Grenz-Feature-Layer im Portal.

Veröffentlichen von Grenz-Layern

Diese Layer sind unter Esri Master License Agreement lizenziert. Lesen Sie vor dem Veröffentlichen die Zusammenfassung und die Nutzungsbedingungen.

Wichtige Nutzungsbedingungen

• Diese Layer sind für den internen Gebrauch in ArcGIS Enterprise lizenziert, darunter Portal for ArcGIS, Insights for ArcGIS und andere damit verbundene ArcGIS-Apps.
  • Die Nutzung außerhalb der ArcGIS Enterprise-Produktfamilie sowie der Datenexport für die unverbundene Nutzung in ArcGIS oder anderen Anwendungen ist nicht zulässig.
  • Die öffentliche oder private Freigabe des Layers zur externen Nutzung durch Angehörige anderer Organisationen oder die Allgemeinheit ist ohne schriftliche Genehmigung von Esri unzulässig.
• Die Layer sind für die Nutzung über einen Zeitraum von zwei (2) Jahren lizenziert, nachdem sie von der Esri Plattform heruntergeladen wurden. Sie können jährlich die aktuellen Daten herunterladen, um die Lizenz zu verlängern.
• Bei jeder Verwendung der Layer muss der mit jedem Layer veröffentlichte Quellennachweis (Attributierung) angegeben werden.

Führen Sie die folgenden Schritte aus, um Grenz-Dateien abzurufen und als Feature-Layer in Ihrem Portal zu hosten:

1. Laden Sie komprimierte Dateien mit Servicedefinitionen (.sd) von My Esri herunter.
   1. Melden Sie sich bei My Esri an.
   2. Wechseln Sie zu Eigene Organisationen > Downloads > Daten und Inhalt.
   3. Geben Sie Boundary in das Suchfeld ein, um nach Grenz-Layern zu filtern.
   4. Klicken Sie für die gewünschten Dateien auf Herunterladen.
2. Extrahieren Sie die Download-Dateien, und legen Sie sie in einem Ordner auf dem Portal for ArcGIS-Computer.

   Dateinamen verwenden einen Code aus drei Buchstaben, um die Regionen anzugeben, auf die sie angewendet werden, und das Jahr, auf das die Daten angewendet werden, ist an das Ende des Namens angefügt. "USA_Boundaries_2015" enthält beispielsweise Grenzen für die USA aus dem Jahr 2015.

   Entfernen Sie alle Dateien, die nicht in das Portal hochgeladen und dort veröffentlicht werden sollen. Sie können auch eine Textdatei mit einer Teilmenge der Dateien erstellen, die Sie hochladen und veröffentlichen möchten. Formatieren Sie die Textdatei so, dass ein Dateiname pro Zeile vorhanden ist; zum Hochladen von Grenzen für die USA oder die Welt enthält die Textdatei beispielsweise Folgendes:

   USA_Boundaries_2015
   WOR_Boundaries_2015

3. Öffnen Sie ein Befehlsterminal auf dem Portal for ArcGIS-Computer.
4. Ändern Sie die Verzeichnisse in den Speicherort des Werkzeugs.
5. Führen Sie das Werkzeug publishboundarylayers aus.

   Das Werkzeug wird im Verzeichnis <Portal installation directory>/tools/publishboundarylayers installiert. Die Syntax für das Werkzeug lautet wie folgt: publishboundarylayers --folder <location of files> [{--files <file names>|--file <name of text file>}] --url <Portal website URL> --username <portal administrator user name> [--password <portal administrator password>]

   Wenn Sie beim Ausführen des Werkzeugs kein Kennwort angeben, werden Sie aufgefordert, das Kennwort für den Portal-Administrator einzugeben. Dieser Benutzer muss ein Mitglied der Standardadministratorrolle im Portal sein.

   Wenn Sie den Vorgang --files verwenden, geben Sie eine durch Kommas getrennte Liste der Servicedefinitionsdateien an. Bei Verwendung der Option --file geben Sie den Namen einer Textdatei mit der Liste der Grenz-Dateien an, die Sie veröffentlichen möchten.

   In diesem Beispiel werden alle Dateien des Verzeichnisses boundaryfiles im Portal veröffentlicht:

   ./publishboundarylayers.sh --folder /usr/tmp/boundaryfiles --url https://portal.domain.com:7443/arcgis --username portaladmin

   In diesem Beispiel befinden sich Dateien im selben Verzeichnis (boundaryfiles), es werden zwei veröffentlicht:

   ./publishboundarylayers.sh --folder /usr/tmp/boundaryfiles --files USA_Boundaries,WOR_Boundaries --url https://portal.domain.com:7443/arcgis --username portaladmin

   In diesem Beispiel wurde eine Textdatei (boundarysubset.txt) im Verzeichnis boundaryfiles erstellt. Das Werkzeug liest die Dateiliste aus der Textdatei, um eine Teilmenge der Grenz-Layer zu veröffentlichen.

   ./publishboundarylayers.sh --folder /usr/tmp/boundaryfiles --file boundarysubset.vi --url https://portal.domain.com:7443/arcgis --username portaladmin

Nach der Veröffentlichung ist für jede .sd-Datei, die Sie veröffentlicht haben, ein Servicedefinitionselement und ein gehosteter Feature-Layer vorhanden.

Um zu überprüfen, ob die Elemente vorhanden sind, können Sie das Portal nach allen Elementen im Besitz des internen Portal-Mitglieds "esri_boundaries" durchsuchen. Geben Sie owner:esri_boundaries in das Suchfeld des Portals ein, und durchsuchen Sie alle Inhalte.

Aktualisieren von Grenz-Layern

In den meisten Fällen werden Aktualisierungen von Grenz-Layern als neue Servicedefinitionsdatei bereitgestellt, die Sie mit dem Dienstprogramm "publishboundarylayers" in Ihrem Portal veröffentlichen. Dadurch können Sie die Layer unabhängig verwenden und die beiden Versionen der Daten analysieren. Die Datei mit den weltweiten Grenzen kann als Version 2015 und 2017 vorliegen. In seltenen Fällen werden die auf My Esri verfügbaren Servicedefinitionsdateien auf den richtigen Inhalt aktualisiert. In diesen Fällen können Sie die aktualisierte Datei herunterladen und mit dem Werkzeug updateboundarylayers veröffentlichen. Dadurch wird der vorhandene gehostete Feature-Layer im Portal überschrieben.

Wie in der Einleitung erwähnt, können Sie Grenz-Layer nur dann aktualisieren, wenn das Servicedefinitionselement des Layers noch im Portal vorhanden ist.

Führen Sie die folgenden Schritte aus, um die Grenz-Feature-Layer in Ihrem Portal zu aktualisieren:

1. Laden Sie komprimierte Dateien mit aktualisierten Servicedefinitionen (.sd) von My Esri herunter.
2. Extrahieren Sie die Dateien, und ersetzen Sie sie in einem Ordner auf dem Portal for ArcGIS-Computer.

   Entfernen Sie alle Dateien, die nicht in das Portal hochgeladen und dort veröffentlicht werden sollen. Sie können auch eine Textdatei mit einer Teilmenge der Dateien erstellen, die Sie hochladen und veröffentlichen möchten. Formatieren Sie die Textdatei so, dass ein Dateiname pro Zeile vorhanden ist; zum Hochladen von Grenzen für die USA und die Welt enthält die Textdatei beispielsweise Folgendes:

   USA_Boundaries_2015
   WOR_Boundaries_2015

3. Öffnen Sie ein Befehlsterminal auf dem Portal for ArcGIS-Computer.
4. Ändern Sie die Verzeichnisse in den Speicherort des Werkzeugs.
5. Führen Sie das Werkzeug updateboundarylayers aus.

   Das Werkzeug wird im Verzeichnis <Portal installation directory>/tools/publishboundarylayers installiert. Die Syntax für das Werkzeug lautet wie folgt: updateboundarylayers --folder <location of files> [{--files <file names>|--file <name of text file>}] --url <Portal home page URL> --username <portal administrator user name> [--password <portal administrator password>]

   Wenn Sie beim Ausführen des Werkzeugs kein Kennwort angeben, werden Sie aufgefordert, das Kennwort für den Portal-Administrator einzugeben. Dieser Benutzer muss ein Mitglied der Standardadministratorrolle im Portal sein.

   Wenn Sie den Vorgang --files verwenden, geben Sie eine durch Kommas getrennte Liste der Servicedefinitionsdateien an. Bei Verwendung der Option --file geben Sie den Namen einer Textdatei mit der Liste der Grenz-Dateien an, die Sie veröffentlichen möchten.

   In diesem Beispiel werden alle Dateien des Verzeichnisses boundaryfiles im Portal veröffentlicht und überschreiben die vorhandenen Layer:

   ./updateboundarylayers.sh --folder /usr/tmp/boundaryfiles --url https://portal.domain.com:7443/arcgis --username portaladmin

   In diesem Beispiel befinden sich Dateien im selben Verzeichnis (boundaryfiles), es wird jedoch nur eine Datei erneut veröffentlicht:

   ./updateboundarylayers.sh --folder /usr/tmp/boundaryfiles --files WOR_Boundaries --url https://portal.domain.com:7443/arcgis --username portaladmin

   In diesem Beispiel wurde eine Textdatei (boundaryupdatesubset.txt) im Verzeichnis boundaryfiles erstellt. Das Werkzeug liest die Dateiliste aus der Textdatei, um eine Teilmenge der Grenz-Layer erneut zu veröffentlichen.

   ./updateboundarylayers.sh --folder /usr/tmp/boundaryfiles --file boundaryupdatesubset.vi --url https://portal.domain.com:7443/arcgis --username portaladmin

Nach der Veröffentlichung enthalten die vorhandenen gehosteten Feature-Layer aktualisierte Daten oder Metadaten.

Löschen von Grenz-Layern

Wenn Sie einen Grenz-Layer in Ihrem Portal nicht mehr benötigen, können Sie ihn löschen. Sie können auf der Portal-Website nach einem Layer suchen und ihn dort löschen oder das Werkzeug "deleteboundarylayers" ausführen. Falls Sie mehrere Grenz-Layer löschen möchten, verwenden Sie das Werkzeug "deleteboundarylayers".

Das Werkzeug "deleteboundarylayers" löscht keine Layer mit aktiviertem Löschschutz.

Vorsicht:

Wenn Sie einen Grenz-Layer löschen, der aktuell in einer Karte, App oder Szene verwendet wird, wird der Layer dort nicht mehr angezeigt. Durch die erneute Veröffentlichung wird der Layer nicht in der Karte, App oder Szene ersetzt, da hierbei ein neues Element mit einer neuen ID im Portal erstellt wird.

Sie können eine durch Kommas getrennte Liste zu löschender Layer mit dem Vorgang --files oder eine Textdatei mit einer Liste zu löschender Layer mit dem Vorgang --file bereitstellen.

Die Syntax zum Bereitstellen einer durch Kommas getrennten Layer-Liste lautet wie folgt: deleteboundarylayers {--files <layer_name_list> | --file <location_of_text_file>} --url <portalURL> --username <portal_admin> [--password password]

Um beispielsweise die Layer "USA_Boundaries_2015" und "WOR_Boundaries_2015" als Portal-Administrator namens "portaladmin" aus dem Portal https://portal.domain.com:7443/arcgis zu löschen, geben Sie Folgendes ein:

./deleteboundarylayers.sh --files USA_Boundaries_2015,WOR_Boundaries_2015 --url https://portal.domain.com:7443/arcgis --username portaladmin

Die Syntax zum Bereitstellen einer Textdatei mit einer Liste zu löschender Layer lautet wie folgt: deleteboundarylayers --file <location_of_text_file> --url <portalURL> --username <portal_admin> [--password password]

Wenn Sie dieselben Layer beispielsweise mit einer Datei löschen möchten, erstellen Sie eine Textdatei mit einem Layer-Namen pro Zeile (wie im Folgenden dargestellt), und geben Sie beim Ausführen des Werkzeugs den Speicherort und den Namen der Textdatei an:

USA_Boundaries_2015
WOR_Boundaries_2015

Im folgenden Beispiel befindet sich die Datei boundarylist unter /usr/data/boundaries. Sie enthält eine Liste der Layer, die aus dem Portal gelöscht werden sollen, https://webadaptorhost.domain.com/webadaptorname.

./deleteboundarylayers.sh --file /usr/data/boundaries/boundarylist --url https://portal.domain.com:7443/arcgis --username portaladmin