Calcular campo

Nota:

Esta herramienta solo está disponible en ModelBuilder.

La herramienta Calcular campo utiliza una expresión SQL para calcular valores para un campo nuevo o existente. Sobrescribir un campo del dataset de salida no afectará a los valores de los campos del dataset de entrada.

El resultado es una variable de datos de salida que se puede configurar como una capa intermedia o una capa alojada.

Ejemplos

Algunos ejemplos de uso de esta herramienta son:

• Un dataset incluye campos para el número de edificios residenciales con paneles solares en el tejado y el número total de edificios residenciales por barrio. Calcular campo se puede utilizar para crear un nuevo campo y calcular la tasa de absorción solar en cada barrio.
• Un dataset incluye un campo numérico en el que se utilizó -9999 como valor de marcador de posición, lo que afectaría a los resultados del análisis si este campo se utilizara como entrada. Calcular campo se puede utilizar para cambiar el valor a un valor predeterminado apropiado para el subconjunto de registros con el marcador de posición -9999.

Notas de uso

Calcular campo incluye configuraciones para la entrada, el cálculo del campo y la capa de resultados.

Entrada

El grupo Entrada incluye los siguientes parámetros:

• El Dataset de entrada especifica si la entrada es una capa de entidades alojada o una capa de tablas alojada. Puede elegir un dataset haciendo clic en Capa .

• Aplicar cálculos solo a determinados registros define los criterios que determinan a qué subconjunto de registros se aplicará el cálculo de campo. Las entidades que satisfagan todos los criterios se incluirán en el subconjunto. Para definir una consulta, haga clic en Crear nueva consulta. Debe especificarse un dataset de entrada para editar la expresión.

  Para aplicar el cálculo a todos los registros, deje este parámetro en blanco.

  Más información sobre cómo construir una consulta

Cálculo de campo

El grupo Cálculo de campo incluye los siguientes parámetros:

• Campo para calcular especifica el campo en el que se agregarán los valores calculados. Puede elegir entre una lista de campos existentes o crear un campo nuevo.

  Si se elige un campo existente, se sobrescribirán todos los valores que contenga actualmente.

  Nota:

  Calcular campo crea un nuevo dataset de salida. Sobrescribir un campo del dataset de salida no afectará a los valores de los campos del dataset de entrada.

  Para crear un nuevo campo, haga clic en Crear nuevo campo y especifique lo siguiente:
  • Nombre de campo: especifique un nombre para el nuevo campo. El nombre del campo no puede ser igual al de ningún campo existente en la capa, no puede contener caracteres especiales ni espacios y no puede ser una palabra clave SQL.
  • Tipo de campo: seleccione un tipo de campo en el menú. El tipo de campo determinará qué tipos de datos y expresiones son compatibles para calcular el campo. Se admiten los tipos de campo siguientes:
    • Doble: números con posiciones decimales.
    • Entero: números enteros del -2.147.483.648 al 2.147.483.647 (entero largo).
    • Entero grande: números enteros de -9.007.199.254.740.991 a 9.007.199.254.740.991. Utilice este tipo cuando necesite almacenar números y no quepan en el rango del tipo de datos entero.
    • Cadena de caracteres: cualquier secuencia de caracteres.
    • Fecha: fecha y hora.
    • Solo fecha: almacena una fecha aunque no valores de hora. Esto resulta útil cuando no se necesitan horas, como, por ejemplo, al registrar el día en el que expira un permiso.
    • Solo hora: almacena una hora aunque no valores de fecha. El formato de la hora viene determinado por la configuración del usuario. Este tipo de datos de campo es útil para registrar valores como la hora de salida.

• Expresión de cálculo de campo define una expresión SQL que se utiliza para calcular valores para Campo para calcular. Haga clic en Expresión para abrir la ventana Editor de expresiones de SQL. En la ventana Editor de expresiones SQL, utilice Campos , Funciones y operadores básicos para crear una expresión válida.

  Más información sobre cómo escribir una expresión SQL

  Si el resultado de la expresión y el tipo de campo son parcialmente compatibles (por ejemplo, los tipos de campo doble e entero admiten resultados numéricos, pero con restricciones diferentes), los valores se transformarán automáticamente para cumplir los requisitos del tipo de campo. La transformación se llevará a cabo automáticamente y sin notificaciones.

  En la tabla siguiente se describe cómo se transformarán determinados resultados para que coincidan con el tipo de campo:

  Salida	Tipo de campo	Transformación
  Doble	Entero	Redondea al número entero más cercano.
  Solo fecha	Fecha	Añadir 12:00 a.m. UTC a cada fecha
  Fecha	Solo fecha	Convertir la fecha y la hora a UTC y almacenar la fecha
  Fecha	Solo hora	Convertir la fecha y la hora a UTC y almacena la hora

Capa de resultados

El grupo Capa de resultados incluye los siguientes parámetros:

• El Tipo de resultado especifica si la salida es una capa intermedia o una capa de entidades alojada. Las siguientes opciones están disponibles:
  • Crear datos intermedios crea un dataset temporal que se puede utilizar como entrada para otro elemento de la herramienta. Este es el valor predeterminado para todas las herramientas de un modelo.
  • Crear capa alojada crea una nueva capa alojada para el dataset de salida. Si se elige esta opción, estarán disponibles los siguientes parámetros:
    • Nombre de salida especifica el nombre de la capa que se crea y se visualiza. El nombre debe ser único. Si ya existe una capa con el mismo nombre en su organización, la herramienta fallará y se le pedirá que utilice otro nombre.
    • Si existe una capa con el mismo nombre, la opción, sobrescribirla automáticamente determina si el modelo se puede volver a ejecutar sin cambiar el nombre de la capa de salida. Si la capa no existe todavía en la organización, se creará una nueva capa en la primera ejecución del modelo y se sobrescribirá en las siguientes ejecuciones del modelo. El parámetro está habilitado de forma predeterminada.
    • Guardar en carpeta especifica el nombre de una carpeta de Mi contenido en la que se guardará el resultado.
  • Sobrescribir capa existente especifica una capa alojada existente que será sobrescrita por el resultado de la herramienta. Si se selecciona esta opción, también estará disponible el parámetro Capas sobre las que sobrescribir para buscar una capa existente.

Más información sobre las salidas de modelo

Limitaciones

Se aplican las siguientes limitaciones a la herramienta:

• Calcular campo solo está disponible en ModelBuilder. Si no utiliza ModelBuilder, puede calcular valores de campo en Visor de mapas.
• No se admiten expresiones espaciales.
• Las listas de valores de campo no están disponibles en el generador de consultas cuando la capa o tabla de entrada es el resultado de otra herramienta.
• Si el valor calculado para un campo de cadena de caracteres o número supera los límites de longitud del campo, el resultado aparecerá como nulo para los campos nuevos o mantendrá el valor del campo de entrada para los campos existentes.
• Los cálculos de campo que utilizan campos de entrada y salida incompatibles pueden producir resultados inesperados. Por ejemplo, si se utiliza un campo de Solo hora para calcular un resultado de Solo fecha, el resultado será la fecha 1899-12-30 en todos los campos. Otras combinaciones de campos incompatibles incluyen entradas de Solo hora con Salidas de fecha y entradas de Solo fecha con salidas de Solo hora.

Entornos

Esta herramienta no admite entornos de análisis.

Créditos

Esta herramienta no consume créditos.

Salidas

Calcular campo crea una variable de datos de salida que puede ser datos intermedios o alojados. El dataset de salida tiene la misma geometría y los mismos campos que el conjunto de datos de entrada, a menos que se agregue un nuevo campo para el cálculo.

Nota:

Calcular campo crea un nuevo dataset de salida. Sobrescribir un campo del dataset de salida no afectará a los valores de los campos del dataset de entrada.

Requisitos de licencia

Esta herramienta requiere los siguientes tipos de usuario y configuraciones:

• Tipo de usuario Professional o Professional Plus
• Rol de publicador, moderador o administrador, o rol personalizado equivalente

Recursos

Utilice los recursos siguientes para más información:

• Cómo crear una consulta
• Calcular valores de campo (Visor de mapas)
• Calcular campo en ArcGIS Data Pipelines
• Calcular campo en ArcGIS Pro