Paket extrahieren (Data Management)

Zusammenfassung

Extrahiert den Inhalt eines Pakets in einen angegebenen Ordner. Der Ausgabeordner wird mit dem extrahierten Inhalt des Eingabepakets aktualisiert.

Verwendung

• Folgende Pakettypen werden unterstützt:

  • Geoverarbeitungspakete (.gpk und .gpkx)
  • Layer-Pakete (.lpk und .lpkx)
  • Locator-Pakete (.gcpk)
  • Kartenpakete (.mpk und .mpkx)
  • Mobile Kartenpakete (.mmpk)
  • Projekt-Pakete und Projektvorlagen (.ppkx und .aptx)
  • Kachelpakete (.tpk und .tpkx)
  • Vektor-Kachelpakete (.vtpk)

• Bei dem Ausgabeordner kann es sich um einen neuen oder einen vorhandenen Ordner handeln. Beim Extrahieren in einen vorhandenen Ordner wird der Paketinhalt an die vorhandenen Dateien und Ordner angehängt. Wenn der Ausgabeordner den extrahierten Inhalt des Pakets enthält, wird der vorhandene Inhalt überschrieben.

• In den Unterordner commondata\userdata\ des Ausgabeordners werden die angehängten Dateien von Paketen mit Anlagen entpackt. In der Regel sind die in einem Paket enthaltenen Dateien unterstützende Dateien wie eine .pdf-Datei, eine .docx-Datei oder ein Bild. Sie müssen im Windows Explorer zu dem extrahierten Verzeichnis navigieren, um diese Dateien zu öffnen.

• Beim Extrahieren von Vektorkachelpaketen (.vtpk) wird der Paketinhalt in den Ausgabeordner extrahiert. Das Cache-Speicherformat kann mit dem Parameter Speicherformattyp von kompakt (.bundle-Dateien) in erweitert (.pbf-Dateien) konvertiert werden. Sie können die extrahierten .pbf-Dateien in anderen Client-Anwendungen wie Mapbox verwenden.

• Beim Extrahieren von Kachelpaketen (.tpk, .tpkx oder .vtpk) ist der Parameter Paket cachen deaktiviert.

Syntax

arcpy.management.ExtractPackage(in_package, output_folder, {cache_package}, {storage_format_type}, {create_ready_to_serve_format})

Parameter	Erklärung	Datentyp
in_package	Das Eingabepaket, das extrahiert wird.	File
output_folder	Der Ausgabeordner, in den der Inhalt des Pakets extrahiert wird. Wenn der angegebene Ordner nicht vorhanden ist, wird ein Ordner erstellt.	Folder
cache_package (optional)	Gibt an, ob eine Kopie des Pakets in Ihrem Profil gecacht wird. Beim Extrahieren eines Pakets wird die Ausgabe zuerst in Ihr Benutzerprofil extrahiert und mit einer eindeutigen ID versehen, bevor in dem Verzeichnis, das im Parameter output_folder angegeben ist, eine Kopie erstellt wird. Beim Herunterladen und Extrahieren nachfolgender Versionen desselben Pakets erfolgt eine Aktualisierung nur an diesem Speicherort. Wenn Sie diesen Parameter verwenden, müssen Sie die gecachte Version des Pakets in Ihrem Benutzerprofil nicht manuell erstellen. Dieser Parameter ist nicht aktiviert, wenn das Eingabepaket ein Vektorkachelpaket (.vtpk) oder ein Kachelpaket (.tpk und .tpkx) ist. CACHE — Eine Kopie des Pakets wird extrahiert und in Ihrem Profil gecacht. Dies ist die Standardeinstellung. NO_CACHE —Eine Kopie des Pakets wird nur an den angegebenen Ausgabeparameter extrahiert.	Boolean
storage_format_type (optional)	Gibt das Speicherformat des exportierten Cache an. Dieser Parameter ist nur anwendbar, wenn das Eingabepaket ein Vektorkachelpaket (.vtpk) ist. COMPACT — Die Kacheln werden in Paketdateien im kompakten V2-Speicherformat gespeichert. Dieses Format bietet eine bessere Performance bei Netzwerkfreigaben und Cloud-Speicher-Verzeichnissen. Dies ist die Standardeinstellung. EXPLODED — Jede Kachel wird als einzelne Datei gespeichert.	String
create_ready_to_serve_format (optional)	Gibt an, dass ein einsatzbereites Format für ArcGIS Enterprise erstellt wird. Dieser Parameter ist nur aktiviert, wenn das Eingabepaket ein Vektorkachelpaket (.vtpk) oder ein Kachelpaket (.tpkx) ist. READY_TO_SERVE_CACHE_DATASET —Eine Ordnerstruktur mit einem extrahierten Cache, mit dem in ArcGIS Enterprise ein Kachel-Layer erstellt werden kann, wird erstellt. Die Dateierweiterung des Ordners gibt seinen Inhalt an: .tiles (Cache-Dataset) für Kachel-Layer-Pakete oder .vtiles (Vektor-Cache-Dataset) für Vektorkachelpakete. EXTRACTED_PACKAGE —Eine Ordnerstruktur mit extrahiertem Paketinhalt wird erstellt. Dies ist die Standardeinstellung.	Boolean

Codebeispiel

ExtractPackage – Beispiel 1 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie mit der Funktion ExtractPackage einsatzbereite Cache-Datasets generiert werden, die in Veröffentlichungs-Workflows von ArcGIS Enterprise verwendet werden können.

import arcpy
arcpy.management.ExtractPackage(r"C:\Data\packages\MyVectorPackage.vtpk", 
                                r"C:\Data\packages\Extracted", "CACHE", 
                                "COMPACT", "READY_TO_SERVE_CACHE_DATASET")

ExtractPackage – Beispiel 2 (eigenständiges Skript)

Alle Geoverarbeitungspakete in einem angegebenen Ordner werden gesucht, und die Funktion ExtractPackage wird verwendet, um den Inhalt in den angegebenen Ordner zu extrahieren.

# Name: ExtractPackage.py
# Description: Find Geoprocessing Packages in a specified folder and extract contents.
import arcpy
import os
arcpy.env.overwriteOutput = True
# set folder that contains packages to extract
arcpy.env.workspace = "C:/geoprocessing/gpks" 
wrksp = arcpy.env.workspace
for gpk in arcpy.ListFiles("*.gpk"):
    print("Extracting... " + gpk)
    arcpy.ExtractPackage_management(gpk, os.path.splitext(gpk)[0])
print("done")

Umgebungen

Aktueller Workspace

Lizenzinformationen

• Basic: Ja
• Standard: Ja
• Advanced: Ja