Résumé
Consolide un projet (fichier .aprx) et les cartes et données référencées dans un dossier en sortie spécifié.
Utilisation
Tous les éléments d’un projet seront consolidés et inclus dans le fichier .aprx, notamment les cartes, les données référencées par les couches, les boîtes d’outils, les styles, les mises en page et les connexions lorsque cela est approprié.
Le paramètre Share outside of organization (Partager en dehors de l'organisation) détermine si les données seront consolidées dans le dossier.
- Désactivé : des paquetages de votre environnement interne sont créés, ce qui signifie que les données ne sont pas consolidées. Les chemins UNC et les couches, les styles et les connexions de la géodatabase d'entreprise demeurent référencés dans votre projet consolidé. (Dans Python, définissez le paramètre sharing_interal sur INTERNAL.)
- Activé : toutes les sources de données nécessaires au paquetage sont copiées dans le dossier consolidé. (Dans Python, définissez le paramètre sharing_interal sur EXTERNAL.) Les éléments qui ne seraient pas disponibles en dehors de votre réseau, tels que les connexions à la géodatabase d'entreprise et les chemins d'accès aux dossiers UNC, ne sont pas inclus. Toutefois, si des données provenant de ces sources sont incluses dans une carte ou une mise en page à l'intérieur du projet, elles sont copiées dans le dossier en sortie.
Remarque :
Les données et les cartes seront consolidé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 Share outside of organization (Partager en dehors de l’organisation).
Des modèles peuvent être créés à l'aide du paramètre Consolider comme modèle. Un modèle de projet peut vous aider à créer un 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 ArcGIS Pro avant l’exécution des routines 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 nécessaires aux outils sont consolidées, que les données fassent partie ou non d’une carte dans le projet.
Les connexions (dossier, serveur, base de données, workflow et Data Reviewer) 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.
Syntaxe
arcpy.management.ConsolidateProject(in_project, output_folder, {sharing_internal}, {extent}, {apply_extent_to_enterprise_geo}, {package_as_template}, {preserve_sqlite}, {version}, {select_related_rows})
Paramètre | Explication | Type de données |
in_project | Projet (fichier .aprx) à consolider. | File |
output_folder | Dossier en sortie qui contiendra les données et le projet consolidés. Si le dossier spécifié n'existe pas, un nouveau dossier est créé. | Folder |
sharing_internal (Facultatif) | Indique si le projet et toutes les données sont consolidés dans le dossier en sortie afin de pouvoir être partagés en externe.
| Boolean |
extent (Facultatif) | Spécifie l'étendue utilisée pour sélectionner ou découper les entités.
| Extent |
apply_extent_to_enterprise_geo (Facultatif) | Indique si le paramètre extent est appliqué à toutes les couches ou uniquement aux couches de géodatabases d'entreprise.
| Boolean |
package_as_template (Facultatif) | Indique si le projet sera consolidé en tant que modèle ou projet standard. 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 normailser une série de cartes à utiliser dans un projet 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 |
preserve_sqlite (Facultatif) | Spécifie si les géodatabases SQLite seront conservées ou converties en géodatabase fichier. Remarque :Ce paramètre s’applique uniquement aux fichiers .geodatabase, principalement utilisés pour les workflows hors connexion dans les applications ArcGIS Runtime. Les bases de données SQLite avec extension de fichier .sqlite ou .gpkg seront converties en géodatabases fichier.
| Boolean |
version (Facultatif) | Spécifie la version de ArcGIS Pro sous laquelle le projet consolidé est enregistré. L’enregistrement dans une version antérieure garantit la compatibilité avec les versions antérieures de l’outil. Si vous tentez de consolider une boîte d'outils dans une version antérieure et que des fonctions uniquement disponibles dans la version plus récente sont incluses, une erreur est générée. Vous devez supprimer les outils incompatibles avec la version antérieure ou spécifier une version compatible.
| String |
select_related_rows (Facultatif) | Indique si l’étendue spécifiée sera 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 ConsolidateProject dans la fenêtre Python.
import arcpy
arcpy.ConsolidateProject_management('c:\\projects\\SE_Pipelines\\PipeDevelopment.aprx', 'E:\\gisShare\\projects\\Pipelines\\SE_Pipeline', 'INTERNAL')
Le script suivant utilise un répertoire en entrée dans lequel les fichiers de projet (.aprx) se trouvent sur un partage UNC et consolide le projet dans un lecteur local. Les données demeurent accessibles au projet désormais local, car le mot-clé INTERNAL est utilisé.
import os
import arcpy
enterpriseProjectDir = "\\\\centralFileServer\\gisData\\ArcGISProProjects"
localProjectDir = "c:\\GISdata\\localProjects"
walk = arcpy.da.Walk(enterpriseProjectDir, datatype="Project")
for dirpath, dirnames, filenames in walk:
for fname in filenames:
project = os.path.join(dirpath, fame)
outputFolder = os.path.join(localProjectDir, os.path.splitext(os.path.basename(project))[0])
print("Consolidating: {0} to {1}".format(project, outputFolder))
arcpy.ConsolidateProject_management(project, outputFolder, "INTERNAL")
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?