The Split Event widget allows you to split a line event into two adjoining events. You can use the widget to manage pipeline data with ArcGIS Pipeline Referencing and roadway data with ArcGIS Roads and Highways. You can edit the attributes of an event after choosing a split location. After the widget splits the event, the input event is retired and the resulting events receive new event IDs.
Note:
All Location Referencing widgets support express mode. When you create an app in express mode, all Location Referencing widgets are automatically configured based on the web map added to the Map widget. Any modifications made in the Map widget, such as changing the web map, will instantly be reflected in the Location Referencing widgets. Express mode allows you to efficiently set up Location Referencing widgets within ArcGIS Experience Builder, streamlining the deployment process for apps that contain Location Referencing widgets.
Examples for Pipeline Referencing
Use this widget to support app design requirements such as the following:
- You want to split a pipeline line event into two new events.
- You need to split line events based on changes to pipeline attributes, such as operating pressure or inspection range.
- Your organization needs users to be able to split line events while working in the field.
Examples for Roads and Highways
Use this widget to support app design requirements such as the following:
- You want to split a roadway line event into two new events.
- You need to split line events based on changes to roadway attributes, such as speed limit or parking status.
- Your organization needs users to be able to split line events while working in the field.
Usage notes
This widget requires connection to a Map widget. To split a line event, the Map widget must be connected to a web map data source with an LRS published with the Linear Referencing and Version Management capabilities 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
When you include this widget in an app, a panel provides users with the following parameters to split a line event:
- Event—Choose the event layer that contains the events to be split.
- Network—The parent LRS Network layer of the chosen line event layer.
- Route ID or Route Name—Provide a route ID or name for the route that is associated with the event you want to split. If the network layer has route name configured as the identifier, this setting is labeled Route Name.
Note:
If the input LRS Network is configured with a multifield route ID, the concatenated route ID appears.
- Split Measure—Provide a measure value. The measure value defines the exact location on the route where you want to split the line event.
- Split Date—Choose a date that defines the effective date of the split operation.
- Event OID—The object ID of the event to be split.
- Event 1—Edit the attributes of the first resulting event.
- Event 2—Edit the attributes of the second resulting event.
Settings
The Split Event widget includes the following settings:
- Mode—Choose a method of loading data.
- Select Layers—Select a Map widget and load all layers from the web map.
- Select a Map widget—Select a Map widget in the page that's connected to a web map.
- Load layers—Load layers from the web map in the connected Map widget. To load layers, the Map widget must be connected to a web map that contains LRS layers.
- Clear layers—Remove all loaded layers from the widget.
- Layers—After loading layers, you can click the down arrow to expand the list of layers. Click a layer to open the Layer Configuration panel.
- Layer Configuration—Configure settings for individual layers.
- LRS Network and intersection layers:
- Label—Provide a meaningful label for the layer. This label appears in the widget panel at run time.
- LRS event layers:
- 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.
- LRS Network and intersection layers:
- Interact with a Map widget—Connect the Split Event widget to a Map widget. Any web maps in the connected Map widget appear in the list. After connecting to a Map widget, you can click the down arrow next to the Select Layers button
to expand the list of layers. Click a layer to open the Layer Configuration panel. - Layer Configuration—Configure settings for individual layers. Review the settings available in the Layer Configuration panel.
- Select Layers—Click the Select Layers button to open the Select Layers panel. You can select or unselect layers from the list in the panel.
- Select Layers—Select a Map widget and load all layers from the web map.
- Default Settings—Configure the default event layer for the Event parameter. This is the event layer that you want to appear in the widget panel when it first loads.
- Display Settings—Choose which parameters to display in the widget panel at run time.
- Hide Event—Hide the Event parameter from the widget panel. If this setting is turned on, the default event layer is unchangeable by the user at run time.
- Hide Network—Hide the Network parameter from the widget panel.
Split an event
Complete the following steps to split an 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 and Version Management capabilities enabled.
- Add a Split Event widget. Connect it to the Map widget, and 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 split a line event.
- Open the Split Event widget.
The first image is an example of the Split Event widget panel with Pipeline Referencing data. The second image is an example of the Split Event widget panel with Roads and Highways data. You can also use data actions to split an event.
- Use the default line event layer or click the Event drop-down arrow and choose another line event layer.
- Specify the route that contains the event you want to split by doing one of the following:
- Provide a route ID or name in the Route ID or Route Name text box.
If the network layer has route name configured as an identifier, this setting is labeled Route Name.
- Click the route picker
, and click a route on the map.
The Split Measure value populates based on the location you click.
- Provide a route ID or name in the Route ID or Route Name text box.
- Optionally, change the measure value by providing a value in the Split Measure text box.
- Specify the split date by doing one of the following:
- Leave the default split date, which is the current date.
- Provide a split date in the Split Date text box.
- Click the calendar button
and choose a split date. - Check the Use route start date check box.
- Optionally, edit the attributes of the split events.
- Click Split.
A confirmation message appears at the top of the widget panel when you split a line event. The input line event is retired as of the split date. The two new events flash on the map.
Interaction options
This widget supports data actions, which you can enable on the Action tab of widgets' settings.
You can use data actions in the Table widget to launch the Split Event widget and populate values. To do this, you must add a Split Event widget and a Table widget to your app and turn on the Split Event data action in the Table widget's settings.
The Table widget's Split Event data action can populate the Event, Network, Route ID or Route Name, Event OID, and Split Date parameters in the Merge Events widget. It can also populate the attributes of the resulting split event.
To use the data action at run time, complete the following steps:
- Select a record in the Table widget.
- Click the Action button at the top of the Table widget panel.
- Click Split Event.
The Event, Network, Route ID or Route Name, and Event OID parameters populate based on the selected event from the table.
- Provide a value for the Split Measure parameter.
The Split Date parameter populates with the current date.
Note:
You can change any values after they are populated by the data action. If you do so, the Split Event widget still validates all entries.