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

Sie können diese Layer in Ihrem Portal veröffentlichen, wenn Sie ArcGIS Insights installiert haben oder wenn Ihr Portal nicht über ArcGIS Online auf den Inhalt des ArcGIS Living Atlas of the World 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:

Wenn Sie eines der in diesem Thema beschriebenen Werkzeuge ausführen, müssen Sie ein integriertes Portaladministratorkonto 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 zum Ausführen des Portal for ArcGIS-Service verwendete Konto über Lesezugriff für diesen Ordner 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. Portal-Mitglieder können wie folgt auf die Grenz-Layer zugreifen:
  • Durchsuchen des Portals nach Grenz-Layer-Elementen auf der Registerkarte Eigene Organisation der Seite Inhalt.
  • Hinzufügen von einzelnen Grenz-Layern zu Feature-Analysewerkzeugen in Map Viewer Classic über das Dialogfeld Analyse-Layer auswählen
  • 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.

Wichtige Nutzungsbedingungen

• Diese Layer sind für den internen Gebrauch in ArcGIS Enterprise lizenziert, darunter Portal for ArcGIS, ArcGIS Insights 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.
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 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

3. Öffnen Sie eine Eingabeaufforderung 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 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 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 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 einem lokalen Portal veröffentlicht:

   publishboundarylayers --folder d:\data\boundaryfiles --url https://portal.domain.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 d:\data\boundaryfiles --files USA_Boundaries_2015,WOR_Boundaries_2015 --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 --folder d:\data\boundaryfiles --file c:\temp\boundarysubset.txt --url https://portal.domain.com:7443/arcgis --username portaladmin

Nach der Veröffentlichung sind 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 in einen 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 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

3. Öffnen Sie eine Eingabeaufforderung 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 veröffentlicht das Werkzeug "updateboundarylayers" alle Dateien im Verzeichnis boundaryfiles, wobei vorhandene Layer überschrieben werden:

   updateboundarylayers --folder d:\data\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 --folder d:\data\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 --folder d:\data\boundaryfiles --file c:\temp\boundaryupdatesubset.txt --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 --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.txt unter c:\data\boundaries. Sie enthält eine Liste der Layer, die aus dem Portal gelöscht werden sollen, https://portal.domain.com:7443/arcgis.

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