Exportar entidades (Conversión)

Resumen

Convierte una clase de entidad o capa de entidades en una clase de entidad nueva.

Uso

  • Use el parámetro Mapa de campo para gestionar los campos y su contenido en el dataset de salida.

    • Añada y elimine campos de la lista de campos, reordene la lista de campos y cambie el nombre de los campos.
    • El tipo de datos predeterminado de un campo de salida coincide con el tipo de datos del primer campo de entrada (de ese nombre) que encuentre. Puede cambiar el tipo de datos a otro tipo de datos válido.
    • Use una acción para determinar cómo los valores de uno o varios campos de entrada se mezclarán en un solo campo de salida. Las acciones disponibles son Primera, Última, Concatenación, Suma, Valor medio, Mediana, Modo, Mínimo, Máximo, Desviación estándar y Recuento.
    • Al usar la acción Concatenar, pude especificar un delimitador tal como una coma u otro carácter. Haga clic en el inicio del cuadro de texto Delimitador para añadir los caracteres delimitadores.
    • Desviación estándar no es una opción válida para los valores de entrada únicos.
    • Use el botón Trocear texto en los campos de origen de texto para seleccionar qué caracteres de un valor de entrada se extraerán al campo de salida. Para acceder al botón Trocear texto, pase el cursor del ratón por encima de un campo de texto de la lista de campos de entrada; a continuación, especifique las posiciones de los caracteres de inicio y fin.
    • Los campos también se pueden asignar mediante scripts de Python.

  • Se puede emplear una expresión SQL para seleccionar un subconjunto de entidades. Para obtener más información sobre la sintaxis del parámetro Expresión, consulte Referencia de SQL para las expresiones de consulta utilizadas en ArcGIS.

  • Las filas se pueden reordenar en orden ascendente o descendente especificando el valor del parámetro Campo de ordenación. Si se especifica más de un campo, las filas se ordenarán por el primer campo y, dentro de ese orden, por el segundo campo y así sucesivamente.

  • Al convertir los datos de la geodatabase que tiene subtipos o dominios y el espacio de trabajo de salida no es una geodatabase, tanto el subtipo como las descripciones y los códigos de dominio pueden ser incluidos en la salida. Utilice el entorno Transferir descripciones de dominio de campo para controlar este comportamiento. De forma predeterminada, solo los códigos de dominio y de subtipo se incluirán en la salida, no las descripciones.

    Nota:

    La conversión a shapefile con descripciones de dominio y subtipo puede tomar más tiempo (un rendimiento más lento) que sin descripciones. Si no se requieren descripciones de subtipo ni dominio en la salida, deje desactivado el entorno Transferir descripciones de dominio de campo para obtener el mejor rendimiento.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Las entidades de entrada que se exportarán a una nueva clase de entidad.

Feature Layer
Clase de entidad de salida

La clase de entidad de salida que contiene las entidades exportadas.

Feature Class
Expresión
(Opcional)

Una expresión SQL utilizada para seleccionar un subconjunto de entidades.

SQL Expression
Utilizar alias de campo como nombre
(Opcional)

Especifica si los nombres de campo o alias de campo de entrada se utilizarán como el nombre de campo de salida.

  • Desactivado: se utilizarán los nombres de campo de la entrada como nombres de campo de salida. Esta es la opción predeterminada.
  • Activado: se utilizarán los alias de campo de entrada como nombres de campo de salida.
Boolean
Mapa de campo
(Opcional)

Los campos que se transferirán al dataset de salida con sus respectivas propiedades y campos de origen. De manera predeterminada, la salida incluirá todos los campos del dataset de entrada.

Use el campo de mapa para añadir, borrar, cambiar el nombre y reordenar los campos, así como para cambiar otras propiedades de los campos.

El mapa de campo también puede usarse para combinar valores de dos o más campos de entrada en un solo campo de salida.

Field Mappings
Campo de ordenamiento
(Opcional)

Los campos cuyos valores se utilizarán para reordenar los registros de entrada y la dirección en que se ordenarán los registros.

  • Ascendente: los registros se ordenarán del valor bajo al valor alto.
  • Descendente: los registros se ordenarán del valor alto al valor bajo.

Value Table

arcpy.conversion.ExportFeatures(in_features, out_features, {where_clause}, {use_field_alias_as_name}, {field_mapping}, {sort_field})
NombreExplicaciónTipo de datos
in_features

Las entidades de entrada que se exportarán a una nueva clase de entidad.

Feature Layer
out_features

La clase de entidad de salida que contiene las entidades exportadas.

Feature Class
where_clause
(Opcional)

Una expresión SQL utilizada para seleccionar un subconjunto de entidades. Para obtener más información sobre la sintaxis SQL, consulte el tema de ayuda Referencia SQL para las expresiones de consulta utilizadas en ArcGIS.

SQL Expression
use_field_alias_as_name
(Opcional)

Especifica si los nombres de campo o alias de campo de entrada se utilizarán como el nombre de campo de salida.

  • NOT_USE_ALIASSe utilizarán los nombres de campo de la entrada como nombres de campo de salida. Esta es la opción predeterminada.
  • USE_ALIASSe utilizarán los alias de campo de entrada como nombres de campo de salida.
Boolean
field_mapping
(Opcional)

Los campos que se transferirán al dataset de salida con sus respectivas propiedades y campos de origen. De manera predeterminada, la salida incluirá todos los campos del dataset de entrada.

Use el campo de mapa para añadir, borrar, cambiar el nombre y reordenar los campos, así como para cambiar otras propiedades de los campos.

El mapa de campo también puede usarse para combinar valores de dos o más campos de entrada en un solo campo de salida.

Field Mappings
sort_field
[sort_field,...]
(Opcional)

Los campos cuyos valores se utilizarán para reordenar los registros de entrada y la dirección en que se ordenarán los registros.

  • ASCENDING: los registros se ordenarán del valor bajo al valor alto.
  • DESCENDING: los registros se ordenarán del valor alto al valor bajo.

Value Table

Muestra de código

Ejemplo 1 de ExportFeatures (ventana de Python)

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

import arcpy
arcpy.env.workspace = "C:/data/SFValley.gdb"
arcpy.conversion.ExportFeatures("streets", "C:/output/output.gdb/streets")
Ejemplo 2 de ExportFeatures (script independiente)

El siguiente script independiente muestra cómo utilizar la función ExportFeatures.

# Name: ExportFeatures_Example2.py
# Description: Use Export Features with an expression to create a subset of the
# original feature class.

# Import system modules

import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/SFValley.gdb"

# Set local variables
inFeatures = "streets"
outFeatureClass =  "C:/output/output.gdb/arterials"
expression = arcpy.AddFieldDelimiters(arcpy.env.workspace, "Category") + " = 'Arterials'"

# Run ExportFeatures
arcpy.conversion.ExportFeatures(inFeatures, outFeatureClass, expression,
                               "NOT_USE_ALIAS")

Temas relacionados