Configure event replacement

Available with Location Referencing license.

When performing pipeline maintenance, sometimes a section of a pipe is taken out of the ground and is replaced by a new pipe. This process is known as pipe replacement.

During pipe replacement, events on an edited section of a route can be left as is, retired, or retired and replaced according to an event replacement configuration.

Event layers must be categorized on the Configure Replace Events dialog box before event replacement. The measures for the route do not change during event replacement.

Event replacement scenario

The configuration of event replacement requires categorizing the events in the feature service into three categories: As Is, Retire, and Retire and Replace.

Tip:

Point events can only be categorized using Retire.

Before event replacement

The following diagram illustrates a pipeline section before replacement:

Pipeline events before replacement are shown.

Before replacement, the pipe section has eight events, three point events (events 1-3) and five linear events (events 4-8).

Table 1: Event table before replacement

Event layer	Event ID	From Measure	To Measure	Value	From Date	To Date
Event 1	1A	1	N/A	GGG	1/1/2000	Null
Event 2	2A	2	N/A	SSS	1/1/2000	Null
Event 3	3A	3	N/A	HHH	1/1/2000	Null
Event 4	4A	0	10	XXX	1/1/2000	Null
Event 5	5A	0	10	YYY	1/1/2000	Null
Event 6	6A	0	10	ZZZ	1/1/2000	Null
Event 7	7A	0	10	QQQ	1/1/2000	Null
Event 8	8A	0	10	WWW	1/1/2000	Null

A pipe with measures from 0 to 10 exists. Various line and point events are present in the pipe as shown above.

During inspection, it was determined that a section of the pipe between the measures 0 and 5 needs to be replaced on 12/31/2017, as shown below.

The section of the pipe to be replaced and affected events are shown.

The events are placed in the following event replacement categories:

Table 2: Event replacement categories

Retire	Retire and replace	Keep as is
Event 2	Event 5	Event 1
Event 3	Event 8	Event 7
Event 4
Event 6

After event replacement

The results of replacing the pipe and events are shown in the following diagram and in Table 3:

Event replacement on a new pipe section is shown.

Table 3: After event replacement

Event layer	Event ID	From Measure	To Measure	Value	From Date	To Date	Case
Event 1	1A	1		GGG	1/1/2000	Null	A
Event 2	2A	2		SSS	1/1/2000	12/31/2017	B
Event 3	3A	3		HHH	1/1/2000	12/31/2017	C
Event 4	4A	0	10	XXX	1/1/2000	12/31/2017	D
Event 4	4B	5	10	XXX	12/31/2017	Null	E
Event 5	5A	0	10	YYY	1/1/2000	12/31/2017	F
Event 5	5B	5	10	YYY	12/31/2017	Null	G
Event 5	5C	0	5	YYYOO	12/31/2017	Null	H
Event 6	6A	0	10	ZZZ	1/1/2000	12/31/2017	I
Event 6	6B	5	10	ZZZ	12/31/2017	Null	J
Event 7	7A	0	10	QQQ	1/1/2000	Null	K
Event 8	8A	0	10	WWW	1/1/2000	12/31/2017	L
Event 8	8B	5	10	WWW	12/31/2017	Null	M
Event 8	8C	0	5	WWWOO	12/31/2017	Null	N

Table 4: Explanation of event replacement

Case	Event layer	Explanation
A	Event 1	The event is left as is.
B	Event 2	The event is retired because it was in the Retire category.
C	Event 3	The event is retired because it was in the retire category.
D	Event 4	The entire event is retired because it was in the retire category.
E	Event 4	A new event is created for the existing section of the pipe, keeping the attribute values of the original event.
F	Event 5	The entire event is retired because it was in the Retire and Replace category.
G	Event 5	A new event is created for the existing section of the pipe, keeping the attribute values of the original event.
H	Event 5	A new event is created for the new section of the pipe with the new dates and attributes provided in the Replace Events pane.
I	Event 6	The entire event is retired because it was in the Retire category.
J	Event 6	A new event is created for the existing section of the pipe, keeping the attribute values of the original event.
K	Event 7	The event is left as is.
L	Event 8	The entire event is retired because it was in the Retire and Replace category.
M	Event 8	A new event is created for the existing section of the pipe, keeping the attribute values of the original event.
N	Event 8	A new event is created for the new section of the pipe with the new dates and attributes provided in the Replace Events pane.

Categorize events

Complete the following steps to configure event replacement:

1. In ArcGIS Pro, open the map that contains the feature service in which events will be retired or replaced.
2. On the Location Referencing tab, in the Events group, click Configure Replacement .

   The Configure Replace Events dialog box appears.

   If no event replacement configuration exists, the Create New Replace Events dialog box appears on top of the Configure Replace Events dialog box where you can create a named configuration.

   

   Tip:

   All the line events and point events available in the map feature service are listed in the Event Layers list.

   

3. Press the Shift key and click to select a range of events, or press the Ctrl key and click to select events out of order; then drag multiple line events from the Event Layers list to the Retire Events list.

   

   You can also use the arrow buttons on the dialog box to move selected layers between the Event Layers list and other lists or to move line event layers up and down between the Retire Events and Retire and Replace Events lists.

   Tip:

   Click Reset to set the configuration to its original or last saved state.

   Event layers that remain in the Event Layers list are left as is when event replacement is run.

   

4. Press the Shift key and click to select a range of events, or press the Ctrl key and click to select events out of order; then drag multiple line events from the Event Layers list to the Retire and Replace Events list.

   Tip:

   Only line events can be retired and replaced.

   

   Note:

   If no events are configured to retire or to retire and replace, you can't save the configuration.

5. Optionally, click the arrow for any event layer in the Retire and Replace Events list to expand it.

   An expanded list of editable event layer fields appears. Uncheck a check box to exclude it from the event replacement.

   If default attribute values are configured, they are shown. Default values can be overwritten when using the Replace Events pane for event replacement.

   

   Note:

   Some attribute fields are required attribute fields . A required attribute field is a nonnullable field with no default value. The check box for a required attribute field cannot be unchecked.

6. Click Save to save the event replacement configuration.

   Note:

   The event replacement configuration is saved to a folder at the path specified for Replace Events Folder Location. This folder location is the same as the active project's ArcGIS Pro project folder by default.

   You can set Location Referencing options using the Location Referencing tab on Options dialog box.

   If an .lrer file by the specified name doesn’t already exist, it is created using the name provided on the Create New Replace Events dialog box.

7. Optionally, click Save As to save the configuration to an .lrer file using a different name or location.

   Share the saved event replacement configuration file so that others can place it at the location specified for Replace Events Folder Location .

   To delete a replace events configuration, delete it from the folder location specified for Replace Events Folder Location.

8. Optionally, click Set As Default to make this event replacement configuration the default for the project.
9. Click Close to close the Configure Replace Events dialog box.