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 Organisationsmitglieder in ihren Karten, Szenen, Apps und Feature-Analysewerkzeugen verwenden können.

Erwägen Sie, diese Layer zu veröffentlichen, wenn Ihre Organisation keinen Zugriff auf ArcGIS Living Atlas of the World-Inhalte aus ArcGIS Online hat.

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

Hinweis:

Wenn Sie eines der in diesem Thema beschriebenen Werkzeuge ausführen, müssen Sie ein integriertes Portal-Administratorkonto verwenden. Welche URL Sie für diese Werkzeuge verwenden, hängt davon ab, wo Sie ArcGIS Enterprise bereitstellen.

Sofern Sie die Werkzeuge in einer lokalen ArcGIS Enterprise-Bereitstellung ausführen, müssen Sie statt über einen Web Adaptor oder Load Balancer über Port 7443 auf das Portal zugreifen.
Wenn Sie diese Werkzeuge in einer ArcGIS Enterprise-Bereitstellung in der Cloud ausführen, müssen Sie über einen Web Adaptor oder Load Balancer auf das Portal zugreifen. Verwenden Sie in diesem Fall nicht Port 7443.

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 Konto, das zur Installation von Portal for ArcGIS verwendet wird, Lesezugriff auf dieses Verzeichnis hat.

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 Konto, das zum Ausführen des Portal for ArcGIS-Service verwendet wird, Lesezugriff auf diesen Ordner hat.

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

Jede .sd-Datei wird im Portal als Service-Definitionselement hinzugefügt. Diese Dateien müssen in der Organisation 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 Service-Definitionselemente als auch die gehosteten Feature-Layer sind im Besitz eines internen Organisationsmitglieds namens "esri_boundaries". Ändern Sie den Besitz dieser Elemente nicht in einen anderen Benutzer.
Alle Organisationsmitglieder haben standardmäßig Zugriff auf die gehosteten Grenz-Feature-Layer. Mitglieder können wie folgt auf die Grenz-Layer zugreifen:
- Durchsuchen der Organisation nach Grenz-Layer-Elementen auf der Registerkarte Eigene Organisation der Seite Inhalt
- Hinzufügen von einzelnen Grenz-Layern zu Feature-Analysewerkzeugen in Map Viewer
- Hinzufügen von Grenz-Layern zu Scene Viewer im Fenster Inhalt

Veröffentlichen von Grenz-Layern

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

Es folgen wichtige Nutzungsbedingungen:

Diese Layer sind für den internen Gebrauch in ArcGIS Enterprise und anderen damit verbundenen ArcGIS-Apps lizenziert.
- 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 (Attribuierung) angegeben werden.

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

Laden Sie komprimierte Dateien mit Service-Definitionen (.sd) von My Esri herunter.
Extrahieren Sie die Download-Dateien, und legen Sie sie in einem Ordner auf dem Portal for ArcGIS-Computer ab.

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 ihre Organisation hochgeladen und dort veröffentlicht werden sollen. Sie können auch eine Textdatei mit einer Teilmenge der Dateien erstellen, die hochgeladen und veröffentlicht werden sollen. 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
```
Öffnen Sie einen Befehlsterminal auf dem Portal for ArcGIS-Computer.
Öffnen Sie eine Eingabeaufforderung auf dem Portal for ArcGIS-Computer.
Ändern Sie die Verzeichnisse in den Speicherort des Werkzeugs.
Führen Sie das Werkzeug publishboundarylayers aus.

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

Das Werkzeug ist unter <Portal installation directory>\tools\publishboundarylayersinstalliert. Die Syntax für das Werkzeug lautet wie folgt: publishboundarylayers --folder <location of sd 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 ein Administratorkonto einzugeben. Dieser Benutzer muss ein Mitglied der Standardadministratorrolle in der Organisation sein.

Wenn Sie den Vorgang --files verwenden, geben Sie eine durch Kommas getrennte Liste der Service-Definitionsdateien an. Bei Verwendung der Option --file geben Sie den Speicherort und 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 in einer lokalen Organisation veröffentlicht:

./publishboundarylayers --folder /usr/data/boundaryfiles --url https://portal.example.com:7443/arcgis --username portaladmin

publishboundarylayers --folder d:\data\boundaryfiles --url https://portal.example.com:7443/arcgis --username portaladmin

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

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

publishboundarylayers --folder d:\data\boundaryfiles --files USA_Boundaries_2015,WOR_Boundaries_2015 --url https://portal.example.com:7443/arcgis --username portaladmin

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

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 --folder /usr/data/boundaryfiles --file /usr/tmp/boundarysubset.vi --url https://portal.example.com:7443/arcgis --username portaladmin

publishboundarylayers --folder d:\data\boundaryfiles --file c:\temp\boundarysubset.txt --url https://portal.example.com:7443/arcgis --username portaladmin

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

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

Aktualisieren von Grenz-Layern

In den meisten Fällen werden Aktualisierungen von Grenz-Layern als neue Service-Definitionsdatei bereitgestellt, die Sie mit dem Dienstprogramm "publishboundarylayers" 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 Service-Definitionsdateien 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 überschrieben.

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

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

Laden Sie komprimierte Dateien mit aktualisierten Service-Definitionsdateien (.sd) von My Esri herunter.
Extrahieren Sie die Dateien, und legen Sie sie in einem Ordner auf dem Portal for ArcGIS-Computer ab.

Entfernen Sie alle Dateien, die nicht hochgeladen und veröffentlicht werden sollen. Sie können auch eine Textdatei mit einer Teilmenge der Dateien erstellen, die hochgeladen und veröffentlicht werden sollen. 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
```
Öffnen Sie einen Befehlsterminal auf dem Portal for ArcGIS-Computer.
Öffnen Sie eine Eingabeaufforderung auf dem Portal for ArcGIS-Computer.
Ändern Sie die Verzeichnisse in den Speicherort des Werkzeugs.
Führen Sie das Werkzeug updateboundarylayers aus.

Das Werkzeug ist unter <Portal installation directory>/tools/publishboundarylayersinstalliert. 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>].

Das Werkzeug ist unter <Portal installation directory>\tools\publishboundarylayersinstalliert. 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 ein Administratorkonto einzugeben. Dieser Benutzer muss ein Mitglied der Standardadministratorrolle sein.

Wenn Sie den Vorgang --files verwenden, geben Sie eine durch Kommas getrennte Liste der Service-Definitionsdateien 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 veröffentlicht das Werkzeug "updateboundarylayers" alle Dateien im Verzeichnis boundaryfiles, wobei vorhandene Layer überschrieben werden:

./updateboundarylayers --folder /usr/data/boundaryfiles --url https://portal.example.com:7443/arcgis --username portaladmin

updateboundarylayers --folder d:\data\boundaryfiles --url https://portal.example.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 --folder /usr/data/boundaryfiles --files WOR_Boundaries --url https://portal.example.com:7443/arcgis --username portaladmin

updateboundarylayers --folder d:\data\boundaryfiles --files WOR_Boundaries --url https://portal.example.com:7443/arcgis --username portaladmin

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

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 --folder /usr/data/boundaryfiles --file /usr/tmp/boundaryupdatesubset.vi --url https://portal.example.com:7443/arcgis --username portaladmin

updateboundarylayers --folder d:\data\boundaryfiles --file c:\temp\boundaryupdatesubset.txt --url https://portal.example.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 nicht mehr benötigen, können Sie ihn löschen. Sie können in der Organisation 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.

Achtung:

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 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" https://portal.example.com:7443/arcgis als Organisationsadministrator namens "portaladmin" zu löschen, geben Sie Folgendes ein:

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

deleteboundarylayers --files USA_Boundaries_2015,WOR_Boundaries_2015 --url https://portal.example.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 der Organisation mit der URL https://portal.example.com/portal gelöscht werden sollen.

Im folgenden Beispiel befindet sich die Datei boundarylist.txt unter c:\data\boundaries. Sie enthält eine Liste der Layer, die aus der Organisation mit der URL https://portal.example.com/portal gelöscht werden sollen.

./deleteboundarylayers --file /usr/data/boundaries/boundarylist --url https://portal.example.com/portal --username portaladmin

deleteboundarylayers --file c:\data\boundaries\boundarylist.txt --url https://portal.example.com/portal --username portaladmin