Empaqueter un projet (Gestion des données)

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 projet sont, par défaut, créés pour un usage interne. Le paramètre 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 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. 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 l’outil Analyser les outils pour Pro afin d’analyser les boîtes à outils faisant partie d’un projet avant l’exécution du processus de 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).

  • À 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 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ê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).

  • Les connexions, 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 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, utilisez le paramètre Étendue afin de sélectionner les entités à consolider. Pour les couches raster, utilisez le paramètre Étendue pour 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 Fichiers supplémentaires.

  • Attention :

    Les paquetages de projet (fichiers .ppkx) peuvent uniquement être créés et ouverts avec ArcGIS AllSource.

Paramètres

ÉtiquetteExplicationType 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\, quelle que soit la valeur du paramètre.

  • Désactivé : les sources de données d’entreprise, telles que les géodatabases d’entreprise et les données issues d’un chemin UNC, ne sont pas copiées dans le dossier local. Il s’agit de l’option par défaut.
  • Activé : les formats de données sont copiés et conservés lorsque cela est possible.
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.

  • Désactivé : un paquetage de projet sera créé. Il s’agit de l’option par défaut.
  • Activé : un modèle de projet sera créé.

Boolean
Étendue
(Facultatif)

Spécifie l'étendue utilisée pour sélectionner ou découper les entités.

  • Current Display Extent (Étendue actuellement affichée) Vue cartographique : l’étendue repose sur la carte ou la scène active. Cette option est uniquement disponible lorsqu’une carte est active.
  • Extent of a Layer (Étendue d’une couche) Layer : l’étendue repose sur une couche de carte active. Utilisez la liste déroulante pour choisir une couche disponible ou utilisez l’option Extent of data in all layers (Étendue des données dans toutes les couches) pour obtenir l’étendue combinée de toutes les couches de carte actives, y compris le fond de carte. Cette option est uniquement disponible lorsqu’une carte avec des couches est active.
  • Browse (Parcourir) Parcourir : l’étendue repose sur un jeu de données existant.
  • Intersection of Inputs (Intersection des entrées) Intersecter : l’étendue repose sur l’étendue minimale ou l’étendue d’intersection de toutes les entrées. S’il n’existe aucune intersection entre les entrées, il en résulte une étendue nulle avec uniquement des zéros.
  • Union of Inputs (Union des entrées) Agréger : l’étendue est basée sur l’étendue maximale ou combinée de toutes les entrées.
  • Reset Extent (Réinitialiser l’étendue) Réinitialiser : la valeur par défaut de l’étendue est rétablie.
  • Manually entered coordinates (Coordonnées saisies manuellement) : les coordonnées 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

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.

  • Désactivé : l’étendue est appliquée à toutes les couches. Il s’agit de l’option par défaut.
  • Activé : l’étendue est appliquée uniquement aux couches de géodatabases d’entreprise.

Boolean
Fichiers supplémentaires
(Facultatif)

Fichiers supplémentaires allant être ajoutés au 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)

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)

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 qui sont disponibles uniquement dans la version ultérieure.

  • Toutes les versionsLe paquetage contient des géodatabases et des cartes compatibles avec toutes les versions (ArcGIS AllSource version 2.1 et versions ultérieures).
  • Version actuelleLe paquetage contient des géodatabases et des cartes compatibles avec la version actuelle.
  • 2.2Le paquetage contient des géodatabases et des cartes compatibles avec la version 2.2.
  • 2.3Le paquetage contient des géodatabases et des cartes compatibles avec la version 2.3.
  • 2.4Le paquetage contient des géodatabases et des cartes compatibles avec la version 2.4.
  • 2.5Le paquetage contient des géodatabases et des cartes compatibles avec la version 2.5.
  • 2.6Le paquetage contient des géodatabases et des cartes compatibles avec la version 2.6.
  • 2.7Le paquetage contient des géodatabases et des cartes compatibles avec la version 2.7.
  • 2.8Le paquetage contient des géodatabases et des cartes compatibles avec la version 2.8.
  • 2.9Le paquetage contient des géodatabases et des cartes compatibles avec la version 2.9.
  • 3.0Le paquetage contient des géodatabases et des cartes compatibles avec la version 3.0.
  • 3.1Le paquetage contient des géodatabases et des cartes compatibles avec la version 3.1.
  • 3.2Le paquetage contient des géodatabases et des cartes compatibles avec la version 3.2.
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 dans 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.

  • Activé : les boîtes à outils du projet seront incluses dans le paquetage en sortie. Il s’agit de l’option par défaut.
  • Désactivé : les boîtes à outils du projet seront exclues du 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 inclusLes é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 inclusLes éléments d’historique ne seront pas inclus dans le paquetage en sortie.
  • Seuls les éléments de l’historique valides seront inclusSeuls 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ésactivé : le projet sera accessible en écriture. Il s’agit de l’option par défaut.
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.

  • Désactivée - Les sources de données associées sont consolidées dans leur globalité. Il s’agit de l’option par défaut.
  • Activée - Seules les données associées correspondant aux enregistrements situés dans l’étendue définie sont consolidées.
Boolean
Conserver la géodatabase mobile
(Facultatif)

Indique si les données de géodatabase mobile en entrée 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.

  • Désactivé : les données de géodatabase mobile sont converties en géodatabase fichier. Il s’agit de l’option par défaut.
  • Activé : les données de géodatabase mobile sont conservées en tant que géodatabase mobile dans la sortie. La géodatabase est incluse dans son intégralité.
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})
NomExplicationType 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.

  • INTERNALLes sources de données d’entreprise, telles que les géodatabases d’entreprise et les données issues d’un chemin UNC, ne sont pas copiées dans le dossier local. Il s’agit de l’option par défaut.
  • EXTERNALLes formats de données sont copiés et conservés lorsque cela est possible.
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_PACKAGEUn paquetage de projet sera créé. Il s’agit de l’option par défaut.
  • PROJECT_TEMPLATEUn modèle de projet sera créé.
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.
  • Objet Extent : 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.

  • ALLL’étendue spécifiée est appliquée à toutes les couches. Il s’agit de l’option par défaut.
  • ENTERPRISE_ONLYL’étendue spécifiée est appliquée uniquement aux couches de géodatabases d’entreprise.
Boolean
additional_files
[additional_files,...]
(Facultatif)

Fichiers supplémentaires allant être ajoutés au 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)

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)

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 qui sont disponibles uniquement dans la version ultérieure.

  • ALLLe paquetage contient des géodatabases et des cartes compatibles avec toutes les versions (ArcGIS AllSource version 2.1 et versions ultérieures).
  • CURRENTLe paquetage contient des géodatabases et des cartes compatibles avec la version actuelle.
  • 2.2Le paquetage contient des géodatabases et des cartes compatibles avec la version 2.2.
  • 2.3Le paquetage contient des géodatabases et des cartes compatibles avec la version 2.3.
  • 2.4Le paquetage contient des géodatabases et des cartes compatibles avec la version 2.4.
  • 2.5Le paquetage contient des géodatabases et des cartes compatibles avec la version 2.5.
  • 2.6Le paquetage contient des géodatabases et des cartes compatibles avec la version 2.6.
  • 2.7Le paquetage contient des géodatabases et des cartes compatibles avec la version 2.7.
  • 2.8Le paquetage contient des géodatabases et des cartes compatibles avec la version 2.8.
  • 2.9Le paquetage contient des géodatabases et des cartes compatibles avec la version 2.9.
  • 3.0Le paquetage contient des géodatabases et des cartes compatibles avec la version 3.0.
  • 3.1Le paquetage contient des géodatabases et des cartes compatibles avec la version 3.1.
  • 3.2Le paquetage contient des géodatabases et des cartes compatibles avec la version 3.2.
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.

  • TOOLBOXESLes boîtes à outils du projet seront incluses dans le paquetage en sortie. Il s’agit de l’option par défaut.
  • NO_TOOLBOXESLes 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_ITEMSLes éléments de l’historique seront inclus dans le paquetage en sortie. Il s’agit de l’option par défaut.
  • NO_HISTORY_ITEMSLes éléments d’historique ne seront pas inclus dans le paquetage en sortie.
  • VALID_HISTORY_ITEMS_ONLYSeuls 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_ONLYLe projet sera en lecture seule.
  • READ_WRITELe 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_ROWSSeules les données associées correspondant aux enregistrements situés dans l’étendue définie sont consolidées.
  • KEEP_ALL_RELATED_ROWSLes 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.

  • CONVERT_SQLITELes données de géodatabase mobile sont converties en géodatabase fichier. Il s’agit de l’option par défaut.
  • PRESERVE_SQLITELes données de géodatabase mobile sont conservées dans la sortie. La géodatabase est incluse dans son intégralité.
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, 'E:\\gisShare\\projects\\Pipelines\\SE_Pipeline.ppkx', 'INTERNAL')
Exemple 2 d’utilisation de l’outil PackageProject (script autonome)

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.lower():
            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.management.PackageProject(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.