Extraire un paquetage (Gestion des données)

Synthèse

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

Utilisation

  • Les types de paquetage pris en charge sont 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 couches de scènes (.slpk)
    • 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 sera écrasé.

  • 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 (les fichiers .pdf, .docx ou une image, par exemple). Accédez au répertoire extrait dans Microsoft File Explorer 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.

    Remarque :

    L’extraction d’un cache plat peut être lente et donner lieu à l’extraction de milliards de tuiles en fonction de l’étendue des données, des niveaux de détail du paquetage et de la configuration matérielle.

  • Lors de l’extraction de paquetages de couches vectorielles, de couches de tuile ou de couches de scène (.vtpk, .tpk, .tpkx ou .slpk), le paramètre Cache Package (Mettre le paquetage en cache) est inactif.

  • Lors de l’extraction de paquetages de couches vectorielles, de couches de tuiles et de couches de scène version 1.7 ou ultérieure, vous pouvez extraire le contenu du paquetage dans un dossier du système de fichiers ou dans un magasin d’objets situé dans le (stockage Amazon S3, Azure Blob ou Alibaba OSS, par exemple). Ce contenu est déjà prêt à faire office de couche de tuiles ou de scènes et l’emplacement que vous choisissez doit être de nouveau enregistré en tant que Data Store géré par l’utilisateur dans ArcGIS Enterprise.

  • Vous pouvez créer un fichier de connexion (.acs) à l’aide de l’outil Create Cloud Storage Connection File (Créer un fichier de connexion au stockage cloud).

  • Les anciennes versions de couches de scènes peuvent être mises à niveau vers la dernière version à l’aide de l’outil Upgrade Scene Layer (Mettre la couche de scènes à niveau).

  • Remarque :

    Lors de l’extraction de paquetages de couches de scènes dans un magasin d’objets dans le cloud (.i3sREST), le format de stockage du cache de scène n’est pas le même que lors de l’extraction dans un dossier du système de fichiers (.eslpk), et les deux formats ne sont pas interchangeables.

Paramètres

ÉtiquetteExplicationType de données
Paquetage en entrée

Paquetage en entrée qui va être extrait.

File
Dossier en sortie
(Facultatif)

Dossier en sortie qui contiendra le contenu du paquetage.

Si le dossier spécifié n’existe pas, il est créé.

Folder
Mettre le paquetage en cache
(Facultatif)

Spécifie si une copie du paquetage sera mise en cache pour votre profil.

Lors de l’extraction d’un paquetage, la sortie est en premier lieu extraite vers votre profil utilisateur et ajoutée avec un ID unique avant la copie dans le répertoire spécifié dans le paramètre Output Folder (Dossier en sortie). Le téléchargement et l’extraction des versions suivantes du même paquetage mettra uniquement à jour cet emplacement. Lors de l’utilisation de ce paramètre, il n’est pas utile de créer manuellement une version mise en cache du paquetage dans votre profil utilisateur. Ce paramètre n’est pas actif si le paquetage en entrée est un paquetage de tuiles vectorielles (.vtpk) ou un paquetage de tuiles (.tpk et .tpkx).

  • Activé : une copie du paquetage sera extraite et mise en cache dans votre profil. Il s’agit de l’option par défaut.
  • Désactivé : une copie du paquetage sera uniquement extraite dans le paramètre en sortie spécifié. Elle ne sera pas mise en cache.
Boolean
Type de format de stockage
(Facultatif)

Spécifie le format de stockage du cache qui sera utilisé pour le cache extrait. Ce paramètre s’applique uniquement si le paquetage en entrée est un paquetage de tuiles vectorielles (.vtpk).

  • CompacteLes tuiles sont regroupées dans des fichiers de paquet en utilisant le 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.
  • EclatéChaque tuile sera stockée en tant que fichier individuel.
String
Créer un jeu de données en cache prêt à l’emploi
(Facultatif)

Spécifie si un format prêt à l’emploi pour ArcGIS Enterprise sera créé. Ce paramètre est actif uniquement si le paquetage en entrée est un paquetage de tuiles vectorielles (.vtpk) ou un paquetage de tuiles (.tpkx).

  • Activé : une structure de dossiers dont le cache extrait peut être utilisé pour créer une couche de tuiles dans ArcGIS Enterprise sera utilisée. L’extension de fichier du dossier indique son contenu : .tiles (jeu de données du cache) pour les paquetages de couches de tuiles ou .vtiles (jeu de données vectorielles en cache) pour les paquetages de tuiles vectorielles.
  • Désactivé : une structure de dossiers avec le contenu extrait du paquetage sera créée. Il s’agit de l’option par défaut.
Boolean
Connexion Cloud cible
(Facultatif)

Le fichier .acs cible vers lequel le contenu du paquetage sera extrait. Ce paramètre est activé uniquement si le paquetage en entrée est un paquetage de couches de scènes (.slpk), un paquetage de tuiles vectorielles (.vtpk) ou un paquetage de tuiles (.tpkx).

Folder

arcpy.management.ExtractPackage(in_package, {output_folder}, {cache_package}, {storage_format_type}, {create_ready_to_serve_format}, {target_cloud_connection})
NomExplicationType de données
in_package

Paquetage en entrée qui va être extrait.

File
output_folder
(Facultatif)

Dossier en sortie qui contiendra le contenu du paquetage.

Si le dossier spécifié n’existe pas, il est créé.

Folder
cache_package
(Facultatif)

Spécifie si une copie du paquetage sera mise en cache pour votre profil.

Lors de l’extraction d’un paquetage, la sortie est en premier lieu extraite vers votre profil utilisateur et ajoutée avec un ID unique avant la copie 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 mettra uniquement à jour cet emplacement. Lors de l’utilisation de ce paramètre, il n’est pas utile de créer manuellement une version mise 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).

  • CACHEUne copie du paquetage sera extraite et mise en cache dans votre profil. Il s’agit de l’option par défaut.
  • NO_CACHEUne copie du paquetage sera uniquement extraite dans le paramètre en sortie spécifié. Elle ne sera pas mise en cache.
Boolean
storage_format_type
(Facultatif)

Spécifie le format de stockage du cache qui sera utilisé pour le cache extrait. Ce paramètre s’applique uniquement si le paquetage en entrée est un paquetage de tuiles vectorielles (.vtpk).

  • COMPACTLes tuiles sont regroupées dans des fichiers de paquet en utilisant le 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.
  • EXPLODEDChaque tuile sera stockée en tant que fichier individuel.
String
create_ready_to_serve_format
(Facultatif)

Spécifie si un format prêt à l’emploi pour ArcGIS Enterprise sera créé. Ce paramètre est activé uniquement si le paquetage en entrée est un paquetage de tuiles vectorielles (.vtpk) ou un paquetage de tuiles (.tpkx).

  • READY_TO_SERVE_CACHE_DATASETUne structure de dossiers dont le cache extrait peut être utilisé pour créer une couche de tuiles dans ArcGIS Enterprise sera utilisée. L’extension de fichier du dossier indique son contenu : .tiles (jeu de données du cache) pour les paquetages de couches de tuiles ou .vtiles (jeu de données vectorielles en cache) pour les paquetages de tuiles vectorielles.
  • EXTRACTED_PACKAGEUne structure de dossiers avec le contenu extrait du paquetage sera créée. Il s’agit de l’option par défaut.
Boolean
target_cloud_connection
(Facultatif)

Le fichier .acs cible vers lequel le contenu du paquetage sera extrait. Ce paramètre est activé uniquement si le paquetage en entrée est un paquetage de couches de scènes (.slpk), un paquetage de tuiles vectorielles (.vtpk) ou un paquetage de tuiles (.tpkx).

Folder

Exemple de code

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

Le script de fenêtre Python suivant montre comment utiliser la fonction ExtractPackage pour générer des jeux de données en cache prêts à l’emploi qui peuvent être utilisés dans les workflows 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")
Exemple 2 d’utilisation de l’outil ExtractPackage (fenêtre Python)

Le script de fenêtre Python suivant montre comment utiliser la fonction ExtractPackage pour extraire des paquetages de couches de scènes dans un magasin d’objets qui peut être utilisé dans les workflows de publication ArcGIS Enterprise.

import arcpy
arcpy.management.ExtractPackage(r"C:\Data\packages\ChicagoBuildings.slpk", 
                                None, "CACHE", 
                                "COMPACT", "EXTRACTED_PACKAGE", 
                                r"C:\CloudConnections\AWS.acs")
Exemple 3 d'utilisation de l'outil ExtractPackage (fenêtre Python)

Le script de fenêtre Python suivant montre comment utiliser la fonction ExtractPackage pour extraire des paquetages de couches de tuiles vectorielles dans un magasin d’objets qui peut être utilisé dans les workflows de publication ArcGIS Enterprise.

import arcpy
arcpy.management.ExtractPackage(r"C:\Data\packages\London.vtpk", 
                                None, "CACHE", 
                                "COMPACT", "EXTRACTED_PACKAGE", 
                                r"C:\CloudConnections\AWS.acs")
Exemple 4 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.management.ExtractPackage(gpk, os.path.splitext(gpk)[0])

print("done")