Etiqueta | Explicación | Tipo de datos |
Tabla de entrada | Tabla o clase de entidad de entrada. | Table View |
Tabla de Salida | La tabla o clase de entidad de salida que contiene los campos actualizados. | Table |
Tabla de definición de esquema de salida | Una tabla que contiene las definiciones de campo y los cálculos que se utilizarán para crear la salida. | Table View |
Archivo de script (Opcional) | Un archivo Python que almacena varias funciones de Python de línea para realizar cálculos para los campos del parámetro Tabla de salida. | File |
Nombre de campo de salida (Opcional) | El nombre de campo de la tabla de definición que contiene los nombres de campo de destino para la tabla de salida. | Field |
Nombre de campo de origen (Opcional) | El nombre de campo de la tabla de definición que contiene los nombres de campo de origen de la tabla de entrada. | Field |
Tipo de campo de salida (Opcional) | El nombre de campo de la tabla de definición que define los tipos de datos para la tabla de salida. | Field |
Longitud o decimales del campo de salida (Opcional) | El nombre de campo de la tabla de definición que define el número de decimales o la longitud del campo para los campos de salida. | Field |
Alias de campo de salida (Opcional) | El nombre de campo de la tabla de definición que define los nombres de alias para los campos de la tabla de salida. | Field |
Script de campo de salida (Opcional) | El nombre de campo de la tabla de definición que define los cálculos para los campos de salida. | Field |
Resumen
Transforma los campos de una tabla o clase de entidad basándose en el esquema definido en la tabla de definición y crea una tabla o clase de entidad nueva.
Si utiliza esta herramienta, podrá realizar lo siguiente:
- Agregar nuevos campos
- Actualizar campos existentes
- Reordenar campos
- Cambiar tipos de campo
- Cambiar propiedades de campos
- Asignar o actualizar alias de campo
- Calcular valores de campo en función de los campos existentes con Python
- Quitar campos
Uso
La tabla de entrada puede ser una tabla o clase de entidad. La herramienta genera una nueva tabla o clase de entidad con el esquema actualizado.
Los cambios de esquema para la tabla de salida se definen mediante el parámetro Tabla de definición de esquema de salida.
A continuación, se muestra un ejemplo de una tabla de definición:
Si el valor del parámetro Tabla de definición de esquema de salida incluye los siguientes nombres de campo, como en el ejemplo anterior. Los valores de parámetro correspondientes se rellenarán automáticamente:
- Target field
- Source field
- Type
- Decimals/Length
- Alias
- Script
La herramienta calcula nuevos campos usando campos existentes proporcionando un campo de script en la tabla de definición.
Un valor de ejemplo en el campo Script de la tabla de definición es !TOTPOP!/!AREA!, que calcula el campo Population Density. Los nombres de campo deben estar entre signos de exclamación.
La herramienta puede crear campos adicionales que dependen de otros cálculos de campo. Por ejemplo, el campo Bev_Index se calcula con el campo Bev_Per_Capita, que también se calcula al ejecutar la herramienta.
Utilice el parámetro Archivo de script para varios cálculos de Python de línea. Para usar un archivo de script, cree un archivo con las funciones de Python y haga referencia a las funciones en la tabla de definición.
A continuación, se muestra un ejemplo de código de script para un campo de destino llamado Bev_Per_Capita:
- Un campo llamado Script en el valor del parámetro Tabla de definición de esquema de salida con el valor e Bev_Per_Capita(!Bev_Total!, !TOTPOP!)
- Un valor del parámetro Archivo de script con la siguiente función:
def Bev_Per_Capita(Bev_Total, TOTPOP): return Bev_Total / TOTPOP
A continuación, se encuentra un ejemplo en el que se muestra la tabla de atributos antes y después de ejecutar la herramienta:
Parámetros
arcpy.management.BatchUpdateFields(in_table, out_table, field_definition_table, {script_file}, {output_field_name}, {source_field_name}, {output_field_type}, {output_field_decimals_or_length}, {output_field_alias}, {output_field_script})
Nombre | Explicación | Tipo de datos |
in_table | Tabla o clase de entidad de entrada. | Table View |
out_table | La tabla o clase de entidad de salida que contiene los campos actualizados. | Table |
field_definition_table | Una tabla que contiene las definiciones de campo y los cálculos que se utilizarán para crear la salida. | Table View |
script_file (Opcional) | Un archivo Python que almacena varias funciones de Python de línea para realizar cálculos para los campos del parámetro out_table. | File |
output_field_name (Opcional) | El nombre de campo de la tabla de definición que contiene los nombres de campo de destino para la tabla de salida. | Field |
source_field_name (Opcional) | El nombre de campo de la tabla de definición que contiene los nombres de campo de origen de la tabla de entrada. | Field |
output_field_type (Opcional) | El nombre de campo de la tabla de definición que define los tipos de datos para la tabla de salida. | Field |
output_field_decimals_or_length (Opcional) | El nombre de campo de la tabla de definición que define el número de decimales o la longitud del campo para los campos de salida. | Field |
output_field_alias (Opcional) | El nombre de campo de la tabla de definición que define los nombres de alias para los campos de la tabla de salida. | Field |
output_field_script (Opcional) | El nombre de campo de la tabla de definición que define los cálculos para los campos de salida. | Field |
Muestra de código
El siguiente script de la ventana de Python demuestra cómo utilizar la función BatchUpdateFields en un script independiente.
arcpy.management.BatchUpdateFields("zip_codes", "MyProject.gdb\zip_codes_BatchUpdateFields", "DATA_TRANSFORMATION.csv", r"C:\BatchUpdate\script.py", "TARGET", "SOURCE", "DATATYPE", "DECIMALS", "ALIAS", "SCRIPT")
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí