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

• Parmi les types de paquetages pris en charge, on compte les suivants :

  • 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 déjà 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. Habituellement, les fichiers compris dans un paquetage sont pris en charge, à savoir des 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 et le format de stockage du cache est converti du type compact (fichiers .bundle) au type éclaté (fichiers .pbf). Vous pouvez utiliser les fichiers .pbf extraits dans d'autres applications clientes, telles que Mapbox, le cas échéant.

• 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

ExtractPackage(in_package, output_folder, {cache_package})

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 nouveau 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. Si vous téléchargez et extrayez les versions suivantes du même paquetage, seul cet emplacement est mis à jour, le cas échéant. Avec ce paramètre, il n’est pas nécessaire de créer manuellement une version en cache du paquetage dans votre profil utilisateur. CACHE — Les paquetages sont extraits sous forme de copie à mettre en cache dans votre profil. Il s’agit de l’option par défaut. NO_CACHE —Les paquetages sont uniquement extraits dans le paramètre en sortie spécifié.	Boolean

Exemple de code

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

Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil ExtractPackage.

import arcpy
arcpy.env.workspace = "C:/arcgis/ArcTutor/Getting_Started/Greenvalley" 
arcpy.ExtractPackage_management('WaterUsePackage.lpk', 
                                'C:/My_Data/Packages/WaterUse_unpacked')

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 à l’outil ExtractPackage pour extraire le contenu dans le dossier spécifié.

# Name: ExtractPackage.py
# Description: Find Geoprocesssing Packages within 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