Event editing using feature edits

Available with Location Referencing license.

You can edit an event feature in a feature service event layer using the Edit Vertices tool Edit Vertices.

Using this method, you can edit an existing event shape. The event’s route ID, route name, and measures are updated accordingly. The event’s dates do not change.

Note:

When an event is moved from one route to another route, the event's time slice is based on the route's start and end dates.

Learn more about editing features using standard editing tools in ArcGIS Pro

Note:

If a message regarding acquiring locks or reconciling appears, conflict prevention is enabled.

Note:

After editing an event’s vertices, you can retire the existing event and create a new event with a start date (From Date) as of the specified retire date including the edited vertices. You can also merge any coincident line events. For more information, refer to the event editing options under Location Referencing options in ArcGIS Pro.

Location errors

The Location Error value in the attribute field provides information about the status of the event. When an event is edited correctly, the No Error value occurs for the location error attribute field of the event. If the status is anything other than No Error, inspect the modified event and its attributes for issues and resolve them.

Note:

You can also review a complete list of location errors.

Any of the following statuses indicate a problem that must be resolved.

Location errorDescription

Different From Route And To Route Line IDs

The starting route and the ending route have different line IDs. This is applicable to events associated with line networks.

Invalid Location Route ID

The route location's route ID is invalid (NULL, empty, or invalid value).

Invalid Location Measure

At least one of the route location's measure values is invalid.

Invalid Route ID

The route location's route ID is invalid (NULL, empty, or invalid value).

Reversed Line Order

The starting route does not have a lower line order than the ending route. This is applicable to line networks.

Route Not Found

The route does not exist (this could be due to the route not existing in the network or the route and event having different time ranges that do not overlap).

Scenarios for editing line events using feature edits

The scenarios below detail the results of editing event features using the Edit Vertices tool Edit Vertices.

Edit a line event

The following diagram shows the route and its associated event. Route1 has measures from 0 to 20, and Event1 has measures from 0 to 10.

Before editing Event1 on Route1

The following table details the route attributes:

Route IDFrom DateTo Date

Route1

1/1/2000

<Null>

The following table details the event before editing:

Route IDFrom DateTo DateFrom MeasureTo MeasureLocation ErrorMAOP Design

Route1

1/1/2005

<Null>

0

10

No Error

800

To edit the event so that it runs from 0 to 20, where the intersection with Route2 is located, drag the last vertex of the event to the intersection using the Edit Vertices tool Edit Vertices. The first vertex is used as the starting measure, and the last vertex is used as the ending measure.

Event1 after selection

The following diagram shows the event after editing:

After editing line event on Route1

The following table details the event after editing:

Route IDFrom DateTo DateFrom MeasureTo MeasureLocation ErrorMAOP Design

Route1

1/1/2005

<Null>

0

20

No Error

800

Edit a line event resulting in a location error

The following diagram shows the route and its associated event. Route1 has measures from 0 to 20, and Event1 has measures from 0 to 15.

Nonspanning event on Route1 before being moved to Route2

The following table details the route attributes:

Route IDFrom DateTo Date

Route1

1/1/2000

<Null>

The following table details the event before editing. Event1 on Route1 has measures from 0 to 15.

Event IDRoute IDFrom DateTo DateFrom MeasureTo MeasureLocation ErrorMAOP Design

Event1

Route1

1/1/2000

<Null>

0

15

No Error

800

During the edit, Event1 is dragged beyond the intersection and beyond the end of Route1. In this case, the event's shape remains intact and a location error occurs.

Event1 after dragging the last vertex to a new location

The following table details Event1. Since the event's end measure cannot be located, a location error occurs.

Event IDRoute IDFrom DateTo DateFrom MeasureTo MeasureLocation ErrorMAOP Design

Event1

Route1

1/1/2000

<Null>

0

<Null>

Invalid Location Route ID

800

The following diagram shows the route after relocating the end vertex of the line event (Event1) on Route1:

Nonspanning event on Route1 after being moved to Route2

Scenarios for editing spanning events using feature edits

The scenarios below detail the results of editing a spanning line event using the Edit Vertices tool Edit Vertices.

Edit a spanning event

The following diagram shows the routes and their associated event. Route1 and Route2 are on LineA.

Before editing a line event that spans routes

The following table details the route attributes:

Route IDFrom DateTo Date

Route1

1/1/2000

<Null>

Route2

1/1/2000

<Null>

The following table details the event before editing:

Event IDFrom Route IDTo Route IDFrom DateTo DateFrom MeasureTo MeasureLocation ErrorMAOP Design

Event1

Route1

Route2

1/1/2000

<Null>

5

20

No Error

800

In this case, the event is edited so that the start vertex of the event is snapped to measure 0 on Route1, and the end vertex of the event is snapped to end measure 25 of Route2.

Event1 after dragging the first and last vertex to new locations

The following table details the event after editing:

EventFrom Route IDTo Route IDFrom DateTo DateFrom MeasureTo MeasureLocation ErrorMAOP Design

Event1

Route1

Route2

1/1/2000

<Null>

0

25

No Error

800

The following diagram shows the route and its associated event after the edit:

After editing a spanning line event resulting in no error

Edit a spanning event resulting in a location error

The following diagram shows the routes and their associated event. Route1 and Route2 are on LineA, and RouteX1 is on LineB. Event1 spans from measure 5 on Route1 to measure 20 on Route2.

Before editing a line event that spans routes

The following table details the route attributes. RouteX1 is located on LineB.

Route IDFrom DateTo Date

Route1

1/1/2000

<Null>

Route2

1/1/2000

<Null>

RouteX1

1/1/2000

<Null>

The following table details the event before editing:

Event IDFrom Route IDTo Route IDFrom DateTo DateFrom MeasureTo MeasureLocation ErrorMAOP Design

Event1

Route1

Route2

1/1/2000

<Null>

5

20

No Error

800

In the following diagram, the event is edited so that the last vertex of the event is snapped to measure 35 of RouteX1, which is on a different line (LineB).

Event1 after dragging the first and last vertex to new locations

The following table details Event1 after editing. Because the event's ending measure cannot be located on the same line, the event is drawn only up to the end of Route2 on LineA and a location error describing the issue is provided.

EventFrom Route IDTo Route IDFrom DateTo DateFrom MeasureTo MeasureLocation ErrorMAOP Design

Event1

Route1

RouteX1

1/1/2000

<Null>

5

35

Different From-Route and To-Route Line IDs

800

The following diagram shows Event1 after the error. The event is generated without the LineB segment.

After editing a line event on a spanning route resulting in an error

Referent offset when using feature edits

The Pipeline Referencing events data model supports the configuration of referent event fields and their enablement using the Enable Referent Fields tool. Once referent fields are configured and enabled in a layer, referent locations are populated and persisted in that layer when events are added or edited.

When a line event is edited using feature edits in a referent-enabled layer, the parent LRS Network is used as the FromRefMethod and ToRefMethod values by default, and the route is used as the FromRefLocation and ToRefLocation values. The start and end measures of the line event are used as the FromRefOffset and ToRefOffset values.

If either measure of a line event is updated, the corresponding offset value updates to reflect the new measure.

The example below demonstrates the impact of editing events that have user-configured referent values enabled in the event layer.

Before editing with referents

The following diagram shows the route and its associated events:

Before editing events with specified measures that override referents

The following table provides details about the event referent fields before the edit:

FromRefMethodFromRefLocationFromRefOffsetToRefMethodToRefLocationTo Ref Offset

PointEventLayer1

Point1

5

PointEventLayer1

Point1

15

The following table provides details about the default event fields before the edit:

Event IDRoute IDFrom DateTo DateFrom MeasureTo Measure

Event1

Route1

1/1/2000

<Null>

10

20

After editing with referents

The following diagram shows the route and its associated events:

After editing events with referents honored

When applying feature edits to an event record that has user-configured referent fields, the FromRefMethod and ToRefMethod values revert to the parent LRS Network, and the FromRefLocation and ToRefLocation values revert to the route.

The following table provides details about the event referent fields after event editing:

FromRefMethodFromRefLocationFromRefOffsetToRefMethodToRefLocationTo Ref Offset

PipeSeriesNetwork

Route1

5

PipeSeriesNetwork

Route1

15

The following table provides details about the default event fields after the edit:

Event IDRoute IDFrom DateTo DateFrom MeasureTo Measure

Event1

Route1

1/1/2000

<Null>

5

15