Zusammenfassung
Konsolidiert ein oder mehrere Geoverarbeitungsergebnisse in einen angegebenen Ausgabeordner.
Wenn der angegebene Ordner nicht vorhanden ist, wird ein neuer Ordner erstellt.
Verwendung
Wenn ein Werkzeug ausgeführt wird, werden Informationen über die Ausführung als Ergebnis in das Fenster Ergebnisse geschrieben. Die Ergebnisse können als Eingabe mit Drag & Drop direkt aus dem Fenster Ergebnisse hinzugefügt werden. Alternativ können Ergebnisse, die als Ergebnisdatei (.rlt) gespeichert wurden, als Eingabe hinzugefügt werden.
Wenn Daten in File-Geodatabase konvertieren aktiviert ist (convert_data='CONVERT' in Python), passiert Folgendes:
- 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.
Wenn Daten in File-Geodatabase konvertieren nicht aktiviert ist (convert_data='PRESERVE' in Python), passiert Folgendes:
- Das Datenquellenformat der Eingabe-Layer bleibt erhalten. Zu den Ausnahmen zählen Formate wie Personal-Geodatabase-Daten (.mdb), VPF-Daten sowie Tabellen, die auf Excel-Tabellen oder OLEDB-Verbindungen basieren. Diese Formate werden in 64x-Umgebungen nicht unterstützt und daher stets in eine File-Geodatabase umgewandelt.
- 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 Packen eines Layers basierend auf diesen Typen von Datasets werden die beteiligten Datasets ebenfalls konsolidiert oder gepackt.
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, Symbolisierung, Definitionsabfragen usw. besteht. Daten oder Datensätze werden nicht konsolidiert oder gepackt.
Datenquellen, die "Nur Schema" nicht unterstützen, werden nicht konsolidiert oder gepackt. 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.
Syntax
ConsolidateResult(in_result, output_folder, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {schema_only})
Parameter | Erklärung | Datentyp |
in_result [in_result,...] | Das Geoverarbeitungsergebnis, das konsolidiert werden soll. Bei den als Eingabe hinzugefügten Ergebnissen kann es sich um eine Ergebnisdatei (.rlt) oder ein Ergebnis aus dem Fenster Ergebnisse handeln. | File; String |
output_folder | Der Ausgabeordner, der die konsolidierten Werkzeuge und Daten enthält. | Folder |
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) | Gibt 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 |
Codebeispiel
ConsolidateResult – Beispiel 1 (Python-Fenster)
Das folgende Skript veranschaulicht, wie das Werkzeug ConsolidateResult im Python-Fenster verwendet wird.
import arcpy
arcpy.ConsolidateResult_management(r'C:\ResultFiles\BufferPoints.rlt', r'C:\project\Buffer_Pnts', "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", "ALL")
ConsolidateResult – Beispiel 2 (eigenständiges Skript)
Sucht und erstellt einzelne konsolidierte Ordner für alle Ergebnisdateien eines bestimmten Ordners.
# Name: ConsolidateResultEx1.py
# Description: Find all the Result files that reside in a specified folder and create a consolidated folder for each layer file.
# import system modules
import os
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/ResultFiles"
# Loop through the workspace, find all the result files (.rlt) and create a consolidated folder for each
# result file found using the same name as the original result file.
for rlt in arcpy.ListFiles("*.rlt"):
print("Consolidating " + rlt)
arcpy.ConsolidateResult_management(rlt, os.path.splitext(rlt)[0], "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", "ALL")
Umgebungen
Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja