Empaqueter un projet (Outils de gestion des données)

Résumé

Permet de consolider et d’empaqueter un projet ArcGIS Pro (.aprx) et son contenu (cartes et données) dans un fichier de projet empaqueté (.ppkx).

Utilisation

Les données et éléments du 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.
Le paramètre Share outside of organization (Partager en dehors de l’organisation) permet d’indiquer si un paquetage doit être créé pour un usage interne (au sein du réseau de votre organisation) ou externe. Lorsque le paramètre Share outside of organization (Partager en dehors de l’organisation) est activé, les couches de géodatabase d’entreprise, les services d’entités et les données qui sont référencés sur des partages réseau (chemin UNC) sont copiés (ou convertis) et inclus dans le paquetage de projet. Les données stockées sur la machine locale sont également consolidées et empaquetées.

Remarque :

Un paquetage interne contenant les données référencées s’ouvre avec des liens rompus en cas de partage avec des collègues qui n’ont pas accès aux ressources de réseau (géodatabase d’entreprise, service d’entités et données référencées via des partages de disque [chemins UNC]).
Des modèles peuvent être créés à l’aide du paramètre Package as template (Empaqueter en tant que modèle). Vous pouvez utiliser un modèle de projet (fichier .aptx) pour créer un projet en définissant des couches, des cartes et des données, ainsi que les connexions requises.

En savoir plus sur la création d’un modèle de projet
Utilisez les outils Analyze Tools for Pro (Analyser les outils pour Pro) et Analyze Toolbox for Version (Analyser la boîte à outils pour une version) afin d’analyser les boîtes à outils faisant partie d’un projet avant de procéder à la consolidation. Les erreurs identifiées peuvent arrêter le processus de consolidation. Résolvez les erreurs ou retirez l’outil du 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).
À l’instar des boîtes à outils du projet, l’historique de géotraitement (les informations résultant de l’exécution d’un outil de géotraitement) est inclus dans le paquetage. Les données nécessaires au traitement de l’élément d’historique sont incluses dans le paquetage en sortie, qu’elles soient présentes dans une carte ou dans une scène. Les éléments d’historique non valides (qui échouent pendant l’exécution) ou les données introuvables empêchent la poursuite du traitement de l’empaquetage. Vous devez supprimer ou résoudre l’élément d’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).
Connections—comme un dossier, un serveur, une base de données ou un processus, figurent uniquement dans un paquetage interne. Ces éléments sont supprimés si le paquetage est créé avec le paramètre Share outside of organization (Partager en dehors de l’organisation) sélectionné.
Pour les couches d’entités, utilisez le paramètre Extent (Étendue) afin de sélectionner les entités à consolider. Pour les couches raster, utilisez le paramètre Extent (Étendue) pour découper les jeux de données raster.
Des fichiers 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 utilisant 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.

Etiqueter	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 et toutes les données seront consolidés, convertis ou copiés dans le paquetage (pour un partage en dehors de l’organisation) ou référencés tels quels sans les convertir ou les inclure dans le paquetage (pour un partage au sein de l’organisation). Activé—Les données stockées sur des ressources de réseau seront consolidées, converties ou copiées dans le paquetage. Les formats de données seront conservés lorsque cela est possible. Décoché—Les données stockées sur des ressources de réseau, telles que les géodatabases d’entreprise, les services d’entités et les partages de fichiers (chemin UNC) seront référencées telles quelles sans les convertir ou les inclure dans le paquetage. Il s’agit de l’option par défaut.	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 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. En savoir plus sur la création d’un modèle de projet Activé—Un modèle de projet sera créé. Décoché—Un paquetage de projet sera créé. Il s’agit de l’option par défaut.	Boolean
Etendue (Facultatif)	Spécifie l’étendue utilisée pour sélectionner ou découper les entités. Current Display Extent (Étendue actuellement affichée) : l’étendue repose sur la carte ou scène active. Draw Extent (Dessiner l’étendue) : l’étendue est basée sur un rectangle dessiné sur la carte ou dans la scène. Extent of a Layer (Étendue d’une couche) : l’étendue repose sur une couche de carte active. Choisissez une couche disponible ou utilisez l’option Étendue des données dans toutes les couches. Chaque couche de carte comporte les options suivantes : All Features (Toutes les entités) : étendue de toutes les entités. Selected Features (Entités sélectionnées) : étendue des entités sélectionnées. Visible Features (Entités visibles) : étendue des entités visibles. Browse (Parcourir) : l’étendue repose sur un jeu de données existant. Intersection of Inputs (Intersection des entrées) : l’étendue repose sur l’étendue d’intersection de toutes les entrées. Union of Inputs (Union des entrées) : l’étendue est basée sur l’étendue combinée de toutes les entrées. Clipboard (Presse-papiers) : l’étendue peut être copiée depuis et vers le Presse-papiers. Copy Extent (Copier l’étendue) : copie l’étendue et le système de coordonnées dans le Presse-papiers. Paste Extent (Coller l’étendue) : colle l’étendue et les coordonnées depuis le Presse-papiers. Si le Presse-papiers n’inclut pas de système de coordonnées, l’étendue utilise celui de la carte. Reset Extent (Réinitialiser l’étendue) : la valeur par défaut de l’étendue est rétablie. Lorsque les coordonnées sont saisies manuellement, elles doivent être des valeurs numériques incluses dans le système de coordonnées de la carte active. La carte peut utiliser des unités d’affichage différentes de celles des coordonnées saisies. Utilisez le signe moins pour les coordonnées sud et ouest.	Extent
Appliquer l’étendue aux couches de géodatabases d’entreprise uniquement (Facultatif)	Indique si l’étendue spécifiée est appliquée à toutes les couches ou aux couches de géodatabases d’entreprise. Activé—L’étendue spécifiée est appliquée uniquement aux couches de géodatabases d’entreprise. Décoché—L’étendue spécifiée est appliquée à toutes les couches. Il s’agit de l’option par défaut.	Boolean
Fichiers supplémentaires (Facultatif)	Fichiers supplémentaires qui seront inclus dans le paquetage.	File
Résumé (Facultatif)	Les informations sur le récapitulatif qui seront ajoutées aux propriétés du paquetage.	String
Balises (Facultatif)	Les balises qui seront ajoutées aux propriétés du paquetage. Séparez plusieurs balises en les séparant par une virgule ou un point-virgule.	String
Version de paquetage (Facultatif)	Indique la version ArcGIS Pro avec laquelle certains objets tels que des projets, cartes et couches seront compatibles et dans laquelle ils seront conservés. L’enregistrement dans une version antérieure peut être utile si le projet est utilisé avec un logiciel plus ancien. Attention : Un paquetage enregistré sous une version antérieure peut perdre les fonctions ou propriétés qui ne sont pas prises en charge dans la version antérieure. Toutes les versions—Le contenu du paquetage est compatible avec toutes les versions (ArcGIS Pro 2.1 et versions ultérieures). Version actuelle—Le contenu du paquetage est compatible avec la version ArcGIS Pro actuelle. ArcGIS Pro 2.2—Le contenu du paquetage est compatible avec la version ArcGIS Pro 2.2. ArcGIS Pro 2.3—Le contenu du paquetage est compatible avec la version ArcGIS Pro 2.3. ArcGIS Pro 2.4—Le contenu du paquetage est compatible avec la version ArcGIS Pro 2.4. ArcGIS Pro 2.5—Le contenu du paquetage est compatible avec la version ArcGIS Pro 2.5. ArcGIS Pro 2.6—Le contenu du paquetage est compatible avec la version ArcGIS Pro 2.6. ArcGIS Pro 2.7—Le contenu du paquetage est compatible avec la version ArcGIS Pro 2.7. ArcGIS Pro 2.8—Le contenu du paquetage est compatible avec la version ArcGIS Pro 2.8. ArcGIS Pro 2.9—Le contenu du paquetage est compatible avec la version ArcGIS Pro 2.9. ArcGIS Pro 3.0—Le contenu du paquetage est compatible avec la version ArcGIS Pro 3.0. ArcGIS Pro 3.1—Le contenu du paquetage est compatible avec la version ArcGIS Pro 3.1. ArcGIS Pro 3.2—Le contenu du paquetage est compatible avec la version ArcGIS Pro 3.2. ArcGIS Pro 3.3—Le contenu du paquetage est compatible avec la version ArcGIS Pro 3.3. ArcGIS Pro 3.4—Le contenu du paquetage est compatible avec la version ArcGIS Pro 3.4. ArcGIS Pro 3.5—Le contenu du paquetage est compatible avec la version ArcGIS Pro 3.5. ArcGIS Pro 3.6—Le contenu du paquetage est compatible avec la version ArcGIS Pro 3.6. ArcGIS Pro 3.7—Le contenu du paquetage est compatible avec la version ArcGIS Pro 3.7.	String
Inclure les boîtes à outils (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 dans le paquetage en sortie quel que soit ce paramètre. Activé—Les boîtes à outils du projet seront incluses dans le paquetage en sortie. Il s’agit de l’option par défaut. Décoché—Les boîtes à outils du projet ne seront pas incluses dans le paquetage en sortie.	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 d’historique inclus consolideront les données requises pour le retraitement de l’élément d’historique. Les éléments de l’historique seront inclus—Les éléments de l’historique seront inclus dans le paquetage en sortie. Il s’agit de l’option par défaut. Les éléments d’historique ne seront pas inclus—Les éléments d’historique ne seront pas inclus dans le paquetage en sortie. Seuls les éléments de l’historique valides seront inclus—Seuls les éléments de l’historique valides seront inclus dans le paquetage en sortie. Les éléments de l’historique ne sont pas valides si l’une des couches en entrée d’origine ou l’un des outils est introuvable.	String
Paquetage en lecture seule (Facultatif)	Indique si le projet sera en lecture seule. Les projets en lecture seule ne peuvent être ni modifiés, ni enregistrés. Activé—Le projet sera en lecture seule. Décoché—Le projet sera accessible en écriture. Il s’agit de l’option par défaut.	Boolean
Keep only the rows that 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. Activé—Seules les données associées correspondant aux enregistrements situés dans l’étendue définie sont consolidées. Décoché—Les sources de données associées sont consolidées dans leur globalité. Il s’agit de l’option par défaut.	Boolean
Conserver la géodatabase mobile (Facultatif)	Indique si les données de géodatabase mobile sont conservées dans la sortie ou si elles sont écrites au format de géodatabase fichier. Si les données en entrée sont un jeu de données réseau d’une géodatabase mobile, la sortie est une géodatabase mobile. Activé—Les données de géodatabase mobile sont conservées en tant que données de géodatabase mobile dans la sortie. La géodatabase est incluse dans son intégralité. Décoché—Les données de géodatabase mobile sont converties en géodatabase fichier. Il s’agit de l’option par défaut.	Boolean

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}, {preserve_sqlite})

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 et toutes les données seront consolidés, convertis ou copiés dans le paquetage (pour un partage en dehors de l’organisation) ou référencés tels quels sans les convertir ou les inclure dans le paquetage (pour un partage au sein de l’organisation). `EXTERNAL`—Les données stockées sur des ressources de réseau seront consolidées, converties ou copiées dans le paquetage. Les formats de données seront conservés lorsque cela est possible. `INTERNAL`—Les données stockées sur des ressources de réseau, telles que les géodatabases d’entreprise, les services d’entités et les partages de fichiers (chemin UNC) seront référencées telles quelles sans les convertir ou les inclure dans le paquetage. Il s’agit de l’option par défaut.	Boolean
package_as_template (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 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. En savoir plus sur la création d’un modèle de projet `PROJECT_TEMPLATE`—Un modèle de projet sera créé. `PROJECT_PACKAGE`—Un paquetage de projet sera créé. Il s’agit de l’option par défaut.	Boolean
extent (Facultatif)	Spécifie l’étendue utilisée pour sélectionner ou découper les entités. `MAXOF` : l’étendue maximale de toutes les entrées est utilisée. `MINOF` : l’étendue minimale commune à toutes les entrées est utilisée. `DISPLAY` : l’étendue est égale à l’affichage visible. Nom de la couche : l’étendue de la couche spécifiée est utilisée. `Extent` object : l’étendue de l’objet spécifié est utilisée. Chaîne délimitée par des espaces de coordonnées géographiques : l’étendue de la chaîne spécifiée est utilisée. Les coordonnées sont exprimées dans l’ordre x-min, y-min, x-max, y-max.	Extent
apply_extent_to_arcsde (Facultatif)	Indique si l’étendue spécifiée est appliquée à toutes les couches ou aux couches de géodatabases d’entreprise. `ENTERPRISE_ONLY`—L’étendue spécifiée est appliquée uniquement aux couches de géodatabases d’entreprise. `ALL`—L’étendue spécifiée est appliquée à toutes les couches. Il s’agit de l’option par défaut.	Boolean
additional_files [additional_files,...] (Facultatif)	Fichiers supplémentaires qui seront inclus dans le paquetage.	File
summary (Facultatif)	Les informations sur le récapitulatif qui seront ajoutées aux propriétés du paquetage.	String
tags (Facultatif)	Les balises qui seront ajoutées aux propriétés du paquetage. Séparez plusieurs balises en les séparant par une virgule ou un point-virgule.	String
version [version,...] (Facultatif)	Indique la version ArcGIS Pro avec laquelle certains objets tels que des projets, cartes et couches seront compatibles et dans laquelle ils seront conservés. L’enregistrement dans une version antérieure peut être utile si le projet est utilisé avec un logiciel plus ancien. Attention : Un paquetage enregistré sous une version antérieure peut perdre les fonctions ou propriétés qui ne sont pas prises en charge dans la version antérieure. `ALL`—Le contenu du paquetage est compatible avec toutes les versions (ArcGIS Pro 2.1 et versions ultérieures). `CURRENT`—Le contenu du paquetage est compatible avec la version ArcGIS Pro actuelle. `2.2`—Le contenu du paquetage est compatible avec la version ArcGIS Pro 2.2. `2.3`—Le contenu du paquetage est compatible avec la version ArcGIS Pro 2.3. `2.4`—Le contenu du paquetage est compatible avec la version ArcGIS Pro 2.4. `2.5`—Le contenu du paquetage est compatible avec la version ArcGIS Pro 2.5. `2.6`—Le contenu du paquetage est compatible avec la version ArcGIS Pro 2.6. `2.7`—Le contenu du paquetage est compatible avec la version ArcGIS Pro 2.7. `2.8`—Le contenu du paquetage est compatible avec la version ArcGIS Pro 2.8. `2.9`—Le contenu du paquetage est compatible avec la version ArcGIS Pro 2.9. `3.0`—Le contenu du paquetage est compatible avec la version ArcGIS Pro 3.0. `3.1`—Le contenu du paquetage est compatible avec la version ArcGIS Pro 3.1. `3.2`—Le contenu du paquetage est compatible avec la version ArcGIS Pro 3.2. `3.3`—Le contenu du paquetage est compatible avec la version ArcGIS Pro 3.3. `3.4`—Le contenu du paquetage est compatible avec la version ArcGIS Pro 3.4. `3.5`—Le contenu du paquetage est compatible avec la version ArcGIS Pro 3.5. `3.6`—Le contenu du paquetage est compatible avec la version ArcGIS Pro 3.6. `3.7`—Le contenu du paquetage est compatible avec la version ArcGIS Pro 3.7.	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 dans le paquetage en sortie quel que soit ce paramètre. `TOOLBOXES`—Les boîtes à outils du projet seront incluses dans le paquetage en sortie. Il s’agit de l’option par défaut. `NO_TOOLBOXES`—Les boîtes à outils du projet ne seront pas incluses dans le paquetage en sortie.	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 d’historique inclus consolideront les données requises pour le retraitement de l’élément d’historique. `HISTORY_ITEMS`—Les éléments de l’historique seront inclus dans le paquetage en sortie. Il s’agit de l’option par défaut. `NO_HISTORY_ITEMS`—Les éléments d’historique ne seront pas inclus dans le paquetage en sortie. `VALID_HISTORY_ITEMS_ONLY`—Seuls les éléments de l’historique valides seront inclus dans le paquetage en sortie. Les éléments de l’historique ne sont pas valides si l’une des couches en entrée d’origine ou l’un des outils est introuvable.	String
read_only (Facultatif)	Indique si le projet sera en lecture seule. Les projets en lecture seule ne peuvent être ni modifiés, ni enregistrés. `READ_ONLY`—Le projet sera en lecture seule. `READ_WRITE`—Le projet sera accessible en écriture. Il s’agit de l’option par défaut.	Boolean
select_related_rows (Facultatif)	Détermine si l’étendue définie est appliquée aux sources de données associées. `KEEP_ONLY_RELATED_ROWS`—Seules les données associées correspondant aux enregistrements situés dans l’étendue définie sont consolidées. `KEEP_ALL_RELATED_ROWS`—Les sources de données associées sont consolidées dans leur globalité. Il s’agit de l’option par défaut.	Boolean
preserve_sqlite (Facultatif)	Indique si les données de géodatabase mobile sont conservées dans la sortie ou si elles sont écrites au format de géodatabase fichier. Si les données en entrée sont un jeu de données réseau d’une géodatabase mobile, la sortie est une géodatabase mobile. `PRESERVE_SQLITE`—Les données de géodatabase mobile sont conservées en tant que données de géodatabase mobile dans la sortie. La géodatabase est incluse dans son intégralité. `CONVERT_SQLITE`—Les données de géodatabase mobile sont converties en géodatabase fichier. Il s’agit de l’option par défaut.	Boolean

Exemple de code

Exemple 1 d’utilisation de l’outil PackageProject (fenêtre Python)

Le script Python ci-dessous illustre l’utilisation de la fonction PackageProject dans la fenêtre Python.

import arcpy
p = arcpy.mp.ArcGISProject("CURRENT")
arcpy.management.PackageProject(p.filePath, f'E:\gisShare\projects\Pipelines\SE_Pipeline.ppkx', 'INTERNAL')

Exemple 2 d’utilisation de la fonction PackageProject (script autonome)

Le script Python suivant transforme tous les projets d’un répertoire dont le nom de fichier contient le motoil en paquetage de projet (.ppkx).

import os
import arcpy

enterpriseProjectDir = r"\\centralFileServer\gisData\ArcGISProProjects"
sharedProjectDir = r"c:\publicFiles\sharedProjects"

walk = arcpy.da.Walk(enterpriseProjectDir, datatype="Project")

for dirpath, dirnames, filenames in walk:
    for filename in filenames:
        if "oil" in filename.lower():
            project = os.path.join(dirpath, filename)
            out_ppkx = os.path.join(sharedProjectDir, os.path.splitext(os.path.basename(project))[0] + ".ppkx")
            print(f"Packaging: {project} to {out_ppkx}")
            arcpy.management.PackageProject(project, out_ppkx, "EXTERNAL")

Environnements

Espace de travail courant, Facteur de traitement parallèle

Cas particuliers

Facteur de traitement parallèle: If the environment is not specified, the tool will use one half of the available cores.

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui