Zusammenfassung
Konsolidiert eine Karte und alle referenzierten Datenquellen in einen angegebenen Ausgabeordner.
Verwendung
Eine Warnung wird ausgegeben, wenn dieses Werkzeug einen nicht unterstützten Layer-Typ feststellt. Der nicht unterstützte Layer wird nicht in die Ausgabe geschrieben.
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. Um Enterprise-Geodatabase-Daten in eine File-Geodatabase zu konvertieren, 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 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, 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. Standardmäßig werden verbundene oder zugehörige Datenquellen vollständig konsolidiert. In Abhängigkeit vom Parameter Zugehörige Zeilen auswählen kann sich die Konsolidierung aber auch nach der im Parameter Ausdehnung angegebenen Ausdehnung richten.
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.
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.
Syntax
arcpy.management.ConsolidateMap(in_map, output_folder, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {preserve_sqlite})
Parameter | Erklärung | Datentyp |
in_map | Das zu konsolidierende Kartendokument (.mxd). | ArcMap Document |
output_folder | Der Ausgabeordner, der die konsolidierte Karte und die konsolidierten Daten enthält. | Folder |
convert_data (optional) | Gibt an, ob Eingabe-Layer in eine File-Geodatabase konvertiert oder im ursprünglichen Format beibehalten werden.
| Boolean |
convert_arcsde_data (optional) | Gibt an, ob Eingabe-Geodatabase-Layer in eine File-Geodatabase konvertiert oder im ursprünglichen Format beibehalten werden.
| 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) | Gibt an, ob die angegebene Ausdehnung auf alle Layer oder nur auf Enterprise-Geodatabase-Layer angewendet wird.
| Boolean |
preserve_sqlite (optional) | Anstatt eine Konvertierung in ein File-Geodatabase-Format vorzunehmen, können SQLite-Daten als SQLite-Ausgabe beibehalten werden. Der Parameter convert_data wird von diesem Parameter überschrieben, wenn die Eingabedaten vom Typ SQLite sind. Wenn es sich bei den Eingabedaten um ein SQLite-Netzwerk-Dataset handelt, erfolgt die Ausgabe immer in SQLite.
| Boolean |
Codebeispiel
ConsolidateMap – Beispiel 1 (Python-Fenster)
Das folgende Python-Skript veranschaulicht, wie Sie das Werkzeug ConsolidateMap im Python-Fenster verwenden:
import arcpy
arcpy.env.workspace = "C:/arcgis/ArcTutor/Editing"
arcpy.ConsolidateMap_management('Exercise1.mxd', 'Consolidate_folder', 'PRESERVE', 'CONVERT_ARCSDE')
ConsolidateMap – Beispiel 2 (eigenständiges Skript)
Sucht und konsolidiert alle Kartendokumente, die sich in einem angegebenen Ordner befinden.
# Name: ConsolidateMap.py
# Description: Find all the map documents that reside in a specified folder and create a consolidated
# folder for each map document found.
# import system modules
import os
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = 'C:/arcgis/ArcTutor/Editing'
# Loop through the workspace, find all the mxds and create a consolidated folder using the same
# name as the original mxd
for mxd in arcpy.ListFiles('*.mxd'):
print('Consolidating ' + mxd)
arcpy.ConsolidateMap_management(mxd, os.path.splitext(mxd)[0], 'PRESERVE', 'CONVERT_ARCSDE')
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja