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.

    Pour en savoir plus sur les modèles 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 seront consolidés dans un seul dossier (pour un partage en dehors de votre organisation) ou référencés (pour un partage au sein de votre 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.

  • Default (Par défaut) : l’étendue repose sur l’étendue maximale de toutes les entrées participantes. Il s’agit de l’option par défaut.
  • Union of Inputs (Union des entrées) : l’étendue est basée sur l’étendue maximale de toutes les entrées.
  • Intersection of inputs (Intersection des entrées) : l’étendue est basée sur la surface minimale commune à toutes les entrées.
  • Current Display Extent (Étendue d’affichage actuelle) : l’étendue correspond à l’affichage visible. Cette option n’est pas disponible lorsque aucune carte n’est active.
  • As Specified Below (Comme spécifié ci-dessous) : l’étendue est basée sur les valeurs d’étendue minimale et maximale indiquées.
  • Browse (Parcourir) : l’étendue repose sur un jeu de données existant.
Extent
Appliquer l'étendue aux couches de géodatabases d'entreprise uniquement
(Facultatif)

Indique si le paramètre Extent (Étendue) est appliqué à toutes les couches ou uniquement 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
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 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.
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 de 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 le paramètre extent est appliqué à toutes les couches ou uniquement aux couches de géodatabases 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.

Pour en savoir plus sur les modèles 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 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.
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 dans 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.