Guardar en archivo de capa (Administración de datos)

Resumen

Crea un archivo de capa de salida (.lyrx) a partir de una capa del mapa. El archivo de capa almacena muchas propiedades de la capa de entrada, como simbología, etiquetado y mensajes emergentes personalizados.

Uso

  • Además de las capas de mapa, esta herramienta también acepta capas creadas por herramientas como Crear capa de entidades o Crear capa de eventos XY.

  • Si la capa de entrada tiene una selección aplicada, el archivo de capa de salida mantendrá esta selección.

Parámetros

EtiquetaExplicaciónTipo de datos
Capa de entrada

Capa de mapa que se va a guardar en el disco como archivo de capa.

Layer; Table View
Capa de salida

Archivo de capa de salida (.lyrx) que se creará.

Layer File
Almacenar ruta relativa
(Opcional)

Especifica si el archivo de capa de salida almacenará una ruta relativa para los datos de origen almacenados en el disco o una ruta absoluta.

  • Desactivada: el archivo de capa de salida almacenará una ruta absoluta para los datos de origen almacenados en el disco. Esta es la opción predeterminada.
  • Activada: el archivo de capa de salida almacenará una ruta relativa para los datos de origen almacenados en el disco. Si el archivo de capa de salida se mueve, su ruta fuente se actualizará a donde deberían estar los datos fuente en relación con la nueva ruta.
Boolean
Versión de capa
(Opcional)

Especifica la versión del archivo de capa de salida.

  • ActualVersión actual. Esta es la opción predeterminada.
Heredado:

Este parámetro ya no es compatible. Se mantiene exclusivamente para garantizar la compatibilidad con versiones anteriores de scripts y modelos.

Los archivos de capa creados en una versión determinada son compatibles con todas las versiones secundarias de la misma serie. Por ejemplo, un archivo de capa guardado en la versión ArcGIS Pro 3.1 puede utilizarse en todas las versiones 3.x de ArcGIS Pro.

Para guardar una capa y sus propiedades en una versión principal diferente de ArcGIS Pro, utilice la herramienta Empaquetar capa.

String

arcpy.management.SaveToLayerFile(in_layer, out_layer, {is_relative_path}, {version})
NombreExplicaciónTipo de datos
in_layer

Capa de mapa que se va a guardar en el disco como archivo de capa.

Layer; Table View
out_layer

Archivo de capa de salida (.lyrx) que se creará.

Layer File
is_relative_path
(Opcional)

Especifica si el archivo de capa de salida almacenará una ruta relativa para los datos de origen almacenados en el disco o una ruta absoluta.

  • ABSOLUTEEl archivo de capa de salida almacenará una ruta absoluta para los datos de origen almacenados en el disco. Esta es la opción predeterminada.
  • RELATIVEEl archivo de capa de salida almacenará una ruta relativa para los datos de origen almacenados en el disco. Si el archivo de capa de salida se mueve, su ruta fuente se actualizará a donde deberían estar los datos fuente en relación con la nueva ruta.
Boolean
version
(Opcional)

Especifica la versión del archivo de capa de salida.

Heredado:

Este parámetro ya no es compatible. Se mantiene exclusivamente para garantizar la compatibilidad con versiones anteriores de scripts y modelos.

Los archivos de capa creados en una versión determinada son compatibles con todas las versiones secundarias de la misma serie. Por ejemplo, un archivo de capa guardado en la versión ArcGIS Pro 3.1 puede utilizarse en todas las versiones 3.x de ArcGIS Pro.

Para guardar una capa y sus propiedades en una versión principal diferente de ArcGIS Pro, utilice la herramienta Empaquetar capa.

  • CURRENTVersión actual. Esta es la opción predeterminada.
String

Muestra de código

Ejemplo 1 de SaveToLayerFile (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función SaveToLayerFile de modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.SaveToLayerFile("studyquads.shp", "C:/output/studyquadsLyr.lyrx", "ABSOLUTE")
Ejemplo 2 de SaveToLayerFile (script de Python independiente)

La siguiente secuencia de comandos Pythonindependiente muestra cómo utilizar la función SaveToLayerFile en una secuencia de comandos independiente.

# 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")

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados