| Étiquette | Explication | Type de données |
Projet en entrée | Projet (fichier .aprx) à empaqueter. | File |
Fichier en sortie | Paquetage de projet en sortie (fichier .ppkx). | File |
Partager en dehors de l’organisation (Facultatif) | Indique si le projet va être consolidé pour votre environnement interne ou si tous les éléments de données doivent être déplacés afin de le partager en externe. Remarque :Les données et les cartes sont consolidées et empaquetées si le projet y fait référence à partir d’un chemin local, tel que c:\gisdata\landrecords.gdb\, quel que soit le paramètre.
| Boolean |
Empaqueter en tant que modèle (Facultatif) | Indique si un modèle de projet ou un paquetage de projet doit être créé. Les modèles de projet peuvent inclure des cartes, des mises en page, des connexions aux bases de données et serveurs, etc. Un modèle de projet permet de standardiser facilement une série de cartes pour différents projets et garantit que les couches appropriées sont immédiatement à la disposition des personnes qui veulent les utiliser dans leurs cartes.
| Boolean |
Étendue (Facultatif) | Spécifie l'étendue utilisée pour sélectionner ou découper les entités.
| Extent |
Appliquer l'étendue aux couches de géodatabases d'entreprise uniquement (Facultatif) | Spécifie si l’étendue indiquée est appliquée à toutes les couches ou uniquement aux couches de géodatabases d’entreprise.
| Boolean |
Fichiers supplémentaires (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 |
Résumé (Facultatif) | Ajoute un récapitulatif des propriétés du paquetage. | String |
Balises (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 |
Version de paquetage (Facultatif) | Spécifie la version des géodatabases qui vont être créées dans le paquetage obtenu. Lorsqu’une version est spécifiée, les paquetages peuvent être partagés avec les versions précédentes d’ArcGIS et la compatibilité avec les versions antérieures est assurée. Remarque :Un paquetage enregistré sous une version antérieure peut perdre les propriétés disponibles uniquement dans la version ultérieure.
| String |
Inclure les boîtes à outils (Facultatif) | Spécifie si les boîtes d’outils de projet, ainsi que les données référencées par les outils qu’elles contiennent, seront consolidées et incluses dans le paquetage en sortie. Tous les projets requièrent une boîte à outils par défaut, qui sera incluse quel que soit ce paramètre. Une boîte à outils à l’intérieur d’un dossier connecté n’est pas considérée comme une boîte à outils de projet et n’est pas concernée par ce paramètre.
| Boolean |
Inclure les éléments de l’historique (Facultatif) | Spécifie si les éléments de l’historique de géotraitement seront consolidés et inclus dans le paquetage en sortie. Les éléments de l’historique inclus consolideront les données requises pour réexécuter l’élément de l’historique en question.
| String |
Paquetage en lecture seule (Facultatif) | Indique si le projet sera en lecture seule. Les projets en lecture seule ne peuvent pas être modifiés ou enregistrés.
| Boolean |
Keep only the rows which are related to features within the extent (Conserver uniquement les lignes associées aux entités dans l’étendue) (Facultatif) | Détermine si l’étendue définie est appliquée aux sources de données associées.
| Boolean |
Synthèse
Permet de consolider et d’empaqueter un fichier de projet (.aprx) de cartes et de données référencées dans un fichier de projet empaqueté (.ppkx).
Utilisation
Tous les éléments d’un projet sont consolidés dans le paquetage de projet (.ppkx), notamment les cartes et vues 3D, les données et couches dans les cartes, les boîtes à outils, les éléments de l’historique de géotraitement, les styles, les mises en page et les dossiers ou connexions (serveur, processus, etc), le cas échéant.
Les paquetages de projets, par défaut, sont créés pour un usage interne. Le paramètre Partager en dehors de l'organisation vous permet de contrôler si un paquetage doit être créé pour un usage interne (au sein du réseau de votre organisation) ou externe. Lorsque le paramètre Partager en dehors de l'organisation est activé, les données et couches de géodatabase d'entreprise référencées à partir d'un chemin UNC sont intégrées dans le paquetage de projet.
Remarque :
Les sources de données doivent être référencées à partir d’une géodatabase d’entreprise ou d’un chemin d’accès à un fichier UNC pour que vous puissiez créer un paquetage interne dans lequel les données restent référencées. Les chemins d'accès aux données locales sont toujours consolidés et empaquetés. Un paquetage interne où les données sont uniquement référencées s'ouvre avec des liens rompus en cas de partage à l'extérieur de votre environnement ou avec des collègues qui n'ont pas accès à la géodatabase d'entreprise ou aux partages de données UNC.
Des modèles peuvent être créés à l'aide du paramètre Empaqueter en tant que modèle. Un modèle de projet (fichier .aptx) peut vous aider à créer un nouveau projet en définissant des couches, des cartes et des données, ainsi que les connexions requises.
Les boîtes d’outils qui font partie d’un projet sont analysées à l’aide de l’outil Analyser les outils pour Pro avant l’exécution de la consolidation. Si des erreurs sont détectées, le processus de consolidation est arrêté. Vous devez résoudre ces erreurs ou retirer l'outil du projet. Les données en entrée utilisées par l’outil sont consolidées, que les données fassent partie ou non d’une carte dans le projet. Vous pouvez exclure les boîtes à outils du paquetage de projet en sortie en décochant le paramètre Include Toolboxes (Inclure les boîtes à outils).
Tout comme des boîtes à outils de projets, l'historique de géotraitement (les informations résultant de l'exécution d'un outil de géotraitement) sera inclus dans le paquetage. Les informations nécessaires pour exécuter l’élément de l’historique seront incluses dans le paquetage en sortie, qu’elles existent ou non dans une carte ou une scène. Les éléments d'historique non valides (qui échouent pendant l'exécution) ou les données introuvables empêcheront la poursuite du processus de paquetage. Vous devrez supprimer ou réparer l’élément de l’historique qui pose problème. Vous pouvez exclure les éléments d’historique d’un paquetage de projet en décochant le paramètre Include History Items (Inclure les éléments de l’historique).
Les connexions—comme un dossier, serveur, une base de données, un workflow—sont uniquement intégrées dans un paquetage interne. Ces éléments sont supprimés si le paquetage créé est destiné à être partagé en dehors de votre organisation.
Les éléments, tels que les pièces jointes, les styles et les tâches sont référencés pour les paquetages internes s'ils faisaient partie du projet à partir d'un chemin UNC. Ces éléments sont copiés et empaquetés dans tous les autres cas.
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.
Les fichiers qui décrivent des cartes et données ou qui fournissent des informations supplémentaires peuvent être inclus dans le paquetage. Vous pouvez inclure des images, des fichiers PDF, des documents Word et des fichiers .zip dans le paquetage en les référençant avec le paramètre Additional Files (Fichiers supplémentaires).
Attention :
Les paquetages de projet (fichiers .ppkx) peuvent uniquement être créés et ouverts avec ArcGIS Pro.
Paramètres
arcpy.management.PackageProject(in_project, output_file, {sharing_internal}, {package_as_template}, {extent}, {apply_extent_to_arcsde}, {additional_files}, {summary}, {tags}, {version}, {include_toolboxes}, {include_history_items}, {read_only}, {select_related_rows})| Nom | Explication | Type de données |
in_project | Projet (fichier .aprx) à empaqueter. | File |
output_file | Paquetage de projet en sortie (fichier .ppkx). | File |
sharing_internal (Facultatif) | Indique si le projet va être consolidé pour votre environnement interne ou si tous les éléments de données doivent être déplacés afin de le partager en externe.
| Boolean |
package_as_template (Facultatif) | Indique si un modèle de projet ou un paquetage de projet doit être créé. Les modèles peuvent inclure des cartes, des mises en page, des connexions aux bases de données et serveurs, etc. Un modèle de projet permet de standardiser facilement une série de cartes pour différents projets et garantit que les couches appropriées sont immédiatement à la disposition des personnes qui veulent les utiliser dans leurs cartes. Pour en savoir plus sur les modèles de projet
| Boolean |
extent (Facultatif) | Spécifie l'étendue utilisée pour sélectionner ou découper les entités.
| 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 |
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 |
version [version,...] (Facultatif) | Spécifie la version des géodatabases qui vont être créées dans le paquetage obtenu. Lorsqu’une version est spécifiée, les paquetages peuvent être partagés avec les versions précédentes d’ArcGIS et la compatibilité avec les versions antérieures est assurée. Remarque :Un paquetage enregistré sous une version antérieure peut perdre les propriétés disponibles uniquement dans la version ultérieure.
| String |
include_toolboxes (Facultatif) | Spécifie si les boîtes d’outils de projet seront consolidées et incluses dans le paquetage en sortie. Tous les projets requièrent une boîte à outils par défaut, qui sera incluse quel que soit ce paramètre.
| Boolean |
include_history_items (Facultatif) | Spécifie si les éléments de l’historique de géotraitement seront consolidés et inclus dans le paquetage en sortie. Les éléments de l’historique inclus consolideront les données requises pour réexécuter l’élément de l’historique en question.
| String |
read_only (Facultatif) | Indique si le projet sera en lecture seule. Les projets en lecture seule ne peuvent pas être modifiés ou enregistrés.
| Boolean |
select_related_rows (Facultatif) | Détermine si l’étendue définie est appliquée aux sources de données associées.
| Boolean |
Exemple de code
Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil PackageProject dans la fenêtre Python.
import arcpy
p = arcpy.mp.ArcGISProject("CURRENT")
arcpy.PackageProject_management(p.filePath, 'E:\\gisShare\\projects\\Pipelines\\SE_Pipeline.ppkx', 'INTERNAL')Le script Python suivant transforme tous les projets d’un répertoire, dont le nom de fichier contient le mot oil, en paquetage de projet (.ppkx).
import os
import arcpy
enterpriseProjectDir = "\\\\centralFileServer\\gisData\\ArcGISProProjects"
sharedProjectDir = "c:\\publicFiles\\sharedProjects"
walk = arcpy.da.Walk(enterpriseProjectDir, datatype="Project")
for dirpath, dirnames, filenames in walk:
for filename in filenames:
if "OIL" in filename.upper():
project = os.path.join(dirpath, filename)
outputFile = os.path.join(sharedProjectDir, os.path.splitext(os.path.basename(project))[0] + ".ppkx")
print("Packaging: {0} to {1}".format(project, outputFile))
arcpy.PackageProject_management(project, outputFile, "EXTERNAL")Environnements
Cas particuliers
- Facteur de traitement parallèle
Si l’environnement n’est pas spécifié, l’outil utilise une moitié des cœurs disponibles.
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?