Étiquette | 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 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).
| 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).
| 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).
| 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 |
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
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 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).
| 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).
| 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).
| 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
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")
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")
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")
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")
Environnements
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?