Configuring event replacement—Event Editor for Pipeline Referencing

Available with Location Referencing license.

While 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 the pipe replacement, the events that were part of the replaced pipe can be left as is, retired, or retired and replaced using the Event Replacement widget. The measures for the route do not change. For example, the following diagram illustrates a pipeline section before replacement:

Pipe before replacement — Pipeline events before replacement are shown.

Table 1: Event table before replacement


Event layer	Event ID	From measure	To measure	Value	From date	To date
Event 1	1A	1		GGG	1/1/2000	Null
Event 2	2A	2		SSS	1/1/2000	Null
Event 3	3A	3		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 a from measure of 0 and a to measure of 10 exists. Various line and point events are present in the pipe as shown above.

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

Section of the pipe to be replaced — 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

The results of replacing the pipe and replacing the events are shown in Table 3.

Event replacement in pipeline — 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	1/1/2000	Null	E
Event 5	5A	0	10	YYY	1/1/2000	12/31/2017	F
Event 5	5B	5	10	YYY	1/1/2000	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	1/1/2000	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	1/1/2000	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 whole 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 dates and attribute values of the old event.
F	Event 5	The whole 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 dates and attributes of the old 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 Event Replacement widget.
I	Event 6	The whole 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 dates and attribute values of the old event.
K	Event 7	The event is left as is.
L	Event 8	The whole 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 dates and attribute values of the old event.
N	Event 8	A new event gets created for the new section of the pipe with the new dates and attributes provided in the Event Replacement widget.

The workflow for event replacement in Event Editor involves the following two stages:

Configuring event replacement using the Configure Event Replacement widget
Replacing events using the Event Replacement widget

Categorizing events

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

To configure event replacement, complete the following steps:

Open Event Editor and, if prompted, sign in to Portal for ArcGIS or ArcGIS Online.
Click the Edit tab.
In the Edit Events group, click the Configure Event Replacement button .
The Configure Event Replacement widget appears.
Note:
All the line events and point events available in the map service are listed in the Available Event Layers list.
Opening the Configure Event Replacement widget
Tip:
If a default configuration has been created, click Default to load it. Click Reset to return to the last saved configuration in the map service.
Click Shift or Ctrl and click and drag multiple line events from the Available Event Layers list to the Retire Events list.
Choosing events for retirement
You can also choose event categories and use the arrow keys to move selected line events into the lists from left to right or up and down between the Retire Events and Retire and Replace Events lists.
Events placed in the Retire Events list will be retired when events in the category are replaced using the Event Replacement widget.
Choosing events for retirement and replacement
Click Shift or Ctrl and click and drag multiple line events from the Available Event Layers list to the Retire and Replace Events list.
Note:
Only line events can be retired and replaced.
Event replacement configured
Note:
Event layers left in the Available Event Layers list are left as is. If no events are configured to retire or to retire and replace, you'll be unable to save using the Event Replacement widget.
Optionally click the arrow for any event layer in the Retire and Replace Events list to expand it.
An expanded list of fields in the event layer appears.
Expanded event layer fields
You can use these check boxes to show or hide the fields when performing the event replacement operation.
Note:
Some attribute fields are required fields, which is denoted by the asterisk (*) symbol. A required field is a nonnullable field with no default value. Visibility can't be changed for required fields.
Click Save to save the event replacement configuration.
Click Export to export the configuration to an LRER file. Give the configuration file a name such as eventplacement1.lrer.
Note:
The event replacement configuration is saved in the local browser’s download folder.
Copy the exported file to the Event Editor folder.
Open the configuration file (config.json) in a text editor such as Notepad.
For more information, see Configuring the Event Editor web app.
Type the LRER file name with the file extension in the eventReplacement section:
Note:
The Default button defaults to the event replacement configuration provided in the Event Editor configuration file.
The Reset button restores the last saved event replacement configuration for that browser.
You can edit the default event replacement configuration and use it in your browser.