Empaqueter une couche (Gestion des données)

Résumé

Permet d'empaqueter une ou plusieurs couches, ainsi que toutes les sources de données référencées, afin de créer un fichier .lpkx compressé.

Utilisation

  • Un avertissement est émis lorsque cet outil détecte un type de couche non pris en charge. La couche non prise en charge ne sera pas écrite dans la sortie.

  • Toutes les couches en entrée doivent présenter une description pour que l'exécution de l'outil aboutisse. Pour ajouter une description, cliquez avec le bouton droit sur la couche, cliquez sur Propriétés et entrez une description.

  • Remarque :
    Les paquetages de couches créés dans ArcGIS Prone sont pas rétrocompatibles avec ArcGIS 10 et ArcGIS 9.3.1. Les paquetages créés dans ArcGIS Pro peuvent uniquement être utilisés dans ArcGIS Pro.
  • Lorsque la case Convertir les données en géodatabase fichier est cochée (convert_data = 'CONVERT' dans Python), voici ce qui se passe :

    • Chaque source de données unique correspond à une géodatabase fichier créée dans le dossier ou paquetage consolidé.
    • Les formats raster et vectoriel compressés sont convertis en une géodatabase fichier et la compression est perdue.
    • Les données des géodatabases d'entreprise ne sont pas consolidées. Pour convertir les données de géodatabases d'entreprise en une géodatabase fichier, sélectionnez Include Enterprise geodatabase data instead of referencing the data (Inclure les données de géodatabase d'entreprise plutôt que de référencer les données).

  • Lorsque la case Convertir les données en géodatabase fichier n'est pas cochée (convert_data = 'PRESERVE' dans Python), voici ce qui se passe :

    • Le format source des données des couches en entrée est préservé lorsque cela est possible.
    • Les formats raster ADRG, CADRG/ECRG, CIB et RPF sont toujours convertis en rasters de géodatabase fichier. ArcGIS ne peut pas écrire ces formats de manière native. Ils sont toujours convertis en rasters de géodatabase fichier pour des raisons d'efficacité.
    • Dans la structure de dossier en sortie, les géodatabases fichier sont consolidées dans un dossier propre à chaque version, et tous les autres formats sont consolidés dans le dossier commonData.
    • Les formats vectoriels et raster compressés ne sont pas découpés, même si une étendue est spécifiée dans le paramètre Extent (Étendue).

  • Pour les couches qui contiennent une jointure ou qui font partie d’une classe de relations, toutes les sources de données jointes ou associées sont consolidées dans le dossier en sortie. Par défaut, les sources de données jointes ou associées seront consolidées dans leur intégralité ou, en fonction du paramètre Select Related Rows (Sélectionner les lignes associées), selon l’étendue spécifiée à l’aide du paramètre Extent (Étendue).

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

  • Certains jeux de données font référence à d'autres jeux de données. Par exemple, vous pouvez avoir un jeu de données de topologie qui référence quatre classes d'entités. Les réseaux géométriques, les réseaux et les localisateurs sont d'autres exemples de jeux de données référençant d'autres jeux de données. Lorsque vous consolidez ou empaquetez une couche en fonction de ces types de jeux de données, les jeux de données participants sont consolidés ou empaquetés.

  • S'il est activé, le paramètre Schema only (Structure uniquement) (schema_only = 'SCHEMA_ONLY' dans Python) permet uniquement de consolider ou d'empaqueter la structure des sources de données en entrée. Une structure correspond à la structure ou à la conception d'une classe d'entités ou d'une table qui consiste en des définitions de champ et de table, des propriétés de système de coordonnées, une symbologie, des ensembles de définition, etc. Les données ou enregistrements ne sont ni consolidés, ni empaquetés.

  • Les sources de données qui ne prennent pas en charge la structure seule ne sont ni consolidées, ni empaquetées. Si le paramètre Schema only (Structure uniquement) est sélectionné et que l'outil détecte une couche qui n'est pas prise en charge pour la structure uniquement, un message d'avertissement apparaît et cette couche est ignorée. Si la structure seule n'est pas prise en charge pour l'unique couche spécifiée, l'outil échouera.

  • Pour décompresser un paquetage de couche (.lpkx), accédez au dossier le contenant dans la fenêtre Catalogue, cliquez avec le bouton droit et choisissez Ajouter à la carte actuelle. Vous pouvez également utiliser l’outil Extraire le paquetage et spécifier un dossier en sortie.

    Par défaut, l'option Ajouter à la carte actuelle extrait toujours le paquetage dans votre profil utilisateur sous : C:\Users\<username>\Documents\ArcGIS\Packages.

Syntaxe

arcpy.management.PackageLayer(in_layer, output_file, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {schema_only}, {version}, {additional_files}, {summary}, {tags}, {select_related_rows})
ParamètreExplicationType de données
in_layer
[in_layer,...]

Couches à empaqueter.

Layer
output_file

Nom et emplacement du fichier de paquetage en sortie (.lpkx) à créer.

File
convert_data
(Facultatif)

Spécifie si les couches en entrée seront converties en une géodatabase fichier ou si leur format original sera conservé.

  • CONVERT Les données sont converties en une géodatabase fichier. Cette option ne s'applique pas aux sources de données de géodatabases d'entreprise. Pour convertir les données des géodatabases d'entreprise, définissez convert_arcsde_data = 'CONVERT_ARCSDE'.
  • PRESERVELes formats de données sont conservés lorsque cela est possible. Il s’agit de l’option par défaut.
Boolean
convert_arcsde_data
(Facultatif)

Spécifie si les couches de géodatabases d'entreprise en entrée seront converties en une géodatabase fichier ou si leur format original sera conservé.

  • CONVERT_ARCSDE Les données de géodatabases d'entreprise seront converties en une géodatabase fichier et incluses dans le dossier ou paquetage consolidé. Il s’agit de l’option par défaut.
  • PRESERVE_ARCSDE Les données de géodatabases d'entreprise sont conservées et référencées dans le dossier ou paquetage consolidé obtenu.
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_arcsde
(Facultatif)

Spécifie si l’étendue indiquée est appliquée à toutes les couches ou uniquement aux couches de géodatabases d’entreprise.

  • ALL L’étendue spécifiée est appliquée à toutes les couches. Il s’agit de l’option par défaut.
  • ARCSDE_ONLYL’étendue spécifiée est appliquée uniquement aux couches de géodatabases d’entreprise.
Boolean
schema_only
(Facultatif)

Spécifie si seule la structure des couches en entrée est consolidée ou empaquetée.

  • ALL Toutes les entités et tous les enregistrements sont consolidés ou empaquetés. Il s’agit de l’option par défaut.
  • SCHEMA_ONLY Seule la structure des couches en entrée est consolidée ou empaquetée.
Boolean
version
[version,...]
(Facultatif)

Spécifie la version des géodatabases qui vont être créées dans le paquetage obtenu. Lorsqu'une version est indiquée, les paquetages peuvent être partagés avec les versions précédentes d'ArcGIS et la compatibilité avec les versions ultérieures est assurée.

Remarque :

Un paquetage enregistré sous une version précédente peut perdre les propriétés disponibles uniquement dans une version plus récente.

  • ALL Le paquetage contient une géodatabase et un fichier de couche compatibles avec toutes les versions (ArcGIS Pro 1.2 et versions ultérieures).
  • CURRENT Le paquetage contient une géodatabase et un fichier de couche compatibles avec la version actuelle.
  • 2.xLe paquetage contient une géodatabase et un fichier de couche compatibles avec la version 2.0 et les versions ultérieures.
  • 1.2Le paquetage contient une géodatabase et un fichier de couche compatibles avec la version 1.2 et les versions ultérieures.
String
additional_files
[additional_files,...]
(Facultatif)

Ajoute des fichiers à un 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)

Ajoute un récapitulatif des propriétés du paquetage.

String
tags
(Facultatif)

Ajoute des informations sur les balises aux propriétés du paquetage. Vous pouvez ajouter plusieurs balises ou les séparer par une virgule ou un point-virgule.

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 PackageLayer (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil PackageLayer dans la fenêtre Python.

# This code assumes the current project has a map open with a layer named "Streets"
import arcpy
outputFile = "c:/packages/streetsLayer.lpkx"
arcpy.PackageLayer_management("Streets", outputFile, "PRESERVE", 
                              "CONVERT_ARCSDE", "#", "ALL", "ALL", "CURRENT", 
                              "C:/readme.docx", "Summary of package", 
                              "parcel,montgomery")
2e exemple d'utilisation de l'outil PackageLayer (script autonome)

Permet d'empaqueter toutes les couches d'entités de la première carte d'un projet donné dans leurs fichiers de paquetages de couches individuels.

# import system modules
import os
import arcpy
prj = arcpy.mp.ArcGISProject(r"\\fileServe\projects\Timbuktu\Timbuktu.aprx")
maps = prj.listMaps()[0]
lyrs = maps.listLayers()
for lyr in lyrs:
    if lyr.isFeatureLayer:
        arcpy.PackageLayer_management(lyr, os.path.join("c:/temp", lyr.name + ".lpkx"))

Informations de licence

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

Rubriques connexes