Extraire un paquetage (Gestion des données)

Synthèse

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)
    • Paquetage de cartes mobiles (.mmpk)
    • Paquetages de projets et de modèles de projet (.ppkx et .aptx)
    • Paquetages de couche 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 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 ou .docx ou une image. Accédez 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 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 vectoriels, de tuiles ou de couche de scènes (.vtpk, .tpk, .tpkx ou .slpk), le paramètre Mettre le paquetage en cache est désactivé.

  • Lors de l’extraction de paquetages vectoriels, de tuiles ou de couche de scènes version 1.7 et ultérieures, vous pouvez extraire le contenu du paquetage dans un dossier du système de fichiers ou un répertoire d’objets situé dans le cloud tel que le stockage Amazon S3, Azure Blob ou Alibaba OSS. Le contenu est prêt à être utilisé comme couche de tuiles ou de scènes et l’emplacement choisi doit être 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 Créer un fichier de connexion au stockage cloud.

  • Les anciennes versions des paquetages de couche de scènes peuvent être mises à niveau vers la dernière version à l’aide de l’outil Mettre à niveau la couche de scène.

  • Remarque :

    Lors de l’extraction de paquetages de couche de scènes vers un répertoire d’objets dans le cloud (.i3sREST), le format de stockage du cache de scènes n’est pas le même que lors de l’extraction vers 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 doit contenir le contenu du paquetage.

Si le dossier spécifié n'existe pas, un dossier est créé.

Folder
Mettre le paquetage en cache
(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 (Dossier en sortie). 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 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 est extraite et mise en cache dans votre profil. Il s’agit de l’option par défaut.
  • Désactivé : une copie du paquetage ne sera extraite que 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 qui sera utilisé pour le cache extrait. Ce paramètre ne peut être appliqué que lorsque le paquetage en entrée est un paquetage de tuiles vectorielles (.vtpk).

  • CompacterLes 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.
  • EclatéChaque tuile est stockée en tant que fichier individuel.
String
Créer un jeu de données de cache prêt à l’emploi
(Facultatif)

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

  • Sélectionné : 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.
  • Non sélectionné : une structure de dossier sera créée comprenant le contenu extrait du paquetage. Il s’agit de l’option par défaut.
Boolean
Connexion cloud cible
(Facultatif)

Fichier .acs cible dans lequel le contenu du paquetage est extrait. Ce paramètre n’est activé que lorsque le paquetage en entrée est un paquetage de couche 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 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).

  • CACHEUne copie du paquetage est extraite et mise en cache dans votre profil. Il s’agit de l’option par défaut.
  • NO_CACHEUne copie du paquetage ne sera extraite que 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 qui sera utilisé pour le cache extrait. Ce paramètre ne peut être appliqué que lorsque le paquetage en entrée est un paquetage de tuiles vectorielles (.vtpk).

  • COMPACTLes 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.
  • EXPLODEDChaque tuile est stockée en tant que fichier individuel.
String
create_ready_to_serve_format
(Facultatif)

Spécifie si 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_DATASETUne 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_PACKAGEUne structure de dossier sera créée comprenant le contenu extrait du paquetage. Il s’agit de l’option par défaut.
Boolean
target_cloud_connection
(Facultatif)

Fichier .acs cible dans lequel le contenu du paquetage est extrait. Ce paramètre n’est activé que lorsque le paquetage en entrée est un paquetage de couche 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 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")
Exemple 2 d’utilisation de l’outil ExtractPackage (fenêtre Python)

Le script de fenêtre Python ci-dessous montre comment utiliser la fonction ExtractPackage pour extraire des paquetages de couche de scènes vers un répertoire d’objets pouvant être utilisé dans les processus 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 ci-dessous montre comment utiliser la fonction ExtractPackage pour extraire des paquetages de tuiles vectorielles vers un répertoire d’objets pouvant être utilisé dans les processus 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.ExtractPackage_management(gpk, os.path.splitext(gpk)[0])

print("done")

Environnements

Cas particuliers

Informations de licence

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

Rubriques connexes