Extraire un paquetage (Outils de gestion des données)

Résumé

Extrait le contenu d’un paquetage dans un dossier spécifié. Le dossier en sortie est 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 mobiles (.mmpk)
- Paquetages de projets et modèles de projet (.ppkx et .aptx)
- Paquetages de couche de scène (.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 dans 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 écrasé.
Les fichiers joints inclus dans les paquetages sont décompressés dans le sous-dossier commondata\\userdata\\ du dossier en sortie. Habituellement, les fichiers inclus dans un paquetage sont des fichiers complémentaires, par exemple .pdf ou .docx, ou des images. Accédez au répertoire extrait dans l’explorateur de fichiers Microsoft pour les ouvrir.
Dans le cas de l’extraction d’un paquetage 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 tuiles vectorielles, de paquetages de tuiles ou de paquetages de couche 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 tuiles vectorielles, de paquetages de tuiles ou de paquetages de couche de scène de version 1.7 ou ultérieure, vous pouvez extraire le contenu du paquetage dans un dossier du système de fichiers ou dans un object store [situé dans le cloud(../../help/projects/connect-to-cloud-stores.md), comme Amazon S3, le stockage Azure Blob ou Alibaba OSS. Ce contenu peut servir de couche de tuiles ou de scène et l’emplacement que vous choisissez doit être inscrit 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 des paquetages de couche de scène peuvent être mises à niveau vers la dernière version à l’aide de l’outil Upgrade Scene Layer (Mettre à niveau la couche de scène).

Remarque :

Lors de l’extraction de paquetages de couche de scène dans un object store 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.

Etiqueter	Explication	Type 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 d’abord extraite dans votre profil utilisateur et un ID unique lui est ajouté avant qu’elle ne soit copié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 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`). Activé—Une copie du paquetage sera extraite et mise en cache dans votre profil. Il s’agit de l’option par défaut. Décoché—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 est applicable uniquement lorsque le paquetage en entrée est un paquetage de tuiles vectorielles (`.vtpk`). Compact—Les 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. Éclaté—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)	Indique si un format prêt à l’emploi pour ArcGIS Enterprise est créé. Ce paramètre est activé uniquement lorsque le paquetage en entrée est un paquetage de tuiles vectorielles (`.vtpk`) ou un paquetage de tuiles (`.tpkx`). Activé—Une structure de dossier comprenant un cache extrait pouvant servir à créer une couche de tuiles dans ArcGIS Enterprise est créée. L’extension de fichier du dossier indique son contenu : `.tiles` (jeu de données en cache) pour les paquetages de couche de tuiles ou `.vtiles` (jeu de données vectorielles en cache) pour les paquetages de tuiles vectorielles. Décoché—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)	Fichier `.acs` cible dans lequel sera extrait le contenu du paquetage. Ce paramètre est activé uniquement lorsque le paquetage en entrée est un paquetage de couche de scène (`.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})

Nom	Explication	Type 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 d’abord extraite dans votre profil utilisateur et un ID unique lui est ajouté avant qu’elle ne soit copié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 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`). `CACHE`—Une copie du paquetage sera extraite et mise en cache dans votre profil. Il s’agit de l’option par défaut. `NO_CACHE`—Une 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 est applicable uniquement lorsque le paquetage en entrée est un paquetage de tuiles vectorielles (`.vtpk`). `COMPACT`—Les 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. `EXPLODED`—Chaque tuile sera stockée en tant que fichier individuel.	String
create_ready_to_serve_format (Facultatif)	Indique si un format prêt à l’emploi pour ArcGIS Enterprise est créé. Ce paramètre est activé uniquement 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 comprenant un cache extrait pouvant servir à créer une couche de tuiles dans ArcGIS Enterprise est créée. L’extension de fichier du dossier indique son contenu : `.tiles` (jeu de données en cache) pour les paquetages de couche de tuiles ou `.vtiles` (jeu de données vectorielles en cache) pour les paquetages de tuiles vectorielles. `EXTRACTED_PACKAGE`—Une 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)	Fichier `.acs` cible dans lequel sera extrait le contenu du paquetage. Ce paramètre est activé uniquement lorsque le paquetage en entrée est un paquetage de couche de scène (`.slpk`), un paquetage de tuiles vectorielles (`.vtpk`) ou un paquetage de tuiles (`.tpkx`).	Folder

Exemple de code

ExtractPackage Exemple 1 (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de 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 processus de publication d’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")

ExtractPackage Exemple 2 (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction ExtractPackage pour extraire des paquetages de couche de scène dans un object store qui peut être utilisé dans les processus de publication d’ArcGIS Enterprise.

import arcpy
arcpy.management.ExtractPackage(r"C:\Data\packages\ChicagoBuildings.slpk",
                                None, "CACHE",
                                "COMPACT", "EXTRACTED_PACKAGE",
                                r"C:\CloudConnections\AWS.acs")

ExtractPackage Exemple 3 (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction ExtractPackage pour extraire des paquetages de couche de tuiles vectorielles dans un object store qui peut être utilisé dans les processus de publication d’ArcGIS Enterprise.

import arcpy
arcpy.management.ExtractPackage(r"C:\Data\packages\London.vtpk",
                                None, "CACHE",
                                "COMPACT", "EXTRACTED_PACKAGE",
                                r"C:\CloudConnections\AWS.acs")

ExtractPackage Exemple 4 (script autonome)

Localisez tous les paquetages de géotraitement stockés dans un dossier donné 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")

Environnements

Espace de travail courant

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui