Skip to main content

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 RouteName configurado, los eventos se pueden incorporar usando dicho campo.

    • Si los registros de Evento de entrada tienen campos RouteID nulos, pero campos RouteName rellenados, los eventos se pueden incorporar usando el campo RouteName. A continuación, los campos RouteID se generan automáticamente para esos eventos incorporados.

    • Si los registros de Evento de entrada tienen los campos RouteID y RouteName rellenados, los eventos se incorporarán usando el campo RouteID.

  • La asignación de los campos FromDate y ToDate es opcional para la opción Agregar del parámetro Tipo de carga. Se admiten los siguientes escenarios:

    • Si los campos FromDate y ToDate no 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 FromDate está asignado y el campo ToDate no está asignado, el evento incorporado tendrá un valor nulo para su fecha de finalización.

    • Si el campo FromDate no está asignado, pero el campo ToDate sí 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 campos FromDate y ToDate, 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 EventID en el parámetro Asignar campo o asegúrese de que haya valores nulos en el campo EventID del evento de entrada. Si se rellena el campo EventID de un registro de evento de origen y se activa el parámetro Generar GUID de Id. de evento para eventos cargados, el valor del campo EventID del 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 .csv con 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 .csv para inicializar

    • Un 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 .csv que 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.

  • AgregarLos registros del evento de origen se incorporarán al evento de destino especificado.

  • Retirar superposicionesLos registros del evento de origen se incorporarán al evento de destino especificado y se eliminarán todos los registros que tengan la misma medición o superposición temporal que los eventos incorporados. Si el evento incorporado eclipsa el registro del evento de destino especificado, este se eliminará. Use esta opción solamente para eventos de línea.

  • Retirar por Id. de eventoLos registros del evento de origen se incorporarán al evento de destino especificado y se eliminarán todos los registros que tengan el mismo Id. de evento y superposición temporal que los eventos incorporados. Si el evento adjunto eclipsa un registro de evento de destino que tiene el mismo Id. de evento, se eliminará el registro de evento de destino.

  • Reemplazar por Id. de eventoLos registros de evento de origen se incorporarán al evento de destino especificado y se reemplazarán todos los registros que tengan el mismo Id. de evento que los eventos incorporados.

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 Event ID.

  • ActivadoSe generarán Id. de evento para los registros de evento de origen que se van a incorporar.

  • DesactivadoNo se generarán Id. de evento para los registros de evento de origen que se van a incorporar. Esta es la opción predeterminada.

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.

  • ActivadoLos registros de evento de origen se incorporarán a las rutas dominantes.

  • DesactivadoLos registros de evento de origen se incorporarán a las rutas especificadas en el dataset de entrada, independientemente del predominio de ruta. Esta es la opción predeterminada.

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.

  • ActivadoLos eventos se incorporarán incluso si hay bloqueos para evitar conflictos.

  • DesactivadoLos eventos no se incorporarán cuando haya bloqueos para evitar conflictos. Esta es la opción predeterminada.

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

Espacio de trabajo actual

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)