Consolider un projet (Gestion des données)

Synthèse

Consolide un projet (fichier .aprx) ainsi que les cartes et données référencées dans un dossier en sortie spécifié.

Utilisation

  • Tous les éléments d’un projet sont 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 Partager en dehors de l’organisation détermine si les données sont consolidées dans le dossier.

    • Désactivé : des paquetages sont créés pour votre environnement interne, 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 le projet consolidé.
    • Activé : toutes les sources de données nécessaires au paquetage sont copiées dans le dossier consolidé. 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 Partager en dehors de l’organisation.

  • Des modèles peuvent être créés à l'aide du paramètre Consolider comme modèle. Lorsque vous créez un projet, vous pouvez utiliser un modèle de projet pour définir 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 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 requises par les outils sont consolidées, qu'elles 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, utilisez le paramètre Étendue pour sélectionner les entités à consolider. Pour les couches raster, utilisez le paramètre Étendue pour découper les jeux de données raster.

Paramètres

ÉtiquetteExplicationType de données
Projet en entrée

Projet (fichier .aprx) à consolider.

File
Dossier en sortie

Dossier en sortie qui contiendra les données et le projet consolidés. Si le dossier spécifié n’existe pas, un dossier est créé.

Folder
Partager en dehors de l’organisation
(Facultatif)

Indique si le projet et toutes les données sont consolidés dans un seul dossier (pour un partage en dehors de l’organisation) ou référencés (pour un partage au sein de l’organisation). Les chemins d'accès aux données qui sont référencés depuis des géodatabases d'entreprise ou un système de fichiers UNC peuvent être partagés en interne. Si le projet n’a pas été conçu avec des chemins d’accès aux données de ce type, les données sont consolidées dans le paquetage de projet.

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 et le projet ne sont pas consolidés dans le dossier en sortie. Il s’agit de l’option par défaut. Ce paramètre s’applique aux sources de données de type géodatabase d’entreprise, notamment les géodatabases d’entreprise et les dossiers référencés via un chemin UNC.
  • Activé : les sources de données et le projet sont copiés et conservés lorsque cela est possible.
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 la valeur du paramètre Étendue est appliquée à toutes les couches ou uniquement aux couches de géodatabase 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
Consolider comme modèle
(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 peuvent être immédiatement utilisées.

  • Désactivé : le projet sera consolidé en tant que projet dans un dossier. Il s’agit de l’option par défaut.
  • Activé : le projet sera consolidé en tant que modèle dans un dossier.

Boolean
Conserver la géodatabase mobile
(Facultatif)

Indique si les géodatabases mobiles sont conservées ou converties en géodatabases fichier.

Remarque :

Ce paramètre s’applique uniquement aux géodatabases mobiles (.geodatabase), principalement utilisées pour les processus hors connexion dans les applications ArcGIS Runtime. Les bases de données SQLite avec extension de fichier .sqlite ou .gpkg sont converties en géodatabases fichier.

  • Désactivé : les géodatabases mobiles sont converties en géodatabases fichier. Il s’agit de l’option par défaut.
  • Activé : les géodatabases mobiles sont conservées.

Boolean
Version
(Facultatif)

Spécifie la version de ArcGIS AllSource 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.

  • Version actuelleLe dossier consolidé contient des géodatabases et des cartes compatibles avec la version actuelle.
  • 2.2Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 2.2.
  • 2.3Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 2.3.
  • 2.4Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 2.4.
  • 2.5Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 2.5.
  • 2.6Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 2.6.
  • 2.7Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 2.7.
  • 2.8Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 2.8.
  • 2.9Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 2.9.
  • 3.0Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 3.0.
  • 3.1Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 3.1.
  • 3.2Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 3.2.
String
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

arcpy.management.ConsolidateProject(in_project, output_folder, {sharing_internal}, {extent}, {apply_extent_to_enterprise_geo}, {package_as_template}, {preserve_sqlite}, {version}, {select_related_rows})
NomExplicationType 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 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.

  • INTERNALLes sources de données et le projet ne sont pas consolidés dans le dossier en sortie. Il s’agit de l’option par défaut.
    Remarque :

    Ce paramètre s’applique aux sources de données de type géodatabase d’entreprise, notamment les géodatabases d’entreprise et les dossiers référencés via un chemin UNC.

  • EXTERNALLes sources de données et le projet sont consolidés (copiés) dans le dossier en sortie lorsque cela est possible.
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_enterprise_geo
(Facultatif)

Indique si la valeur du paramètre extent est appliquée à toutes les couches ou uniquement aux couches de géodatabase d’entreprise.

  • ALLL’étendue est appliquée à toutes les couches. Il s’agit de l’option par défaut.
  • ENTERPRISE_ONLYL’étendue est appliquée 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 peuvent être immédiatement utilisées.

En savoir plus sur la création d’un modèle de projet

  • PROJECT_PACKAGELe projet sera consolidé en tant que projet dans un dossier. Il s’agit de l’option par défaut.
  • PROJECT_TEMPLATELe projet sera consolidé en tant que modèle dans un dossier.
Boolean
preserve_sqlite
(Facultatif)

Indique si les géodatabases mobiles sont conservées ou converties en géodatabases fichier.

Remarque :

Ce paramètre s’applique uniquement aux géodatabases mobiles (.geodatabase), principalement utilisées pour les processus hors connexion dans les applications ArcGIS Runtime. Les bases de données SQLite avec extension de fichier .sqlite ou .gpkg sont converties en géodatabases fichier.

  • CONVERT_SQLITELes géodatabases mobiles sont converties en géodatabases fichier. Il s’agit de l’option par défaut.
  • PRESERVE_SQLITELes géodatabases mobiles sont conservées.
Boolean
version
(Facultatif)

Spécifie la version de ArcGIS AllSource 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.

  • CURRENTLe dossier consolidé contient des géodatabases et des cartes compatibles avec la version actuelle.
  • 2.2Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 2.2.
  • 2.3Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 2.3.
  • 2.4Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 2.4.
  • 2.5Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 2.5.
  • 2.6Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 2.6.
  • 2.7Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 2.7.
  • 2.8Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 2.8.
  • 2.9Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 2.9.
  • 3.0Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 3.0.
  • 3.1Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 3.1.
  • 3.2Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 3.2.
String
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

Exemple de code

Exemple 1 d'utilisation de l'outil ConsolidateProject (fenêtre Python)

Le script Python ci-dessous illustre l’utilisation de la fonction ConsolidateProject à partir de la fenêtre Python.

import arcpy
arcpy.management.ConsolidateProject('c:\\projects\\SE_Pipelines\\PipeDevelopment.aprx', 
                                    'E:\\gisShare\\projects\\Pipelines\\SE_Pipeline',
                                    'INTERNAL')
Exemple 2 d'utilisation de l'outil ConsolidateProject (script autonome)

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.management.ConsolidateProject(project, outputFolder, "INTERNAL")

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.