The Add Point Event widget allows you to create point 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 inline inspection (ILI) survey readings for a pipeline or speed limit signs for a road, as single point events with measure information along the route.
Examples for Pipeline Referencing
Use this widget to support app design requirements such as the following:
- You want to add anomaly information along a route.
- You want to add anomaly, inspection note, and documentation point information along a route in a single operation.
- You want to add event data to pipeline routes by entering station numbers, where the station measure values are used to calculate route and measure values for events.
Examples for Roads and Highways
Use this widget to support app design requirements such as the following:
- You want to add crash information along a route.
- You want to add stop sign, reference post, and bridge point information along a route in a single operation.
- You want to add event data to highway routes by entering station numbers, where the station measure values are used to calculate route and measure values for events.
Usage notes
This widget requires connection to a Map widget. To add point 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 Point 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 parameters for adding a point event:
- Type—Choose to add single or multiple point events.
- Single Point—Add a single point event.
- Multiple Point—Add multiple point events in one edit activity.
- Event (appears when you choose Single Point under Type)—Choose the event layer from which to add a point event.
- Network—This label lists the network layer associated with the selected event.
- Attribute Set (appears when you choose Multiple Point 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 point 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.
- Method—The method the widget uses to specify the location of added point events is listed here.
- Route ID or Route Name—Provide a route ID or name for the route where you want to add a point event. If the network layer has route name configured as an identifier, this setting is labeled Route Name.
- Measure—Provide a measure value. The measure value defines the exact location on the route where the added event will be located. 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 Measure (Meters).
- Start Date—Specify the start date of the event or events.
- End Date—Specify the end date of the event or events.
Settings
The Add Point 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.
Note:
The settings you define under Configure Fields only apply when the user is adding a single point event. For multiple points events, fields display if they are included in the attribute set the user chooses at run time.
- Default Settings—Configure the default settings that you want available in the widget when it first loads.
- Event (Single Point)—Choose the default event layer for adding single point events.
- Network (Multiple Point)—Choose the default network layer for adding multiple point events. When the user is adding single point events, the network is always the registered network for the selected event layer.
- Method—Choose the default method for how the widget defines the event location when adding point events. You can choose the following method:
- Route and measure—If you choose this method, the widget specifies the location of added point events 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 point 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 Method setting from the widget panel.
- Hide Attribute Set—Hide the Attribute Set setting from the widget panel.
Add a point event
Complete the following steps to add a point 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 Point 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 point 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 Point Event widget.
- Use the default type or click the Type drop-down arrow and change the type, if necessary.
- If Type is set to Single Point, use the default point event layer or click the Event drop-down arrow and choose another point event layer. The value that appears under Network is based on the selected event layer.
- If Type is set to Multiple Point, you can use the default attribute set or choose another attribute set.
- Specify a route by doing one of the following:
- Provide a route ID in the Route ID text box.
- Click the route picker
, then click a route on the map.The Measure value populates based on the location you click.
- Specify a location for the point event by doing one of the following:
- Provide a measure value in the Measure text box.
Note:
Stationing measure values are also supported.
- Click the measure picker , then click a point along the route.
Once you provide a measure value, a green dot appears at that location on the map.
- Provide a measure value in the Measure text box.
- Specify the start 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 end date for the point 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.
- Click Next.
The attributes for the chosen point event appear in a second pane.
- Provide attribute values for the event layer.
You can use the Copy Attributes tool to copy attributes from an existing event.
- Click Save.
A confirmation message appears in the tool pane once the new point event is added and appears on the map.
Interaction options
You can use data actions in other widgets to launch the Add Point Event widget and populate associated values. To be able to use data actions, the network in the source widget must have associated point events, the data action options of Add Point Event in the source widget must be turned on, and the Add Point Event widget must be configured in the experience. Turn off the data action options of Add Point Event in the source widget to not use data actions.
The following widgets support data actions of the Add Point Event widget:
- 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.
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 point event by doing one of the following:
- Click Add Point Event, provide a measure value in the Measure option, and attributes for the new point event.
The Event, Network, Route ID or Route Name, Measure, 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 Point Event to be the measure of the point event to be added.
The Event, Network, Route ID or Route Name, Measure, Start Date, and End Date parameters populate based on the selected route from the Search By Route widget.
- Click Add Point Event, provide a measure value in the Measure option, and attributes for the new point event.
Note:
You can change any values after they are populated. If you do, the Add Point 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 Point 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. The Start Date and End Date values are populated using the start and end dates of the searched route.
Note:
You can change any values after they are populated. If you do, the Add Point Event widget still validates all entries.