VertiGIS Studio Web kann für den Import von File Geodatabases (FGDB) und Layer Packages (LPKX) verwendet werden. Diese Funktion wird durch einen serverseitigen Geoverarbeitungsdienst (GP-Service) in Kombination mit einem Karten-/Anzeigedienst bereitgestellt. Beide Dienste werden in Ihrer ArcGIS Enterprise-Umgebung gehostet. VertiGIS stellt ein Setup-Paket bereit, das ein Publishing-Skript enthält, mit dem diese Dienste erstellt und konfiguriert werden können.
Wer ist betroffen?
- Kunden, die die Funktionen für FGDB- und LPKX-Importe nutzen möchten.
Vorraussetzungen
Stellen Sie sicher, dass Folgendes vorhanden ist:
- Ein ArcGIS Enterprise Portal-Benutzer mit Berechtigungen zum Veröffentlichen und Konfigurieren von Geoverarbeitungsdiensten
- Zugriff auf die ArcGIS Server-Maschine, die mit dem Enterprise Portal des Benutzers verbunden ist, oder auf einen serverseitigen Speicherort
- Ein Zielverzeichnis für den Workspace des Geodatendienstes, auf das ArcGIS Server zugreifen kann
- Berechtigung, das Setup-Paket an diesen Speicherort zu kopieren
- Zugang zu einer ArcPy-aktivierten Python-Umgebung, beispielsweise unter
C:/Program Files/ArcGIS/Pro/bin/Python/envs/arcgispro-py3/python.exe, sofern ArcGIS Pro auf dem Host installiert wurde - Zugriff auf das ArcGIS Server Administrator Directory
Optional:
- Name des GP-Service
- Name des Display-Service
Konfiguration starten
Schritt 1: Laden Sie das Setup-Paket herunter
vgs_geodata_upload, der physisch auf den ArcGIS Server kopiert werden muss. Der Inhalt dieses internen Ordners darf nicht geändert werden, es sei denn, dies wird ausdrücklich vom VertiGIS Support angewiesen.Schritt 2: Kopieren Sie das Setup-Paket auf die ArcGIS Server-Maschine
vgs_geodata_upload an einen Speicherort innerhalb oder neben den ArcGIS Server-Verzeichnissen verschoben werden, z. B. nachC:/arcgis/arcgisserver/directories/vgs_geodata_upload.Wichtig:
- Der Ordnerpfad muss aus Sicht des Servers gültig sein.
- Ein Pfad, der nur auf dem Client-Rechner gültig ist, funktioniert nicht.
- Der Ordner muss nach der Veröffentlichung weiterhin verfügbar bleiben, wenn er als dynamischer Workspace verwendet wird.
Schritt 3: Führen Sie das Veröffentlichungsskript mit den erforderlichen Parametern aus
Das erste Ausführen des Skripts kann 2-5 Minuten dauern. Führen Sie das Skript in PowerShell oder in der Eingabeaufforderung (CMD) aus. Der Befehl muss den Pfad zur Python-Executable, den Pfad zum Veröffentlichungsskript und alle erforderlichen Parameter enthalten.
Beispiel (CMD, Eingabeaufforderung):
"C:/Programmme/ArcGIS/Pro/bin/Python/envs/arcgispro-py3/python.exe" "C:/Downloads/vgs-geodata-tools-dl/publish.py" --portal_url "https://foo-bar.int.vertigis.com/portal" --workspace_path "C:/arcgis/arcgisserver/directories/vgs_geodata_upload" --username "Ihr_Benutzername" --password "Ihr_Passwort"Beispiel (PowerShell):
In PowerShell ist der Operator
& (Call Operator) erforderlich, wenn ausführbare Dateien mit Pfaden gestartet werden, die Leerzeichen enthalten. Dadurch wird verhindert, dass die Shell den Befehl als Literalzeichenfolge interpretiert.& "C:/Programmme/ArcGIS/Pro/bin/Python/envs/arcgispro-py3/python.exe" "C:/Downloads/vgs-geodata-tools-dl/publish.py" --portal_url "https://foo-bar.int.vertigis.com/portal" --workspace_path "C:/arcgis/arcgisserver/directories/vgs_geodata_upload" --username 'Ihr_Benutzername' --password 'Ihr_Passwort'Veröffentlichungsskript:
C:/Downloads/vgs-geodata-tools-dl/publish.pyErforderliche Parameter:
| Name | Beispiel | Beschreibung |
|---|---|---|
| --portal_url | https://foo-bar.int.vertigis.com/portal | - |
| --workspace_path | C:/arcgis/arcgisserver/directories/vgs_geodata_upload | - |
| --username | Authentifizierungsmethode wählen (A) | |
| --password | Authentifizierungsmethode wählen (A) | |
| --oauth_token | Authentifizierungsmethode wählen (B) |
Optionale Parameter:
| Name | Beispiel | Standard |
|---|---|---|
| --workspace_id | ServiceFGDB | ServiceFGDB |
| --service_foldername | VertiGIS_Utilities | VertiGIS_Utilities |
| --service_name_geodata | VertiGIS_Convert_Geodata_Tools | VertiGIS_Convert_Geodata_Tools |
| --service_name_display | VertiGIS_Display_Geodata_Service | VertiGIS_Display_Geodata_Service |
| --service_source_geodata | service_publish/service_source_geodata/VertiGISGeodataTools.pyt | service_publish/service_source_geodata/VertiGISGeodataTools.pyt |
| --service_source_display | service_publish/service_source_display/VertiGISGeodataDisplay.aprx | service_publish/service_source_display/VertiGISGeodataDisplay.aprx |
| --sharing_level | ORGANIZATION, PRIVATE, EVERYONE | ORGANIZATION |
Was das Skript ausführt
Das Skript automatisiert die Veröffentlichung und Konfiguration der erforderlichen Dienste. Es führt die folgenden Aktionen aus:
- Prüft die Python-Umgebung
- Erstellt eine Protokolldatei
- Erstellt temporäre Arbeitsordner
- Bereitet die Ressourcen für den Geoverarbeitungsdienst vor
- Veröffentlicht den Geoverarbeitungsdienst mit allen erforderlichen Einstellungen
- Bereitet den Anzeigedienst vor
- Veröffentlicht den Anzeigedienst
- Wendet die erforderlichen Freigabeeinstellungen an
- Gibt die erforderlichen Service-URLs zurück
Schritt 4: Konfigurieren Sie die Dienste in Studio Web
Nachdem das Skript erfolgreich abgeschlossen wurde, kopieren Sie die generierten Service-URLs und konfigurieren Sie diese über den Geodata Service. Sie finden diesen im App Designer unter Services.
Erforderliche URLs:
- Geodata Service URL
- Display Service URL
Anschließend können Sie die folgenden Befehle verwenden:
- Import from FGDB
- Import from LPKX
Abhängig von den Freigabeeinstellungen, die bei der Veröffentlichung ausgewählt wurden, müssen Sie sich möglicherweise mit Benutzername und Passwort authentifizieren.
Schritt 5: Setup überprüfen
So überprüfen Sie das Setup:
- Stellen Sie sicher, dass beide Dienste erfolgreich im Portal bzw. in ArcGIS Server veröffentlicht wurden.
- Stellen Sie sicher, dass der GP-Service Uploads erlaubt.
- Stellen Sie sicher, dass der Display Service verfügbar ist.
- Stellen Sie sicher, dass der dynamische Workspace auf den vorgesehenen serverseitigen Ordner zeigt:
- Öffnen Sie den ArcGIS Server Manager.
- Öffnen Sie den Dienst.
- Navigieren Sie zu "Capabilities".
- Wählen Sie "Show Connection String".
- Konfigurieren Sie die URLs in Studio Web.
- Testen Sie einen Upload mit einer unterstützten FGDB- oder LPKX-Datei.
Bekannte Einschränkungen
- Unterstützte ArcGIS Enterprise-Versionen: 10.8.1, 11.1, 11.3, 12
- Erforderliche Benutzerberechtigungen: Wir empfehlen, für die Ausführung des Publishing-Skripts ein ArcGIS Enterprise-Administratorkonto zu verwenden. Nicht-administrative Konten können je nach ArcGIS Enterprise-Konfiguration zusätzliche Konfiguration erfordern.
- Eine manuelle Veröffentlichung ist kein Standard-Workflow.
- Keine automatische Bereinigung der Daten: Hochgeladene File Geodatabases und Layer Package-Dateien verbleiben im konfigurierten serverseitigen Workspace-Verzeichnis. Administratoren müssen den verfügbaren Speicherplatz überwachen und Dateien bei Bedarf manuell entfernen.
- Reine ArcGIS Online-Umgebungen werden für dieses serverseitige Setup nicht unterstützt, da der Workflow serverseitig gehostete Geoverarbeitungsdienste erfordert.
In PowerShell wird das Zeichen
$als Beginn eines Variablennamens interpretiert, auch wenn es innerhalb von doppelten Anführungszeichen verwendet wird. Dadurch können Benutzernamen oder Passwörter, die ein$enthalten, vor der Übergabe an das ArcGIS-Publishing-Skript verändert werden, was zu Authentifizierungsfehlern führen kann.Lösung: Benutzernamen oder Passwörter mit
$sollten entweder in einfache Anführungszeichen gesetzt werden (z. B.'P@ss$word') oder das$mit einem Backtick maskiert werden (z. B."P@ss$word"`).
Aktuelle Skriptversion: 1.0.0
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.