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

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

Outre les couches de carte, cet outil accepte également les couches créées par des outils, tels que Générer une couche ou Générer une couche d’événements XY.
Si une sélection est appliquée à la couche en entrée, le fichier de couche en sortie conservera cette sélection.

Paramètres

Étiquette	Explication	Type 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. Actuel—Version 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 Pro 3.1 peut être utilisé dans toutes les versions de 3.x de ArcGIS Pro. Pour enregistrer une couche et ses propriétés dans une version majeure différente de ArcGIS Pro, utilisez l’outil Empaqueter une couche.	String

arcpy.management.SaveToLayerFile(in_layer, out_layer, {is_relative_path}, {version})

Nom	Explication	Type 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. ABSOLUTE—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. RELATIVE—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 (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 Pro 3.1 peut être utilisé dans toutes les versions de 3.x de ArcGIS Pro. Pour enregistrer une couche et ses propriétés dans une version majeure différente de ArcGIS Pro, utilisez l’outil Empaqueter une couche. CURRENT—Version 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")

Environnements

Espace de travail courant, Espace de travail temporaire

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui