Résumé
Permet d’empaqueter un document ArcMap et toutes les sources de données référencées afin de créer un fichier .mpk compressé.
Utilisation
Un avertissement est émis lorsque cet outil détecte un type de couche non pris en charge. La couche non prise en charge ne sera pas écrite dans la sortie.
La couche en entrée doit avoir une description pour que l’outil puisse être exécuté. Pour ajouter une description, cliquez avec le bouton droit sur la couche, cliquez sur Propriétés et entrez une description.
Pour décompresser un paquetage de cartes, faites glisser le fichier .mpk dans ArcMap ou cliquez avec le bouton droit sur le fichier .mpk et cliquez sur Unpack (Décompresser). Vous pouvez également utiliser l'outil Extraire le paquetage et spécifier un dossier en sortie.
Par défaut, les paquetages sont extraits dans votre profil d'utilisateur.
- XP : C:\Documents and Settings\<username>\My Documents\ArcGIS\Packages
- Vista et Windows 7 : C:\Users\<username>\Documents\ArcGIS\Packages
Pour modifier l'emplacement cible par défaut des paquetages décompressés, ouvrez Options ArcMap dans le menu Personnaliser. Dans l’onglet Sharing (Partage), dans la section Packaging (Empaquetage), activez l’option Use user specified location (Utiliser l’emplacement spécifié par l’utilisateur), puis accédez à l’emplacement du nouveau dossier.
Lorsque la case Convertir les données en géodatabase fichier est cochée (convert_data = 'CONVERT' dans Python), voici ce qui se passe :
- Chaque source de données unique correspond à une géodatabase fichier créée dans le dossier ou paquetage consolidé.
- Les formats raster et vectoriel compressés sont convertis en une géodatabase fichier et la compression est perdue.
- Les données des géodatabases d'entreprise ne sont pas consolidées. Pour convertir les données de géodatabases d'entreprise en une géodatabase fichier, sélectionnez Include Enterprise geodatabase data instead of referencing the data (Inclure les données de géodatabase d'entreprise plutôt que de référencer les données).
Lorsque la case Convertir les données en géodatabase fichier n'est pas cochée (convert_data = 'PRESERVE' dans Python), voici ce qui se passe :
- Le format source des données des couches en entrée est préservé. Cela ne s'applique pas aux formats des données de géodatabases personnelles (.mdb), de données VPF et de tables basées sur des feuilles de calcul Excel ou des connexions OLEDB. Ces formats ne sont pas pris en charge dans les environnements 64x et sont toujours convertis en géodatabase fichier.
- Les formats raster ADRG, CADRG/ECRG, CIB et RPF sont toujours convertis en rasters de géodatabase fichier. ArcGIS ne peut pas écrire ces formats de manière native. Ils sont toujours convertis en rasters de géodatabase fichier pour des raisons d'efficacité.
- Dans la structure de dossier en sortie, les géodatabases fichier sont consolidées dans un dossier propre à chaque version, et tous les autres formats sont consolidés dans le dossier commonData.
- Les formats vectoriels et raster compressés ne sont pas découpés, même si une étendue est spécifiée dans le paramètre Extent (Étendue).
Lorsque l’option Support ArcGIS Runtime (Prise en charge d’ArcGIS Runtime) est activée (arcgisruntime='RUNTIME' dans Python), le paramètre Version est remplacé et le paquetage contient des géodatabases et une carte compatibles avec la version actuelle uniquement.
Pour les couches qui contiennent une jointure ou qui font partie d’une classe de relations, toutes les sources de données jointes ou associées sont consolidées dans le dossier en sortie. Par défaut, les sources de données jointes ou associées seront consolidées dans leur intégralité ou, en fonction du paramètre Select Related Rows (Sélectionner les lignes associées), selon l’étendue spécifiée à l’aide du paramètre Extent (Étendue).
Pour les couches d'entités, le paramètre Etendue permet de sélectionner les entités qui sont consolidées. Pour les couches raster, le paramètre Etendue permet de découper les jeux de données raster.
Certains jeux de données font référence à d'autres jeux de données. Par exemple, vous pouvez avoir un jeu de données de topologie qui référence quatre classes d'entités. Les réseaux géométriques, les réseaux et les localisateurs sont d'autres exemples de jeux de données référençant d'autres jeux de données. Lorsque vous consolidez ou empaquetez une couche en fonction de ces types de jeux de données, les jeux de données participants sont consolidés ou empaquetés.
S'il est activé, le paramètre Schema only (Structure uniquement) (schema_only = 'SCHEMA_ONLY' dans Python) permet uniquement de consolider ou d'empaqueter la structure des sources de données en entrée. Une structure correspond à la structure ou à la conception d'une classe d'entités ou d'une table qui consiste en des définitions de champ et de table, des propriétés de système de coordonnées, une symbologie, des ensembles de définition, etc. Les données ou enregistrements ne sont ni consolidés, ni empaquetés.
Les sources de données qui ne prennent pas en charge la structure seule ne sont ni consolidées, ni empaquetées. Si le paramètre Schema only (Structure uniquement) est sélectionné et que l'outil détecte une couche qui n'est pas prise en charge pour la structure uniquement, un message d'avertissement apparaît et cette couche est ignorée. Si la structure seule n'est pas prise en charge pour l'unique couche spécifiée, l'outil échouera.
Syntaxe
arcpy.management.PackageMap(in_map, output_file, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {arcgisruntime}, {reference_all_data}, {version}, {additional_files}, {summary}, {tags})| Paramètre | Explication | Type de données |
in_map | Document ArcMap à empaqueter. | ArcMap Document |
output_file | Paquetage de carte en sortie (.mpk). | File |
convert_data (Facultatif) | Spécifie si les couches en entrée seront converties en une géodatabase fichier ou si leur format original sera conservé.
| Boolean |
convert_arcsde_data (Facultatif) | Spécifie si les couches de géodatabases d'entreprise en entrée seront converties en une géodatabase fichier ou si leur format original sera conservé.
| Boolean |
extent (Facultatif) | Indique l'étendue en saisissant manuellement les coordonnées dans le paramètre d'étendue à l'aide du format X-Min Y-Min X-Max Y-Max. Pour utiliser l'étendue d'une couche spécifique, indiquez le nom de la couche.
| Extent |
apply_extent_to_arcsde (Facultatif) | Spécifie si l’étendue indiquée est appliquée à toutes les couches ou uniquement aux couches de géodatabases d’entreprise.
| Boolean |
arcgisruntime (Facultatif) | Spécifie si le paquetage prend en charge ArcGIS Runtime. Pour assurer la prise en charge d'ArcGIS Runtime, toutes les sources de données sont converties en une géodatabase fichier et un fichier .msd est créé dans le paquetage en sortie.
| Boolean |
reference_all_data (Facultatif) | En définissant cette option sur REFERENCED, vous créez un paquetage qui fait référence aux données nécessaires plutôt que de copier les données. Cette option est utile si vous essayez d'empaqueter des jeux de données importants disponibles à partir d'un emplacement central dans l'organisation.
| Boolean |
version [version,...] (Facultatif) | Spécifie la version des géodatabases qui vont être créées dans le paquetage obtenu. Lorsqu'une version est indiquée, les paquetages peuvent être partagés avec les versions précédentes d'ArcGIS et la compatibilité avec les versions ultérieures est assurée.
| String |
additional_files [additional_files,...] (Facultatif) | Ajoute des fichiers à un paquetage. Les fichiers supplémentaires, aux formats .doc, .txt, .pdf et autres, fournissent davantage d'informations sur le contenu et la fonction du paquetage. | File |
summary (Facultatif) | Ajoute un récapitulatif des propriétés du paquetage. | String |
tags (Facultatif) | Ajoute des informations sur les balises aux propriétés du paquetage. Vous pouvez ajouter plusieurs balises ou les séparer par une virgule ou un point-virgule. | String |
Exemple de code
Exemple 1 d'utilisation de l'outil PackageMap (fenêtre Python)
Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil PackageMap dans la fenêtre Python :
import arcpy
arcpy.env.workspace = "C:/arcgis/ArcTutor/Editing"
arcpy.PackageMap_management('Exercise1.mxd', 'EditingExercise1.mpk', "PRESERVE", "CONVERT_ARCSDE", "#", "ALL")
Exemple 2 d'utilisation de l'outil PackageMap (script autonome)
Recherche et crée des paquetages de cartes pour tous les documents ArcMap figurant dans un dossier donné.
# Name: PackageMap.py
# Description: Find all the map documents that reside in a specified folder and create map packages for each map document.
# import system modules
import os
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/arcgis/ArcTutor/Editing"
# Loop through the workspace, find all the mxds and create a map package using the same name as the mxd
for mxd in arcpy.ListFiles("*.mxd"):
print("Packaging: {0}".format(mxd))
arcpy.PackageMap_management(mxd, os.path.splitext(mxd)[0] + '.mpk', "PRESERVE", "CONVERT_ARCSDE", "#", "ALL")
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui