Actualizar entidades con registros de incidentes (Herramientas de análisis de la criminalidad y de seguridad)

Resumen

Actualiza una tabla existente o convierte una tabla no espacial en entidades de puntos según unas coordenadas x,y o direcciones de calles y actualiza un dataset existente con la información de registro nueva o actualizada de la tabla.

Uso

Debe existir una clase de entidad de puntos, capa de entidades de puntos o tabla donde se incorporarán o actualizarán los registros de la tabla de entrada.
Puede utilizar los datos tabulares exportados desde un sistema de envío asistido por ordenador o el sistema de administración de registros de esta herramienta.

Esta herramienta soporta los siguientes formatos de tabla como entrada:
- Geodatabase
- dBASE (.dbf)
- Hojas de cálculo de Microsoft Excel (.xls y .xlsx)
- Tablas basadas en memoria
- Archivos delimitados
  - Archivos delimitados por comas (.csv, .txt y .asc)
  - Archivos delimitados por tabuladores (.tsv y .tab)
  - Archivos delimitados por barras verticales (.psv)
Para los archivos delimitados, la primera fila del archivo de entrada se utiliza como los nombres de los campos en la tabla de salida. Los nombres de campo no pueden contener espacios ni caracteres especiales (como $ o *) y se producirá un error si la primera fila del archivo de entrada contiene espacios o caracteres especiales.

Para realizar operaciones de geocodificación con ArcGIS World Geocoding Service, es necesario disponer de una cuenta de organización de ArcGIS Online, y se consumen créditos. La cuenta de organización debe tener suficientes créditos para completar toda la solicitud de geocodificación.
Cuando se crea el valor del parámetro opcional Tabla de registros no válidos, la tabla contiene registros que no se procesaron como entidades nuevas o actualizadas. El registro completo de la tabla de entrada se agregará al valor del parámetro Tabla de registros no válidos, así como a un campo INV_REASON. El campo INV_REASON incluirá un código que identifica la razón por la que el registro no se pudo procesar como entidades nuevas o actualizadas.

El campo INV_REASON se agrega al valor Tabla de registros no válidos con los siguientes códigos de error:
- NULL_ADDR—Todos los campos de dirección del registro de la tabla de entrada contienen valores nulos.
- NULL_ID—Los campos de Id. de entrada del registro de la tabla de entrada contienen valores nulos.
- NULL_XY—Los campos de coordenadas x e y de la tabla de entrada contienen un valor nulo.
- BAD_DATE—La fecha de entrada del registro de la tabla de entrada es nula o no se pudo convertir a una fecha válida.
- BAD_ADDR—El candidato de dirección del registro de la tabla de entrada no está asignado.
- BAD_FM—La asignación de campos del registro de la tabla de entrada no se realizó porque no se pudo escribir un valor en el campo de salida. Por ejemplo, no se pueden agregar valores de texto a campos numéricos, y tampoco se pueden agregar valores de texto a campos de texto si los valores superan la longitud del campo. Cuando se produce este código, el campo INV_FLD se agrega al valor Tabla de registros no válidos y enumera los campos del valor Tabla de entrada que contienen valores que no se pudieron escribir en el valor Entidades de destino.
- DUP_ID—El registro de la tabla de entrada tiene un Id. duplicado y no se ha actualizado en las entidades de entrada porque es más antiguo que el registro existente o ya existe un registro más nuevo. Viene determinado por la fecha de última modificación. Si no se utiliza la fecha de última modificación, se determina por el valor de OBJECTID más alto.
- APD_ERR—El registro de tablas de entrada podría no incorporarse a la capa de destino debido a un error inesperado durante el procesamiento.
- UPD_ERR—El registro de tablas de entrada podría no utilizarse para actualizar el registro de destino correspondiente en un servicio de entidades debido a un error inesperado durante el procesamiento. Cuando esto ocurre, el campo INV_FLD se agrega al valor de Tabla de registros no válidos y presenta el código de error del servicio de entidades y la descripción del error detectado durante el procesamiento.
Sugerencia:

Una razón habitual por la que se identifica el código de error UPD_ERR o APD_ERR es la existencia del contenido HTML almacenado en la tabla de entrada de los campos. Esto provoca un error porque la configuración predeterminada de servicios de entidades impide añadir valores HTML a un campo.

Cuando no se proporciona ningún valor del parámetro Tabla de registros no válidos, se crea un archivo invalid_records_<timestamp>.fid en el entorno del espacio de trabajo temporal. Este archivo contendrá el valor OBJECTID de cada registro de Tabla de entrada que no se pudo agregar o actualizar en el parámetro Entidades de destino.
Cuando los parámetros Actualizar entidades de destino existentes y Actualizar geometría para entidades existentes están activos, los campos de ubicación del valor del parámetro Tabla de entrada se comparan con los campos de ubicación del valor del parámetro Entidades de destino para determinar si la geometría se actualizará en el valor del parámetro Entidad de destino. Cuando Tipo de ubicación se establece en Direcciones, se comparan los valores de Campos de dirección. Si se detecta una diferencia entre el registro de la Tabla de entrada y los valores del parámetro Entidades de destino, la geometría de las Entidades de destino se actualiza con la posición geocodificada según los campos de dirección del registro de la Tabla de entrada. El registro de la Tabla de entrada no se geocodificará si no se detecta ninguna diferencia.
Cuando la capa especificada en el valor del parámetro Entidades de destino es una capa de servicio de entidades, utilice el parámetro Convertir fechas a zona horaria UTC para especificar si los valores de fecha de la Tabla de entrada se convertirán a hora universal coordinada (UTC). Se supone que los valores de fecha están en la misma zona horaria que el sistema local.

Etiqueta	Explicación	Tipo de datos
Tabla de entrada	La tabla o la tabla no espacial que contiene las coordenadas x e y o direcciones que definen las ubicaciones de los registros.	Table View
Entidades de destino	La clase de entidad de punto, capa de entidades de punto o tabla que se actualizará.	Feature Layer; Table View
Tipo de localización (Opcional)	Especifica si las entidades se crearán utilizando coordenadas x,y o direcciones. Este parámetro solo está activo cuando el valor del parámetro Entidades de destino es una capa o clase de entidad. Coordenadas—Las entidades se crearán utilizando las coordenadas x,y del registro de entrada. Direcciones—Las entidades se crearán utilizando la dirección del registro de entrada utilizando un localizador.	String
Campo X (Opcional)	El campo de la tabla de entrada que contiene las coordenadas X (o longitud). Este parámetro solo está activo cuando el parámetro Tipo de ubicación está definido como Coordenadas y el valor del parámetro Entidades de destino es una capa o clase de entidad.	Field
Campo Y (Opcional)	El campo de la tabla de entrada que contiene las coordenadas Y (o latitud). Este parámetro solo está activo cuando el parámetro Tipo de ubicación está definido como Coordenadas y el valor del parámetro Entidades de destino es una capa o clase de entidad.	Field
Sistema de coordenadas (Opcional)	El sistema de coordenadas de las coordenadas x e y. Este parámetro solo está activo cuando el parámetro Tipo de ubicación está definido como Coordenadas y el valor del parámetro Entidades de destino es una capa o clase de entidad.	Coordinate System
Localizador de direcciones (Opcional)	El localizador de direcciones que se utilizará para geocodificar la tabla de direcciones. Cuando este parámetro está configurado para usar el servicio de geocodificación mundial de ArcGIS, esta operación puede consumir créditos. Nota: Al utilizar un localizador de direcciones local, agregar la extensión `.loc` después del nombre del localizador al final de la ruta del localizador es opcional. Este parámetro solo está activo cuando el parámetro Tipo de ubicación está definido como Direcciones y el valor del parámetro Entidades de destino es una capa o clase de entidad.	Address Locator
Tipo de dirección (Opcional)	Especifica cómo se asignarán los campos de dirección utilizados por el localizador de direcciones a los campos de la tabla de entrada de direcciones. Especifique Campo único si la dirección completa se almacena en un solo campo de la tabla de entrada, por ejemplo, 303 Peachtree St NE, Atlanta, GA 30308. Espeficique Varios campos si las direcciones de entrada están divididas en varios campos, como Dirección, Ciudad, Estado y CP para una dirección general de Estados Unidos. Este parámetro solo está activo cuando el parámetro Tipo de ubicación está definido como Direcciones y el valor del parámetro Entidades de destino es una capa o clase de entidad. Varios campos—Las direcciones se dividirán en varios campos. Campo único—Las direcciones estarán contenidas en un campo.	String
Campos de dirección (Opcional)	Los campos de la tabla de entrada que corresponden a los campos de dirección del localizador del localizador de direcciones. Algunos localizadores admiten varios campos de dirección de entrada tales como `Address`, `Address2` y `Address3`. En este caso, el componente de dirección se puede separar en varios campos y los campos de dirección se concatenarán en el momento de la geocodificación. Por ejemplo, 100, Main st y Apt 140 en tres campos, o 100 Main st y Apt 140 en dos campos, ambos se convertirían en 100 Main st Apt 140 al geocodificar. Si no asigna ningún campo de dirección de entrada opcional empleado por el localizador de direcciones a un campo de la tabla de entrada de direcciones, deje el nombre del campo en blanco para indicar que no existe representación cartográfica. Este parámetro solo está activo cuando el parámetro Tipo de ubicación está establecido en Direcciones. Columnas de la tabla de valores: Locator Address Field—The locator address field or fields contained in the address locator. Input Address Field—The input table fields that correspond to the locator address fields.	Value Table
Tabla de registros no válidos (Opcional)	La tabla de salida que contiene una lista de registros no válidos y los códigos de invalidación asociados.	Table
Expresión (Opcional)	La expresión SQL que se usará para seleccionar un subconjunto de los registros de los datasets de entrada. Si se especifican varios datasets de entrada, se evaluarán utilizando la expresión. Si no hay ningún registro que coincida con la expresión de un dataset de entrada, no se incorporará ningún registro de ese dataset al destino. Para obtener más información sobre la sintaxis SQL, consulte Referencia SQL para las expresiones de consulta utilizadas en ArcGIS.	SQL Expression
Actualizar entidades de destino existentes (Opcional)	Especifica si los registros existentes se actualizarán en el valor del parámetro Entidades de destino. Activado—Los registros del valor del parámetro Tabla de entrada se actualizarán en el valor del parámetro Entidades de destino si ya existen ahí. Desactivado—Los registros del valor del parámetro Tabla de entrada se incorporarán al valor del parámetro Entidades de destino. Esta es la opción predeterminada.	Boolean
Campos coincidentes (Opcional)	El campo o los campos de Id. que se utilizarán para determinar las coincidencias entre los valores de Tabla de entrada y los valores de Entidades de destino. Este parámetro solo está activo cuando el parámetro Actualizar entidades de destino existentes está activado. Columnas de la tabla de valores: Input ID Field—The name of the input table field containing the ID value. Target ID Field—The name of the target features field containing the ID value to compare to the corresponding input table ID value.	Value Table
Campo de fecha de última modificación de la tabla de entrada (Opcional)	El campo que contiene la última fecha de modificación de los registros de Entidades de entrada. Se admiten los tipos de campo de fecha y cadena de caracteres. Este parámetro solo está activo cuando el parámetro Actualizar entidades de destino existentes está activado.	Field
Campo de fecha de última modificación de las entidades de destino (Opcional)	El campo que contiene la última fecha de modificación de los registros de Entidades de destino. Este campo debe ser de tipo fecha. Este parámetro solo está activo cuando el parámetro Actualizar entidades de destino existentes está activado.	Field
Actualizar solo entidades coincidentes (Opcional)	Especifica si solo se actualizarán los registros existentes o si se actualizarán los registros existentes y se agregarán nuevos registros. Este parámetro solo está habilitado cuando el parámetro Actualizar entidades de destino existentes está activado. Activado—Solo se actualizarán los registros existentes. Desactivado—Se actualizarán los registros existentes y se agregarán nuevos registros. Esta es la opción predeterminada.	Boolean
Actualizar geometría para entidades existentes (Opcional)	Especifica si se actualizará la geometría de las entidades existentes. Este parámetro solo está habilitado cuando el parámetro Actualizar entidades de destino existente está activado y el valor del parámetro Entidades de destino es una capa o clase de entidad. Activado—Se actualizará la geometría de los registros existentes cuando la información de geometría del valor del parámetro Tabla de entrada difiera de la geometría del valor del parámetro Entidades de destino. Esta es la opción predeterminada. Desactivado—No se actualizará la geometría de los registros existentes.	Boolean
Tipo de coincidencia de campos (Opcional)	Especifica si los campos de la tabla de entrada deben coincidir con los campos de las entidades de destino para que se incorporen los datos. Los campos de entrada deben coincidir con los campos de destino—Los campos del dataset de entrada coinciden con los campos del dataset de destino. Los campos que no coincidan se ignorarán. Esta es la configuración predeterminada Utilizar el mapa de campo para conciliar las diferencias de campo—No es necesario que los campos del dataset de entrada coincidan con los campos del dataset de destino. Los campos del dataset de entrada que no coincidan con los campos del dataset de destino no se asignarán al dataset de destino, a menos que la asignación esté establecida de manera explícita en el parámetro Mapa de campo.	String
Mapa de campo (Opcional)	Controla la forma en que se transferirán o se asignarán los campos de atributo de la tabla de entrada a las entidades de destino. Este parámetro solo está activo si el parámetro Tipo de coincidencia de campos se ha establecido en Utilizar el mapa de campo para conciliar las diferencias de campo. Dado que los valores de la tabla de entrada se incorporan a una entidad de destino existente que tiene campos predefinidos, no puede agregar, eliminar ni cambiar el tipo de campo del mapa de campo. Sin embargo, sí que puede definir regla de fusión para cada campo de salida. 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
Formato de hora	El formato del campo de entrada que contiene los valores de tiempo. El tipo puede ser: corto, largo, flotante, doble, texto o fecha. Puede elegir un formato de tiempo estándar en la lista desplegable o proporcionar un formato personalizado. Nota: Las cadenas de caracteres del formato distinguen entre mayúsculas y minúsculas. Si el tipo de datos del campo de hora es fecha, solo fecha o desplazamiento de fecha y hora, no se requiere ningún formato de hora. Si el tipo de datos del campo de tiempo es numérico (corto, largo, flotante, doble o entero grande), se proporciona una lista de formatos de tiempo numéricos estándar en la lista desplegable. Si el tipo de datos del campo de tiempo es una cadena, se proporcionará una lista de formatos de tiempo de cadena estándar en la lista desplegable. Para campos de cadena, también puede especificar un formato de tiempo personalizado. Por ejemplo, los valores de tiempo pueden haberse almacenado en un campo de cadena, en uno de los formatos estándar, como por ejemplo aaaa/MM/dd HH:mm:ss o en un formato personalizado, como dd/MM/aaaa HH:mm:ss. En el formato personalizado, también puede especificar la designación de a.m. o p.m. Para cadenas compatibles con ISO-8601, utilice aaaa-MM-ddTHH:mm:ss.s como formato de entrada. Esta selección de entrada puede manejar entradas que utilicen un designador UTC (Z) o desplazamientos UTC (±hh:mm). Estos son los formatos que se utilizan frecuentemente: yyyy—Año representado por cuatro dígitos MM—Mes como dígitos con ceros a la izquierda para meses de un solo dígito MMM—Mes como abreviatura de tres letras dd—Día del mes como dígitos con ceros a la izquierda para días de un solo dígito ddd—Día de la semana como abreviatura de tres letras hh—Horas con cero a la izquierda para horas de un solo dígito y un reloj de 12 horas HH—Horas con ceros a la izquierda para horas de un solo dígito y un reloj de 24 horas mm—Minutos con ceros a la izquierda para minutos de un solo dígito ss—Segundos con ceros a la izquierda para segundos de un solo dígito t—Una cadena de caracteres marcadora de carácter de tiempo, como por ejemplo, A o P tt—Una cadena de caracteres marcadora de múltiples caracteres de tiempo, como por ejemplo, AM o PM unix_us—Hora UNIX en microsegundos unix_ms—Hora UNIX en milisegundos unix_s—Hora UNIX en segundos unix_hex—Hora UNIX en formato hexadecimal Más información sobre formatos de fecha y hora personalizados Este parámetro solo está activo cuando el valor del parámetro Campo de fecha de última modificación de la tabla de entrada es un campo de texto y el valor del parámetro Campo de fecha de última modificación de las entidades de destino es un campo de fecha, o el valor de entrada del parámetro Mapa de campo es un campo de texto y el valor de salida es un campo de fecha.	String
Convertir fechas a zona horaria UTC (Opcional)	Especifica si los valores de fecha de los registros de entrada se convertirán de la zona horaria del sistema local a UTC. Este parámetro solo está activo cuando el valor del parámetro Entidades de destino es una capa de servicio de entidades. Activado—Los valores de fecha de los registros de entrada se convertirán de la zona horaria del sistema local a UTC. Esta es la opción predeterminada. Desactivado—Los valores de fecha de los registros de entrada permanecerán en la zona horaria del sistema local.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Entidades de destino actualizadas	El dataset de destino actualizado.	Feature Layer; Table View

arcpy.ca.UpdateFeaturesWithIncidentRecords(in_table, target_features, {location_type}, {x_field}, {y_field}, {coordinate_system}, {address_locator}, {address_type}, {address_fields}, {invalid_records_table}, {where_clause}, {update_target}, {match_fields}, {in_date_field}, {target_date_field}, {update_matching}, {update_geometry}, {field_matching_type}, {field_mapping}, time_format, {convert_local_time})

Nombre	Explicación	Tipo de datos
in_table	La tabla o la tabla no espacial que contiene las coordenadas x e y o direcciones que definen las ubicaciones de los registros.	Table View
target_features	La clase de entidad de punto, capa de entidades de punto o tabla que se actualizará.	Feature Layer; Table View
location_type (Opcional)	Especifica si las entidades se crearán utilizando coordenadas x,y o direcciones. Este parámetro solo está activo cuando el valor del parámetro `target_features` es una capa o clase de entidad. `COORDINATES`—Las entidades se crearán utilizando las coordenadas x,y del registro de entrada. `ADDRESSES`—Las entidades se crearán utilizando la dirección del registro de entrada utilizando un localizador.	String
x_field (Opcional)	El campo de la tabla de entrada que contiene las coordenadas X (o longitud). Este parámetro solo está activo cuando el parámetro `location_type` está definido como `COORDINATES` y el valor del parámetro `target_features` es una capa o clase de entidad.	Field
y_field (Opcional)	El campo de la tabla de entrada que contiene las coordenadas Y (o latitud). Este parámetro solo está activo cuando el parámetro `location_type` está definido como `COORDINATES` y el valor del parámetro `target_features` es una capa o clase de entidad.	Field
coordinate_system (Opcional)	El sistema de coordenadas de las coordenadas x e y. Este parámetro solo está activo cuando el parámetro `location_type` está definido como `COORDINATES` y el valor del parámetro `target_features` es una capa o clase de entidad.	Coordinate System
address_locator (Opcional)	El localizador de direcciones que se utilizará para geocodificar la tabla de direcciones. Cuando este parámetro está configurado para usar el servicio de geocodificación mundial de ArcGIS, esta operación puede consumir créditos. Nota: Al utilizar un localizador de direcciones local, agregar la extensión `.loc` después del nombre del localizador al final de la ruta del localizador es opcional. Este parámetro solo está activo cuando el parámetro `location_type` está definido como `ADDRESSES` y el valor del parámetro `target_features` es una capa o clase de entidad.	Address Locator
address_type (Opcional)	Especifica cómo se asignarán los campos de dirección utilizados por el localizador de direcciones a los campos de la tabla de entrada de direcciones. Especifique `SINGLE_FIELD_ADDRESS` si la dirección completa se almacena en un solo campo de la tabla de entrada, por ejemplo, 303 Peachtree St NE, Atlanta, GA 30308. Espeficique `MULTI_FIELD_ADDRESS` si las direcciones de entrada están divididas en varios campos, como Dirección, Ciudad, Estado y CP para una dirección general de Estados Unidos. Este parámetro solo está activo cuando el parámetro `location_type` está definido como `ADDRESSES` y el valor del parámetro `target_features` es una capa o clase de entidad. `MULTI_FIELD_ADDRESS`—Las direcciones se dividirán en varios campos. `SINGLE_FIELD_ADDRESS`—Las direcciones estarán contenidas en un campo.	String
address_fields [address_fields,...] (Opcional)	Los campos de la tabla de entrada que corresponden a los campos de dirección del localizador del localizador de direcciones. Algunos localizadores admiten varios campos de dirección de entrada tales como `Address`, `Address2` y `Address3`. En este caso, el componente de dirección se puede separar en varios campos y los campos de dirección se concatenarán en el momento de la geocodificación. Por ejemplo, 100, Main st y Apt 140 en tres campos, o 100 Main st y Apt 140 en dos campos, ambos se convertirían en 100 Main st Apt 140 al geocodificar. Si no asigna ningún campo de dirección de entrada opcional empleado por el localizador de direcciones a un campo de la tabla de entrada de direcciones, deje el nombre del campo en blanco para indicar que no existe representación cartográfica. Este parámetro solo está habilitado cuando el parámetro `location_type` tiene el valor `ADDRESSES`. Columnas de la tabla de valores: `Locator Address Field`—The locator address field or fields contained in the address locator. `Input Address Field`—The input table fields that correspond to the locator address fields.	Value Table
invalid_records_table (Opcional)	La tabla de salida que contiene una lista de registros no válidos y los códigos de invalidación asociados.	Table
where_clause (Opcional)	La expresión SQL que se usará para seleccionar un subconjunto de los registros de los datasets de entrada. Si se especifican varios datasets de entrada, se evaluarán utilizando la expresión. Si no hay ningún registro que coincida con la expresión de un dataset de entrada, no se incorporará ningún registro de ese dataset al destino. Para obtener más información sobre la sintaxis SQL, consulte Referencia SQL para las expresiones de consulta utilizadas en ArcGIS.	SQL Expression
update_target (Opcional)	Especifica si los registros existentes se actualizarán en el valor del parámetro `target_features`. `UPDATE`—Los registros del valor del parámetro `in_table` se actualizarán en el valor del parámetro `target_features` si ya existen ahí. `APPEND`—Los registros del valor del parámetro `in_table` se incorporarán al valor del parámetro `target_features`. Esta es la opción predeterminada.	Boolean
match_fields [match_fields,...] (Opcional)	El campo o los campos de Id. que se utilizarán para determinar las coincidencias entre los valores de `in_table` y los valores de `target_features`. Este parámetro solo está habilitado cuando el parámetro `update_target` tiene el valor `UPDATE`. Columnas de la tabla de valores: `Input ID Field`—The name of the input table field containing the ID value. `Target ID Field`—The name of the target features field containing the ID value to compare to the corresponding input table ID value.	Value Table
in_date_field (Opcional)	El campo que contiene la última fecha de modificación de los registros de `in_table`. Se admiten los tipos de campo de fecha y cadena de caracteres. Este parámetro solo está habilitado cuando el parámetro `update_target` tiene el valor `UPDATE`.	Field
target_date_field (Opcional)	El campo que contiene la última fecha de modificación de los registros de `target_features`. Este campo debe ser de tipo fecha. Este parámetro solo está habilitado cuando el parámetro `update_target` tiene el valor `UPDATE`.	Field
update_matching (Opcional)	Especifica si solo se actualizarán los registros existentes o si se actualizarán los registros existentes y se agregarán nuevos registros. Este parámetro solo está habilitado cuando el parámetro `update_target` tiene el valor `UPDATE`. `UPDATE_MATCHING_ONLY`—Solo se actualizarán los registros existentes. `UPSERT`—Se actualizarán los registros existentes y se agregarán nuevos registros. Esta es la opción predeterminada.	Boolean
update_geometry (Opcional)	Especifica si se actualizará la geometría de las entidades existentes. Este parámetro solo está activo cuando el parámetro `update_target` está definido como `UPDATE` y el valor del parámetro `target_features` es una capa o clase de entidad. `UPDATE_GEOMETRY`—Se actualizará la geometría de los registros existentes cuando la información de geometría del valor del parámetro `in_table` difiera de la geometría del valor del parámetro `target_features`. Esta es la opción predeterminada. `KEEP_GEOMETRY`—No se actualizará la geometría de los registros existentes.	Boolean
field_matching_type (Opcional)	Especifica si los campos de la tabla de entrada deben coincidir con los campos de las entidades de destino para que se incorporen los datos. `AUTOMATIC`—Los campos del dataset de entrada coinciden con los campos del dataset de destino. Los campos que no coincidan se ignorarán. Esta es la configuración predeterminada `FIELD_MAP`—No es necesario que los campos del dataset de entrada coincidan con los campos del dataset de destino. Los campos del dataset de entrada que no coincidan con los campos del dataset de destino no se asignarán al dataset de destino, a menos que la asignación esté establecida de manera explícita en el parámetro Mapa de campo.	String
field_mapping (Opcional)	Controla la forma en que se transferirán o se asignarán los campos de atributo de la tabla de entrada a las entidades de destino. Este parámetro solo está activo si el parámetro `field_matching_type` está establecido en `FIELD_MAP`. Dado que los valores de la tabla de entrada se incorporan a una entidad de destino existente que tiene campos predefinidos, no puede agregar, eliminar ni cambiar el tipo de campo del mapa de campo. Sin embargo, sí que puede definir regla de fusión para cada campo de salida. 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. En Python, utiliza la clase `FieldMappings` para definir este parámetro.	Field Mappings
time_format	El formato del campo de entrada que contiene los valores de tiempo. El tipo puede ser: corto, largo, flotante, doble, texto o fecha. Puede elegir un formato de tiempo estándar en la lista desplegable o proporcionar un formato personalizado. Nota: Las cadenas de caracteres del formato distinguen entre mayúsculas y minúsculas. Si el tipo de datos del campo de hora es fecha, solo fecha o desplazamiento de fecha y hora, no se requiere ningún formato de hora. Si el tipo de datos del campo de tiempo es numérico (corto, largo, flotante, doble o entero grande), se proporciona una lista de formatos de tiempo numéricos estándar en la lista desplegable. Si el tipo de datos del campo de tiempo es una cadena, se proporcionará una lista de formatos de tiempo de cadena estándar en la lista desplegable. Para campos de cadena, también puede especificar un formato de tiempo personalizado. Por ejemplo, los valores de tiempo pueden haberse almacenado en un campo de cadena, en uno de los formatos estándar, como por ejemplo aaaa/MM/dd HH:mm:ss o en un formato personalizado, como dd/MM/aaaa HH:mm:ss. En el formato personalizado, también puede especificar la designación de a.m. o p.m. Para cadenas compatibles con ISO-8601, utilice aaaa-MM-ddTHH:mm:ss.s como formato de entrada. Esta selección de entrada puede manejar entradas que utilicen un designador UTC (Z) o desplazamientos UTC (±hh:mm). Estos son los formatos que se utilizan frecuentemente: yyyy—Año representado por cuatro dígitos MM—Mes como dígitos con ceros a la izquierda para meses de un solo dígito MMM—Mes como abreviatura de tres letras dd—Día del mes como dígitos con ceros a la izquierda para días de un solo dígito ddd—Día de la semana como abreviatura de tres letras hh—Horas con cero a la izquierda para horas de un solo dígito y un reloj de 12 horas HH—Horas con ceros a la izquierda para horas de un solo dígito y un reloj de 24 horas mm—Minutos con ceros a la izquierda para minutos de un solo dígito ss—Segundos con ceros a la izquierda para segundos de un solo dígito t—Una cadena de caracteres marcadora de carácter de tiempo, como por ejemplo, A o P tt—Una cadena de caracteres marcadora de múltiples caracteres de tiempo, como por ejemplo, AM o PM unix_us—Hora UNIX en microsegundos unix_ms—Hora UNIX en milisegundos unix_s—Hora UNIX en segundos unix_hex—Hora UNIX en formato hexadecimal Más información sobre formatos de fecha y hora personalizados Este parámetro solo está habilitado cuando el valor del parámetro `in_date_field` es un campo de texto y el valor del parámetro `target_date_field` es un campo de fecha, o el valor de entrada del parámetro `field_mapping` es un campo de texto y el valor de salida es un campo de fecha Este parámetro solo está habilitado cuando el parámetro `update_target` tiene el valor `UPDATE`.	String
convert_local_time (Opcional)	Especifica si los valores de fecha de los registros de entrada se convertirán de la zona horaria del sistema local a UTC. Este parámetro solo está activo cuando el valor del parámetro `target_features` es una capa de servicio de entidades. `CONVERT`—Los valores de fecha de los registros de entrada se convertirán de la zona horaria del sistema local a UTC. Esta es la opción predeterminada. `NO_CONVERT`—Los valores de fecha de los registros de entrada permanecerán en la zona horaria del sistema local.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
updated_target_features	El dataset de destino actualizado.	Feature Layer; Table View

Muestra de código

Ejemplo 1 de UpdateFeaturesWithIncidentRecords (ventana de Python)

La siguiente secuencia de comandos muestra cómo utilizar la función UpdateFeaturesWithIncidentRecords en el modo inmediato.

import arcpy
arcpy.env.workspace = r"C:\data\city_pd.gdb"

arcpy.ca.UpdateFeaturesWithIncidentRecords("C:/data/calls_for_service_records.csv",
                                           "calls_for_service_features",
                                           "COORDINATES",
                                           "Longitude",
                                           "Latitude",
                                           4326)

Ejemplo 2 de UpdateFeaturesWithIncidentRecords (script independiente)

La siguiente ventana de comandos independiente es un ejemplo de cómo utilizar la función UpdateFeaturesWithIncidentRecords en un script:

# Name: UpdateFeaturesWithIncidentRecords.py
# Description: Update the calls for service feature class with new updates from the records management system (RMS).

# Import script modules
import arcpy

# Set the workspace
arcpy.env.workspace = r"C:/data/city_pd.gdb"

# Address Field Pairs formatted as ["Locator Address Field Name", "Input Field Name"]
address_field_pairs = [
        ["Address", "locdesc"],
        ["Address2", ""],
        ["Address3", ""],
        ["Neighborhood", ""],
        ["City", "municipality"],
        ["Subregion", ""],
        ["Region", "state"],
        ["Postal", "zip5"],
        ["PostalExt", ""],
        ["CountryCode", ""]
    ]

arcpy.ca.UpdateFeaturesWithIncidentRecords("C:/data/calls_for_service_records.csv",
                                           "calls_for_service_features",
                                           location_type="ADDRESSES",
                                           address_locator="https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer/ArcGIS World Geocoding Service",
                                           address_type="MULTI_FIELD_ADDRESS",
                                           address_fields=address_field_pairs,
                                           update_target="UPDATE",
                                           match_fields=[["callid", "callid"]],
                                           update_matching="UPSERT",
                                           update_geometry="UPDATE_GEOMETRY",
                                           field_matching_type="AUTOMATIC")

Entornos

Espacio de trabajo actual

Información de licenciamiento

Basic: Sí
Standard: Sí
Avanzado: Sí

Actualizar entidades con registros de incidentes (Herramientas de análisis de la criminalidad y de seguridad)

Resumen

Uso

Sugerencia:

Parámetros

Nota:

Nota:

Salida derivada

Entornos

Información de licenciamiento

Temas relacionados