Consolider le projet (Gestion des données)

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.

    Pour en savoir plus sur les modèles de projet

  • 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ètreExplicationType 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.

  • INTERNAL 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.
    Remarque :

    Ce paramètre s'applique aux sources de données de 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.

  • ALL L’é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 sont immédiatement à la disposition des personnes qui veulent les utiliser dans leurs cartes.

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)

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.

  • CONVERT_SQLITELes géodatabases SQLite seront converties en géodatabases fichier. Il s’agit de l’option par défaut.
  • PRESERVE_SQLITELes géodatabases SQLite seront conservées.
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.

  • CURRENT Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version actuelle.
  • 2.1Le dossier consolidé contient des géodatabases et des cartes compatibles avec la version 2.1.
  • 2.2 Le 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.
String
select_related_rows
(Facultatif)

Indique si l’étendue spécifiée sera appliquée aux sources de données associées.

  • KEEP_ONLY_RELATED_ROWSSeules les données associées correspondant à des enregistrements de l’étendue spécifiée seront consolidées.
  • KEEP_ALL_RELATED_ROWSLes sources de données associées seront intégralement consolidées. 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 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')
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.ConsolidateProject_management(project, outputFolder, "INTERNAL")

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes