Extraire un paquetage (Gestion des données)

Résumé

Extrait le contenu d'un paquetage vers un dossier spécifié. Le dossier en sortie est mis à jour avec le contenu extrait du paquetage en entrée.

Utilisation

• Les types de paquetages suivants sont pris en charge :

  • Paquetages de géotraitement (.gpk et .gpkx)
  • Paquetages de couches (.lpk et .lpkx)
  • Paquetages de localisateurs (.gcpk)
  • Paquetages de cartes (.mpk et .mpkx)
  • Paquetages de cartes nomades (.mmpk)
  • Paquetages de projets et de modèles de projet (.ppkx et .aptx)
  • Paquetages de tuiles (.tpk et .tpkx)
  • Paquetages de tuiles vectorielles (.vtpk)

• Le dossier en sortie peut être un nouveau dossier ou un dossier existant. Lors de l'extraction vers un dossier existant, le contenu du paquetage est ajouté aux fichiers et dossiers existants. Si le dossier en sortie contient le contenu extrait du paquetage, le contenu existant est remplacé.

• Les fichiers compris dans des paquetages comportant des pièces jointes sont décompressés dans le sous-dossier commondata\userdata\ du dossier en sortie. Les fichiers inclus dans un paquetage sont généralement pris en charge, comme les fichiers .pdf, .docx ou une image. Vous devez accéder au répertoire extrait dans l'Explorateur Windows pour ouvrir ces fichiers.

• Lors de l'extraction de paquetages de tuiles vectorielles (.vtpk), le contenu du paquetage est extrait dans le dossier en sortie. Le format de stockage du cache peut être converti du type compact (fichiers .bundle) au type éclaté (fichiers .pbf) à l’aide du paramètre Storage Format Type (Type de format de stockage). Vous pouvez utiliser les fichiers .pbf extraits dans d'autres applications clientes, telles que Mapbox.

• Lors de l’extraction de paquetages de tuiles (.tpk, .tpkx ou .vtpk), le paramètre Cache Package (Mettre le paquetage en cache) est désactivé.

Syntaxe

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

Paramètre	Explication	Type de données
in_package	Paquetage en entrée qui va être extrait.	File
output_folder	Dossier en sortie qui doit contenir le contenu du paquetage. Si le dossier spécifié n'existe pas, un dossier est créé.	Folder
cache_package (Facultatif)	Indique si une copie du paquetage doit être mise en cache dans votre profil. Lorsque vous extrayez un paquetage, la sortie est d’abord extraite dans votre profil utilisateur et ajoutée avec un ID unique avant qu’une copie ne soit réalisée dans le répertoire spécifié, dans le paramètre output_folder. Le téléchargement et l’extraction des versions suivantes du même paquetage ne feront que mettre à jour cet emplacement. Lorsque vous utilisez ce paramètre, il n’est pas nécessaire de créer manuellement une version en cache du paquetage dans votre profil utilisateur. Ce paramètre n’est pas activé si le paquetage en entrée est un paquetage de tuiles vectorielles (.vtpk) ou un paquetage de tuiles (.tpk et .tpkx). CACHE — Une copie du paquetage est extraite et mise en cache dans votre profil. Il s’agit de l’option par défaut. NO_CACHE —Une copie du paquetage ne sera extraite que dans le paramètre en sortie spécifié.	Boolean
storage_format_type (Facultatif)	Spécifie le format de stockage du cache extrait. Ce paramètre ne peut être appliqué que lorsque le paquetage en entrée est un paquetage de tuiles vectorielles (.vtpk). COMPACT — Les tuiles sont regroupées dans des fichiers de paquets à l’aide du format de stockage compact V2 . Ce format offre de meilleures performances sur les partages réseau et les répertoires de stockage cloud. Il s’agit de l’option par défaut. EXPLODED — Chaque tuile est stockée en tant que fichier individuel.	String
create_ready_to_serve_format (Facultatif)	Spécifie qu’un format prêt à l’emploi sera créé pour ArcGIS Enterprise. Ce paramètre n’est activé que lorsque le paquetage en entrée est un paquetage de tuiles vectorielles (.vtpk) ou un paquetage de tuiles (.tpkx). READY_TO_SERVE_CACHE_DATASET —Une structure de dossier avec un cache extrait pouvant servir à créer une couche de tuiles dans ArcGIS Enterprise sera créée. L’extension de fichier du dossier indique son contenu : .tiles (jeu de données du cache) pour les paquetages de couche de tuiles ou .vtiles (jeu de données de cache vectoriel) pour les paquetages de tuiles vectorielles. EXTRACTED_PACKAGE —Une structure de dossier sera créée comprenant le contenu extrait du paquetage. Il s’agit de l’option par défaut.	Boolean

Exemple de code

Exemple 1 d'utilisation de l'outil ExtractPackage (fenêtre Python)

Le script de fenêtre Python ci-dessous montre comment utiliser la fonction ExtractPackage pour générer des jeux de données de cache prêts à l’emploi pouvant être utilisés dans les processus de publication ArcGIS Enterprise.

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

Deuxième exemple d'utilisation de l'outil ExtractPackage (script autonome)

Localisez tous les paquetages de géotraitement stockés dans un dossier spécifié et faites appel à la fonction ExtractPackage pour extraire le contenu dans le dossier spécifié.

# 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")

Environnements

Espace de travail courant

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui