The Add Line Event widget allows you to create line events along routes in a Linear Referencing System (LRS). You can use the widget to manage pipeline data with ArcGIS Pipeline Referencing and roadways data with ArcGIS Roads and Highways. You can represent characteristics of a route, such as operating pressure for a pipeline or lane information for a road, as line events.
Examples for Pipeline Referencing
Use this widget to support app design requirements such as the following:
- You are a pipeline inspector and want to add inspection notes information for a pipe that is under maintenance.
- You want to add a new event feature and retire the overlapping section of a previous feature.
- You want to add operating pressure and DOT class information in one editing session.
Examples for Roads and Highways
Use this widget to support app design requirements such as the following:
- You want to add lane information for a freeway.
- You want to add a new median to a route and retire the overlapping section of the previous median.
- You want to add parking and access control information in one editing session.
Usage notes
This widget requires connection to a Map widget. To add line events, the Map widget must be connected to a web map data source published with an LRS with the Linear Referencing capability enabled. To view versions other than the default version, the web map data source must be published with an LRS with the Version Management capability enabled.
To create an LRS and publish a feature service with the Linear Referencing and Version Management capabilities enabled, follow the steps in the ArcGIS Pro documentation:
- Pipeline Referencing—Create an LRS and share an LRS as web layers
- Roads and Highways—Create an LRS and share an LRS as web layers
To use the Add Line Event widget with linear referencing services published with ArcGIS Enterprise, you must be signed in with an ArcGIS Enterprise account.
When you include this widget in an app, a panel provides users with the following options for adding a line event:
- Type—Choose to add single or multiple line events.
- Single Line—Add a single line event.
- Multiple Line—Add multiple line events in one edit activity.
- Event (appears when you choose Single Line under Type)—Choose the event layer from which to add a line event.
- Network—This label lists the network layer that is used to add line events.
- Attribute Set (appears when you choose Multiple Line under Type)—If a layer is configured with attribute sets for Pipeline Referencing or attribute sets for Roads and Highways, you can choose one from the drop-down menu. The widget only displays line events that are part of the attribute set. Attribute sets are collections of event layer attributes. You can use attribute sets to create multiple events with a set of additional, organization-specific attributes in a single edit.
- From Method—This label lists the method the widget uses to define the point on the route where the line event starts.
- From Route Name—Provide the name of the route you want to use to define the line event starting point.
- From Measure—Provide a measure value for the line event starting point. The measure value defines the exact location on the route where the line event starts. The label for this setting also displays the unit of measure defined by the network layer. For example, if the unit of measure is meters, at run time this setting is labeled From Measure (Meters).
- To Method—This label lists the method the widget uses to define the point where the line event ends.
- To Route Name—Provide the name of the route you want to use to define the line event ending point. This option is only available when either the chosen event layer is a spanning line event or the chosen attribute set includes a spanning line event layer.
- To Measure—Provide a measure value for the line event ending point. The measure value defines the exact location on the route where the line event starts. The label for this setting also displays the unit of measure defined by the network layer. For example, if the unit of measure is meters, at run time this setting is labeled To Measure (Meters).
- Start Date—Specify the start date of the event or events.
- End Date—Specify the end date of the event or events.
- Merge coincident events—Merge the new events with any existing attribute-exact events that overlap with the new events.
- Retire overlapping events—Retire existing events that overlap with the new events.
Settings
The Add Line Event widget includes the following settings:
- Select Map—Select a Map widget.
- Load Layers—Load layers from the web maps in the connected Map widget. To load layers, the Map widget must be connected to a web map with LRS layers.
- Clear Layers—Remove all loaded layers from the widget.
- Layer Configuration—Click a layer to open the Layer Configuration panel.
- Label—Provide a meaningful label for the layer. This label appears in the widget panel at run time.
- Use Field Alias—Turn on this setting to display field aliases at run time. An alias, or display name, is an alternative name for a field. It is usually a more user-friendly description of the content of the field. Unlike true field names, aliases do not have to adhere to the limitations of the database, so they can contain special characters such as spaces.
- Configure Fields—Choose which attribute fields from the layer to include in the widget panel at run time. You can define whether each attribute field is editable at run time by clicking Editable or Not editable.
- Default Settings—Configure the default settings that you want available in the widget when it first loads.
- Event (Single Line)—Choose the default event layer for adding a single line event.
- Network (Multiple Line)—Choose the default network layer for adding multiple line events. When the user is adding a single line event, the network is always the registered network for the selected event layer.
- From Method—Choose the default method for how the widget defines the line event starting point.
- To Method—Choose the default method for how the widget defines the line event ending point.
For both From Method and To Method options, you can choose the following method:
- Route and measure—The widget specifies locations using the route name and measure value that the user provides.
- Type—Choose whether the widget is set to add single events or multiple events.
- Attribute Set—If a layer is configured with attribute sets for Pipeline Referencing or attribute sets for Roads and Highways, you can choose a default one from the drop-down menu. The widget only displays line events that are part of the attribute set. Attribute sets are collections of event layer attributes. You can use attribute sets to create multiple events with a set of additional, organization-specific attributes in a single edit.
- Display Settings—Choose which settings to display in the widget panel at run time. If you choose to hide a setting here, the widget settings you configure under Default Settings are unchangeable by the user at run time.
- Hide Type—Hide the Type setting from the widget panel.
- Hide Event—Hide the Event setting from the widget panel.
- Hide Network—Hide the Network setting from the widget panel.
- Hide Method—Hide the From Method and To Method settings from the widget panel.
- Hide Attribute Set—Hide the Attribute Set setting from the widget panel.
- Hide Measures—Hide the From Measure and To Measure settings from the widget panel.
Add a line event by providing a route name and measure values
Complete the following steps to add a line event.
- Start Experience Builder. Sign in to an ArcGIS Enterprise portal.
- Add a Map widget. Connect it to a web map with LRS data published with the Linear Referencing capability enabled and, optionally, the Version Management capability enabled.
- Add an Add Line Event widget. Connect it to the Map widget, then load LRS layers from the Map widget.
- Publish the app.
- Launch the app. If prompted, sign in to your ArcGIS Enterprise portal.
- Zoom to the location where you want to add a line event.
Note:
To zoom to route locations, you can use the Search By Route widget or use data actions with the Search By Route widget or Table widget. - Open the Add Line Event widget.
You can also use data actions to add line events.
- Use the default type or click the Type drop-down arrow and change the type, if necessary.
- If Type is set to Single Line, use the default line event layer or click the Event drop-down arrow and choose another line event layer.
If Type is set to Multiple Line, you can use the default attribute set or choose another attribute set.
The value that appears under Network appears based on the selected event layer.
- Specify the starting location for the line event by doing one of the following:
- Provide a route name in the From Route Name text box.
- Click the route picker
, then click a route on the map.
The From Measure value populates based on the location you click. Once you provide a starting measure value, a green dot appears at that location on the map.
- Optionally, change the starting measure value by doing one of the following:
- Provide a measure value in the From Measure text box.
Note:
Stationing measure values are also supported.
- Click the measure picker , then click a point along the route.
- Provide a measure value in the From Measure text box.
- Specify the ending location for the line event by doing one of the following:
- For events on a non-line network or non-spanning events on a line network, click the measure picker , then click the point on the route where you want the line event to end.
The To Route Name defaults to the From Route Name and cannot be changed. If you need to change the To Route Name, provide a new route name under From Route Name.
- For spanning events on a line network, accept the default name for To Route Name, or change the ending route by providing another route name in the To Route Name text box.
Alternatively, click the route picker
, then click the point on the route where you want the line event to end.Note:
The From Route and To Route values must be on the same line.
Once you provide an ending measure value, a red dot appears at that location on the map.
- For events on a non-line network or non-spanning events on a line network, click the measure picker
- Optionally, specify a new ending measure by doing one of the following:
- Provide a measure value in the To Measure text box.
Note:
Stationing measure values are also supported.
- Click the measure picker and click the measure value along the route on the map.
- Provide a measure value in the To Measure text box.
- Specify the starting date of the event by doing one of the following:
- Leave the default start date, which is the current date.
- Provide a start date in the Start Date text box.
- Click the calendar button
and choose a start date. - Check the Use route start date check box.
- Optionally, specify the ending date for the line event by doing one of the following:
- Provide an end date in the End Date text box.
- Click the calendar button and choose an end date.
- Check the Use route end date check box.
Note:
If you do not provide an end date, the event continues forever into the future.
- Choose a data validation option to prevent erroneous input while characterizing a route with line events.
- Merge coincident events—When all attribute values for a new event are exactly the same as an existing event, and if the new event is adjacent to or overlapping an existing event in terms of its measure values, and its time slices are coincident or overlapping, the new event is merged with the existing event and the measure range is expanded accordingly. For more information, refer to scenarios for merging coincident events in ArcGIS Pipeline Referencing or retire overlaps scenarios in ArcGIS Roads and Highways.
- Retire overlapping events—The measure, start date, and end date of existing events are adjusted to prevent overlaps with respect to time and measure values once the new line event or events are created. For more information, refer to retire overlaps scenarios in ArcGIS Pipeline Referencing or retire overlaps scenarios in ArcGIS Roads and Highways.
- Merge coincident events—When all attribute values for a new event are exactly the same as an existing event, and if the new event is adjacent to or overlapping an existing event in terms of its measure values, and its time slices are coincident or overlapping, the new event is merged with the existing event and the measure range is expanded accordingly. For more information, refer to scenarios for merging coincident events in ArcGIS Pipeline Referencing or retire overlaps scenarios in ArcGIS Roads and Highways.
- Click Next.
The attributes for the chosen line event layer appear in a second pane.
- Provide attribute values for the event layer.
For multiple events, an attribute set can contain events associated with different networks. Only events associated with the selected network appear.
For multiple events, use the check boxes of the event layers to include or exclude them in the edit activity. Unselected events will not be added.
For multiple events, whether an event field is visible and editable depends on the configuration of the attribute set. The event configuration for single events does not apply when adding multiple events.
You can use the Copy Attributes tool to copy attributes from an existing event.
- Click Save.
A confirmation message appears on the tool pane once the new line event is added and appears on the map.
Interaction options
You can use data actions in other widgets to launch the Add Line Event widget and populate associated values. To be able to use data actions, the network in the source widget must have associated line events, the data action options of Add Line Event in the source widget must be turned on, and the Add Line Event widget must be configured in the experience. Turn off the data action options of Add Line Event in the source widget to not use data actions.
The following widgets support data actions of the Add Line Event widget:
- LRS Identify widget—Data action populates the event or attribute set, network, route, measure, and date options.
- Search By Route widget—Data action populates the event or attribute set, network, route, measure, and date options.
- Table widget—Data action populates the event or attribute set, network, route, and date options.
Note:
You can change any values after they are populated. If you do, the Add Line Event widget still validates all entries.
Run data actions with the Search By Route widget
To use the data action at run time with the Search By Route widget, complete the following steps:
- Select a result record in the Search By Route results.
- Click the Action button at the top of the Search By Route widget panel.
- Add a line event by doing one of the following:
- Click Add Line Event, provide an ending measure value in the To Measure option, and attributes for the new line event.
The Event, Network, From Route ID or From Route Name, From Measure, To Route ID or To Route Name, Start Date, and End Date parameters populate based on the selected route from the Search By Route widget.
- If the searched result contains a route with two measure values, click Add Line Event.
The Event, Network, From Route ID or From Route Name, From Measure, To Measure, To Route ID or To Route Name, Start Date, and End Date parameters populate based on the selected route from the Search By Route widget.
- If the searched result contains a route with a single measure value, choose Add Line Event (from) to be the starting measure or Add Line Event (to) to be the ending measure of the line event to be added.
If you chose Add Line Event (from), the From Measure value populates and you must provide a To Measure value.
If you chose Add Line Event (to), the To Measure value populates and you must provide a From Measure value.
The Event, Network, From Route ID or From Route Name, From Measure or To Measure, To Route ID or To Route Name, Start Date, and End Date parameters populate based on the selected route from the Search By Route widget.
- Click Add Line Event, provide an ending measure value in the To Measure option, and attributes for the new line event.
Note:
You can change any values after they are populated. If you do, the Add Line Event widget still validates all entries.
Run data actions with the Table widget
To use the data action at run time with the Table widget, complete the following steps:
- Select a record in the Table widget.
- Click the Action button at the top of the Table widget panel.
- Click Add Line Event.
The Event or Attribute Set, Network, Route ID or Route Name, and Event OID parameters populate based on the selected event from the table.
- For a non-line network, select a route.
The route you select populates both From Route and To Route values. You need to populate the measure values to add the events.
- For a line network, select one or two routes on the same line.
If two routes are selected for a spanning event or events in an attribute set, they populate the From Route and To Route values according to their line order. You need to populate the measure values to add the events.
The From Date and To Date values are populated using the start and end dates of the searched route, or the route with the lower line order if two routes are selected.
Note:
You can change any values after they are populated. If you do, the Add Line Event widget still validates all entries.
Run data actions with the LRS Identify widget
To use the data action at run time with the LRS Identify widget, complete the following steps:
- Identify a location on a route with the LRS Identify widget.
- Click the Action button at the top of the LRS Identify widget panel.
- Click Add Point Event.
The Event, Network, Route ID or Route Name, Measure, Start Date, and End Date parameters are populated based on the route and location from the LRS Identify widget.