Ergebnis packen (Data Management)
Zusammenfassung
Packt ein oder mehrere Geoverarbeitungsergebnisse, einschließlich aller Werkzeuge sowie Eingabe- und Ausgabe-Datasets, in eine einzelne komprimierte Datei (.gpk).
Verwendung
Wenn ein Werkzeug ausgeführt wird, werden Informationen über die Ausführung als Ergebnis in das Fenster Ergebnisse geschrieben. Ergebnisse können mithilfe von Drag & Drop direkt aus dem Fenster Ergebnisse als Eingabe hinzugefügt werden. Ebenso können Ergebnisse, die als Ergebnisdatei (.rlt) gespeichert wurden, ebenfalls als Eingabe hinzugefügt werden.
Wenn ArcGIS Runtime unterstützen aktiviert ist, kann das erstellte Geoverarbeitungspaket in der ArcGIS Runtime-Umgebung verwendet werden. Zur Unterstützung der Laufzeitumgebung
- Alle Datenquellen, die keine Geodatabase-Datenquellen darstellen, werden in eine File-Geodatabase konvertiert.
- Eine Karten-Service-Definitionsdatei (.msd) wird erstellt und dem Paket hinzugefügt.
- In einer neuen Toolbox, die für die Veröffentlichung konfiguriert ist, wird eine Kopie des Werkzeugs erstellt, das gepackt wird.
Es gilt Folgendes, wenn Daten in File-Geodatabase konvertieren aktiviert ist:
- Für jede eindeutige Datenquelle wird im konsolidierten Ordner oder Paket eine File-Geodatabase erstellt.
- Komprimierte Raster- und Vektorformate werden in eine File-Geodatabase konvertiert, und die Komprimierung geht verloren.
- Enterprise-Geodatabase-Daten werden nicht konsolidiert. Wenn Enterprise-Geodatabase-Daten in eine File-Geodatabase konvertiert werden sollen, aktivieren Sie Enterprise-Geodatabase-Daten einbeziehen statt Daten zu referenzieren.
Es gilt Folgendes, wenn Daten in File-Geodatabase konvertieren deaktiviert ist:
- Das Datenquellenformat der Eingabe-Layer bleibt erhalten. Die Ausnahme sind Formate wie Personal-Geodatabase-Daten (.mdb), VPF-Daten und Tabellen, die auf Excel-Tabellenkalkulationen oder OLE-DB-Verbindungen basieren. Diese Formate werden in 64x-Umgebungen nicht unterstützt und werden daher immer in eine File-Geodatabase konvertiert.
- Raster im Format ADRG, CADRG/ECRG, CIB und RPF werden immer in File-Geodatabase-Raster konvertiert. ArcGIS kann diese Formate nicht intern schreiben. Sie werden aus Effizienzgründen immer in File-Geodatabase-Raster konvertiert.
- File-Geodatabases werden in der Ausgabeordnerstruktur in einen versionsspezifischen Ordner konsolidiert, und alle anderen Formate werden in den Ordner commonData konsolidiert.
- Komprimierte Raster- und Vektorformate werden nicht ausgeschnitten. Dies gilt auch, wenn im Parameter Ausdehnung eine Ausdehnung angegeben ist.
Für Layer, die eine Verbindung enthalten oder an einer Beziehungsklasse beteiligt sind, werden alle verbundenen oder verwandten Datenquellen im Ausgabeordner konsolidiert.
Für Feature-Layer wird der Parameter Ausdehnung verwendet, um die Features auszuwählen, die konsolidiert werden sollen. Für Raster-Layer wird der Parameter Ausdehnung verwendet, um die Raster-Datasets auszuschneiden.
Einige Datasets verweisen auf andere Datasets. Sie können z. B. ein Topologie-Dataset verwenden, das auf vier Feature-Classes verweist. Weitere Beispiele für Datasets, die auf andere Datasets verweisen, sind geometrische Netzwerke, Netzwerke und Locators. Beim Konsolidieren oder Verpacken eines Layers basierend auf diesen Typen von Datasets werden die beteiligten Datasets ebenfalls konsolidiert oder verpackt.
Wenn der Parameter Nur Schema aktiviert ist, wird nur das Schema der Eingabe- und Ausgabedatenquellen konsolidiert oder gepackt. Ein Schema ist die Struktur oder der Entwurf einer Feature-Class oder -Tabelle, die aus Feld- und Tabellendefinitionen, Eigenschaften des Koordinatensystems, Symbologie, Definitionsabfragen usw. besteht. Daten oder Datensätze werden nicht konsolidiert oder gepackt.
Datenquellen, die "Nur Schema" nicht unterstützen, werden nicht konsolidiert oder verpackt. Wenn der Parameter Nur Schema aktiviert ist und das Werkzeug auf einen dafür nicht unterstützten Layer stößt, wird eine Warnmeldung angezeigt. Der Layer wird übersprungen. Falls der einzige angegebene Layer "Nur Schema" nicht unterstützt, tritt beim Ausführen des Werkzeugs ein Fehler auf.
Aus einem fehlerhaften Ergebnis kann kein Paket erstellt werden. Sie können allerdings das Werkzeug Ergebnis konsolidieren verwenden, um einen Ordner mit allen Daten und Werkzeugen zu erstellen, die vom fehlerhaften Ergebnis verwendet werden.
-
Wenn Sie ein Geoverarbeitungspaket entpacken möchten, ziehen Sie die .gpk-Datei in ArcMap, oder klicken Sie mit der rechten Maustaste auf die .gpk-Datei, und klicken Sie danach auf Entpacken. Alternativ können Sie das Werkzeug Paket extrahieren verwenden und einen Ausgabeordner angeben.
Standardmäßig werden Pakete in Ihr Benutzerprofil extrahiert.
- XP: C:\Dokumente und Einstellungen\<Benutzername>\Eigene Dateien\ArcGIS\Packages
- Vista und Windows 7: C:\Benutzer\<Benutzername>\Dokumente\ArcGIS\Packages
Wenn Sie das Standardverzeichnis ändern möchten, in dem die Pakete entpackt werden, öffnen Sie im Menü Anpassen das Dialogfeld ArcMap-Optionen. Suchen Sie auf der Registerkarte Freigabe den Abschnitt Paket erstellen, aktivieren Sie die Option Benutzerdefinierten Speicherort verwenden, und navigieren Sie zum neuen Speicherort.
Aus einem fehlerhaften Ergebnis kann kein Paket erstellt werden. Sie können allerdings das Werkzeug Ergebnis konsolidieren verwenden, um einen Ordner mit allen Daten und Werkzeugen zu erstellen, die vom fehlerhaften Ergebnis verwendet werden.
Syntax
| Parameter | Erläuterung | Datentyp |
in_result |
Das Ergebnis, das gepackt wird. Die Eingabe kann ein Ergebnis sein, das mithilfe von Drag & Drop direkt aus dem Fenster Ergebnisse oder durch Navigieren zu einer Ergebnisdatei (.rlt) hinzugefügt wird. | File; String |
output_file |
Name und Speicherort der Ausgabepaketdatei (.gpk). | File |
convert_data (optional) |
Gibt an, ob Eingabe-Layer in eine File-Geodatabase konvertiert werden oder ihr ursprüngliches Format beibehalten.
| Boolean |
convert_arcsde_data (optional) |
Gibt an, ob Eingabe-Geodatabase-Layer in eine File-Geodatabase konvertiert werden oder ihr ursprüngliches Format beibehalten.
| Boolean |
extent (optional) |
Geben Sie die Ausdehnung an, indem Sie die Koordinaten im Format X-Min Y-Min X-Max Y-Max manuell im Parameter "Ausdehnung" eingeben. Wenn Sie die Ausdehnung eines bestimmten Layers verwenden möchten, geben Sie den Layer-Namen an.
| Extent |
apply_extent_to_arcsde (optional) |
Bestimmt, ob die angegebene Ausdehnung auf alle Layer oder nur auf Enterprise-Geodatabase-Layer angewendet wird.
| Boolean |
schema_only (optional) |
Gibt an, ob nur das Schema von Eingabe- und Ausgabe-Datasets konsolidiert oder gepackt wird.
| Boolean |
arcgisruntime (optional) |
Gibt an, ob das Paket ArcGIS Runtime unterstützt. Damit ArcGIS Runtime unterstützt wird, werden alle Datenquellen in eine File-Geodatabase konvertiert, und im Paket wird eine .msd-Datei erstellt.
| Boolean |
additional_files (optional) |
Fügt zusätzliche Dateien zu einem Paket hinzu. Zusätzliche Dateien wie .doc, .txt, .pdf usw. werden verwendet, um mehr Informationen zum Inhalt und Zweck des Pakets anzugeben. | File |
summary (optional) |
Fügt den Eigenschaften des Pakets Zusammenfassungsinformationen hinzu. | String |
tags (optional) |
Fügt den Eigenschaften des Pakets Tag-Informationen hinzu. Mehrere Tags können hinzugefügt oder durch ein Komma oder ein Semikolon getrennt werden. | String |
Codebeispiel
Das folgende Python-Skript veranschaulicht, wie das Werkzeug "PackageResult" im Python-Fenster verwendet wird:
import arcpy
arcpy.env.workspace = "C:/ResultFiles"
arcpy.PackageResult_management('Parcel.rlt', 'Parcel.gpk', "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", "ALL", "DESKTOP", r"C:\docs\readme.txt", "Summary text", "Tag1; tag2; tag3")
Sucht und erstellt einzelne Geoverarbeitungspakete für alle Ergebnisdateien, die sich in einem angegebenen Ordner befinden.
# Name: PackageResultEx1.py
# Description: Find all the result files that reside in a specified folder and create a geoprocessing package for each result file.
# import system modules
import os
import arcpy
from arcpy import env
# Set environment settings
env.overwriteOutput = True
env.workspace = "C:/ResultFiles"
# Loop through the workspace, find all the result files (.rlt) and create a geoprocessing package using the same name as the original result file.
for rlt in arcpy.ListFiles("*.rlt"):
print "Packaging " + rlt
arcpy.PackageResult_management(rlt, os.path.splitext(lyr)[0] + '.gpk', "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", "ALL", "DESKTOP", r"C:\docs\readme.txt", "Summary text", "Tag1; tag2; tag3")
Sucht und erstellt ein einzelnes Geoverarbeitungspaket für alle Ergebnisdateien, die sich in einem angegebenen Ordner befinden.
# Name: PackageResultEx2.py
# Description: Find all the result files that reside in a specified folder and create a single geoprocessing package.
# import system modules
import os
import arcpy
from arcpy import env
# Set environment settings
env.overwriteOutput = True
env.workspace = "C:/ResultFiles"
# Find all the result files (.rlt) in a workspace and create a single geoprocessing package.
rlts = arcpy.ListFiles("*.rlt")
arcpy.PackageResult_management(rlts, 'all_layers.gpk', "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", "ALL", "DESKTOP", r"C:\docs\readme.txt", "Summary text", "Tag1; tag2; tag3")