Incorporar eventos (Herramientas de Referenciación de ubicación)
Resumen
Incorpora registros de eventos desde una tabla, capa o clase de entidad a una clase de entidad de evento LRS existente.
Nota:
Cuando la capa de destino sea una capa de servicio de entidades, los resultados de validación se escribirán en un archivo del directorio de ArcGIS Server. De forma predeterminada, este archivo se depurará automáticamente después de 10 minutos, lo que puede no ser suficiente para procesar todas las validaciones y escribirlas en la estación de trabajo que ejecuta ArcGIS Pro. Para cargas de datos mayores, se recomienda ajustar la antigüedad máxima de los archivos a al menos una hora. Puede editar un directorio del servidor en ArcGIS Server Manager para ajustar esta configuración.
Uso
Se necesita un dataset LRS para ejecutar esta herramienta.
El valor del parámetro Evento de entrada puede ser una tabla, capa o clase de entidad.
El valor del parámetro Evento de destino debe ser una capa o clase de entidad registrada con un LRS.
Se ignorarán los conjuntos de selección y las consultas de definición sobre el valor del parámetro Evento de destino.
Esta herramienta admite entidades de punto y línea. El tipo de entidad de los parámetros Evento de entrada y Evento de destino debe coincidir.
Cuando se incorporan nuevos eventos usando la opción Agregar para el parámetro Tipo de carga, si el valor de Evento de destino tiene un campo
RouteNameconfigurado, los eventos se pueden incorporar usando dicho campo.Si los registros de Evento de entrada tienen campos
RouteIDnulos, pero camposRouteNamerellenados, los eventos se pueden incorporar usando el campoRouteName. A continuación, los camposRouteIDse generan automáticamente para esos eventos incorporados.Si los registros de Evento de entrada tienen los campos
RouteIDyRouteNamerellenados, los eventos se incorporarán usando el campoRouteID.
La asignación de los campos
FromDateyToDatees opcional para la opción Agregar del parámetro Tipo de carga. Se admiten los siguientes escenarios:Si los campos
FromDateyToDateno están asignados, el evento incorporado tendrá la misma fecha de inicio que el intervalo de tiempo activo de la ruta y la fecha de finalización tendrá un valor nulo.Si el campo
FromDateestá asignado y el campoToDateno está asignado, el evento incorporado tendrá un valor nulo para su fecha de finalización.Si el campo
FromDateno está asignado, pero el campoToDatesí lo está, la herramienta devolverá un error.Para los eventos de línea continua, la herramienta identifica primero el intervalo de tiempo más reciente en todas las rutas que comparten el mismo Id. de línea. A continuación, la fecha de inicio del intervalo de tiempo más reciente de la ruta se asignará como fecha de inicio del evento incorporado y la fecha de finalización tendrá un valor nulo.
Nota:
Si no asigna el campo
ToDate, o los camposFromDateyToDate, el campo o campos se deben eliminar de la lista de campos en el parámetro Mapa de campo.Si el parámetro Generar GUID de Id. de evento para eventos cargados está activado, no asigne el campo
EventIDen el parámetro Asignar campo o asegúrese de que haya valores nulos en el campoEventIDdel evento de entrada. Si se rellena el campoEventIDde un registro de evento de origen y se activa el parámetro Generar GUID de Id. de evento para eventos cargados, el valor del campoEventIDdel registro de evento de origen se cargará en el evento de destino.Si el parámetro Incorporar eventos a las rutas dominantes está activado, los registros del valor del parámetro Evento de entrada se incorporarán a las rutas dominantes donde existan concurrencias de ruta. Si existen varias concurrencias a lo largo de la ruta, los registros de Evento de entrada se dividirán y se incorporarán a la ruta dominante para cada sección de ruta concurrente. Si no existe concurrencia de rutas, los registros del valor del parámetro Evento de entrada se incorporarán igualmente a las rutas especificadas en el dataset de entrada.
- La herramienta proporcionará un archivo de texto con registros de eventos que difieren de las rutas especificadas en el dataset de entrada y se incorporan a las rutas dominantes.
Esta herramienta es compatible con la prevención de conflictos y tratará de adquirir y transferir los bloqueos.
Cuando la prevención de conflictos está habilitada, se admiten las siguientes características:
Los eventos que se deben incorporar adquirirán automáticamente bloqueos de evento si están disponibles. Si no se pueden adquirir los bloqueos, la herramienta devolverá un error y proporcionará un archivo de texto de bloqueos conflictivos.
Cuando el parámetro Incorporar eventos a rutas dominantes está activado, los bloqueos de evento se comparan solo con las rutas de destino, que son las rutas más dominantes a las que se incorporarán los eventos. Si no se pueden adquirir los bloqueos de las rutas de destino, la herramienta devolverá un error y proporcionará un archivo de texto de bloqueos conflictivos.
Si se marca el parámetro Incorporar incluso si existen bloqueos de prevención de conflictos, se omitirán los bloqueos existentes y no se adquirirán nuevos bloqueos como resultado de la ejecución de esta herramienta.
Precaución:
Omitir los bloqueos de prevención de conflictos puede provocar la corrupción de datos o un comportamiento inesperado. Considere las posibles consecuencias y cree siempre una copia de seguridad de la base de datos antes de ejecutar esta herramienta con el parámetro Incorporar incluso si existen bloqueos de prevención de conflictos activado.
Al trabajar en la versión predeterminada, los bloqueos adquiridos se liberan automáticamente al finalizar la herramienta.
Mientras trabaja en una versión con nombre, los bloqueos adquiridos permanecerán en el estado En publicación al finalizar la herramienta. Debe publicar o eliminar la versión para liberar los bloqueos.
Al trabajar en una versión con nombre, si se cancela el proceso de la herramienta, los bloqueos adquiridos permanecerán en estado liberable.
La calibración de ruta en rutas con huecos físicos afecta a los eventos incorporados como se indica a continuación:
Si la diferencia de calibración de ruta a lo largo del hueco no es cero, los eventos incorporados se dividirán en huecos.
Si la diferencia de calibración de la ruta a lo largo del hueco es cero, los eventos incorporados serán eventos multiparte.
Puede emplear un archivo
.csvcon formato ASCII para incorporar eventos cuando lo utilice con un archivo de inicialización (schema.ini) que defina los campos separados por comas en el archivo.csv. El archivo de inicialización del esquema debe incluir lo siguiente:El formato y nombre de archivo
.csvpara inicializarUn nombre y tipo de datos para cada columna
Un ancho máximo que se debe utilizar si el tipo de datos es Texto
En el siguiente ejemplo de archivo de inicialización se indica el nombre y el formato de archivo
.csvque se van a utilizar, el nombre de campo y el tipo de datos que se deben usar en cada columna (de izquierda a derecha) y un ancho máximo para los campos de texto:schema.ini
<!--```other [source_events.csv] Format=CSVDelimited ColNameHeader=True Col1=FromDate Date Col2=ToDate Date Col3=RouteID Text width 255 Col4=RouteName Text width 255 Col5=FromMeasure Double Col6=ToMeasure Double Col7=RdType Long Col8=EventID Text width 50
[Más información sobre cómo agregar una tabla de archivo de texto o ASCII](../../help/data/tables/add-an-ascii-or-text-file-table.md) > [!LEGACY] > El parámetro **Generar formas** ya no es compatible.
Parámetros
| Etiqueta | Explicación | Tipo de datos |
|---|---|---|
|
Evento de entrada |
Los registros de evento de origen que se incorporarán. |
Table View |
|
Evento de destino |
La clase de entidad o la capa de eventos LRS a la que se incorporarán los registros de eventos de origen. |
Feature Layer |
|
Mapa de campo |
Controla cómo se transfiere la información de los atributos de los campos del evento de entrada al evento de destino. Dado que los registros de evento de origen se incorporarán a un evento de destino existente que tiene un esquema predefinido (definiciones de campo), no es posible agregar ni eliminar campos del evento de destino. Aunque puede establecer reglas de fusión para cada campo de salida, la herramienta ignora esas reglas. |
Field Mappings |
|
Tipo de carga (Opcional) |
Especifica cómo se cargarán los eventos incorporados en el evento de destino.
|
String |
|
Generar GUID de Id. de evento para eventos cargados (Opcional) |
Especifica si se generarán Id. de evento para los registros de evento de origen que se van a incorporar. La generación de Id. de eventos solo se aplicará a los registros de evento de origen con un valor nulo en el campo
|
Boolean |
|
Generar formas (Opcional) |
Nota:Este parámetro ya no es compatible. |
Boolean |
|
Incorporar eventos a las rutas dominantes (Opcional) |
Especifica si los registros de evento de origen se incorporarán a las rutas dominantes si existe concurrencia de rutas. Este parámetro funciona con todas las opciones de Tipo de carga: Agregar, Retirar superposiciones, Retirar por Id. de evento y Reemplazar por Id. de evento.
|
Boolean |
|
Incorporar incluso si existen bloqueos de prevención de conflictos (Opcional) |
Especifica si los eventos se incorporarán incluso si hay bloqueos para evitar conflictos. Este parámetro solo está disponible cuando la prevención de conflictos está deshabilitada en el dataset de LRS. Precaución:Omitir los bloqueos de prevención de conflictos puede provocar la corrupción de datos o un comportamiento inesperado. Considere las posibles consecuencias y cree una copia de seguridad de la base de datos antes de ejecutar la herramienta con este parámetro marcado.
|
Boolean |
Salida derivada
| Etiqueta | Explicación | Tipo de datos |
|---|---|---|
|
Evento de destino de salida |
La capa de eventos o clase de entidad a la que se incorporan los registros de evento de origen. |
Feature Layer |
|
Archivo de resultados de salida |
Archivo de texto que detalla los cambios realizados por la herramienta. |
Text File |
Entornos
Información de licenciamiento
- Basic: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)
- Standard: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)
- Avanzado: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)