Enregistrer dans un fichier de couche (Gestion des données)

Synthèse

Crée un fichier de couche en sortie (.lyrx) à partir d’une couche de carte. Le fichier de couche stocke de nombreuses propriétés de la couche en entrée, telles que la symbologie, l'étiquetage et les fenêtres contextuelles personnalisées.

Utilisation

Paramètres

ÉtiquetteExplicationType de données
Couche en entrée

Couche de carte qui sera enregistrée sur le disque en tant que fichier de couche.

Layer; Table View
Couche en sortie

Fichier de couche en sortie (.lyrx) qui sera créé.

Layer File
Chemin relatif de stockage
(Facultatif)

Spécifie si le fichier de couche en sortie stockera un chemin relatif vers les données source stockées sur le disque ou un chemin absolu.

  • Désactivé – Le fichier de couche en sortie stockera un chemin d'accès absolu vers les données source stockées sur le disque. Il s’agit de l’option par défaut.
  • Activé – Le fichier de couche en sortie stockera un chemin relatif vers les données source stockées sur le disque. Si le fichier de couche en sortie est déplacé, son chemin source sera mis à jour avec le nouvel emplacement des données source.
Boolean
Version de couche
(Facultatif)

Spécifie la version du fichier de couche en sortie.

  • ActuelVersion actuelle. Il s’agit de l’option par défaut.
Héritage :

Ce paramètre n’est plus pris en charge. Il est conservé uniquement pour la compatibilité descendante des scripts et des modèles.

Les fichiers de couche créés dans une version particulière sont pris en charge dans toutes les versions mineures de la même série. Par exemple, un fichier de couche enregistré dans ArcGIS AllSource 3.1 peut être utilisé dans toutes les versions de 3.x de ArcGIS AllSource.

Pour enregistrer une couche et ses propriétés dans une version majeure différente de ArcGIS AllSource, utilisez l’outil Empaqueter une couche.

String

arcpy.management.SaveToLayerFile(in_layer, out_layer, {is_relative_path}, {version})
NomExplicationType de données
in_layer

Couche de carte qui sera enregistrée sur le disque en tant que fichier de couche.

Layer; Table View
out_layer

Fichier de couche en sortie (.lyrx) qui sera créé.

Layer File
is_relative_path
(Facultatif)

Spécifie si le fichier de couche en sortie stockera un chemin relatif vers les données source stockées sur le disque ou un chemin absolu.

  • ABSOLUTELe fichier de couche en sortie stockera un chemin d'accès absolu vers les données source stockées sur le disque. Il s’agit de l’option par défaut.
  • RELATIVELe fichier de couche en sortie stockera un chemin relatif vers les données source stockées sur le disque. Si le fichier de couche en sortie est déplacé, son chemin source sera mis à jour avec le nouvel emplacement des données source.
Boolean
version
(Facultatif)

Spécifie la version du fichier de couche en sortie.

Héritage :

Ce paramètre n’est plus pris en charge. Il est conservé uniquement pour la compatibilité descendante des scripts et des modèles.

Les fichiers de couche créés dans une version particulière sont pris en charge dans toutes les versions mineures de la même série. Par exemple, un fichier de couche enregistré dans ArcGIS AllSource 3.1 peut être utilisé dans toutes les versions de 3.x de ArcGIS AllSource.

Pour enregistrer une couche et ses propriétés dans une version majeure différente de ArcGIS AllSource, utilisez l’outil Empaqueter une couche.

  • CURRENTVersion actuelle. Il s’agit de l’option par défaut.
String

Exemple de code

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

Le script ci-dessous pour la fenêtre Python montre comment utiliser la fonction SaveToLayerFile en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.SaveToLayerFile("studyquads.shp", "C:/output/studyquadsLyr.lyrx", "ABSOLUTE")
Exemple 2 d'utilisation de l'outil SaveToLayerFile (script Python autonome)

Le script Python ci-dessous illustre l’utilisation de la fonction SaveToLayerFile dans un script autonome.

# Description: Save a layer to a file on disk

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/data"

# Set local variables
in_features = "study_quads.shp"
where_clause = '"NAME" = \'LA MESA\''
in_layer = "studyquadsLyr"
out_layer_file = "studyquadsLyr.lyrx"

# Run MakeFeatureLayer
arcpy.management.MakeFeatureLayer(in_features, "study_quads_lyr", where_clause)

# Run SaveToLayerFile
arcpy.management.SaveToLayerFile("study_quads_lyr", out_layer_file, "ABSOLUTE")