Back to Top

Add Point Event widget

In this topic

  1. Examples for Pipeline Referencing
  2. Examples for Roads and Highways
  3. Usage notes
  4. Settings
  5. Add a point event
  6. Interaction options

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 roadway 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.

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.

Learn more about express mode

Examples for Pipeline Referencing

Use this widget to support app design requirements such as the following:

  • Add anomaly information along a route.
  • Add anomaly, inspection note, and documentation point information along a route in a single operation.
  • Add event data to pipeline routes by entering station numbers in which the station measure values are used to calculate route and measure values for events.
  • Add anomaly event data based on coordinates collected by field operators.
  • Add event data to a route by specifying an offset from a known reference point.

Examples for Roads and Highways

Use this widget to support app design requirements such as the following:

  • Add crash information along a route.
  • Add stop sign, reference post, and bridge point information along a route in a single operation.
  • Add event data to highway routes by entering station numbers in which the station measure values are used to calculate route and measure values for events.
  • Add crash event data based on coordinates collected by first responders.
  • Add speed limit sign information to a route by specifying an offset from a known intersection.

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 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, complete the steps in the following ArcGIS Pro documentation:

  • Pipeline Referencing—Create the LRS, networks, events, and intersections and Share as web layers
  • Roads and Highways—Create the LRS, networks, events, and intersections and Share as web layers

To use the Add Point Event widget with feature services published with ArcGIS Enterprise, you must be signed in with an ArcGIS Enterprise account.

When using this widget in an app, if a message about acquiring locks appears, it means that conflict prevention is enabled.

Learn more about conflict prevention in Pipeline Referencing

Learn more about conflict prevention in Roads and Highways

When you include this widget in an app, a panel provides users with the following parameters for adding a point event:

  • Type—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 specify Single Point for Type)—Choose the event layer from which to add a point event.
  • Network—This parameter lists the network layer associated with the selected event.
  • Attribute Set (appears when you specify Multiple Point for Type)— Attribute sets are collections of event layer attributes. 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. 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 the point events to be added is listed here.
    • Route and Measure—Add a point event to a route using a specific measure.
      • Route ID or Route Name—Provide the route ID or name of the route where you want to add a point event. If the network layer has route name configured as an identifier, this parameter 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 parameter also displays the unit of measure defined by the network layer. For example, if the unit of measure is meters, this parameter is labeled Measure (Meters) at run time.
    • Coordinate—Add a point event to a route using x-, y-, and z-coordinates.
      • Route ID or Route Name—Provide the route ID or name of the route where you want to add a point event. If the network layer has route name configured as an identifier, this parameter is labeled Route Name.
      • X Coordinate—Provide the x-coordinate.
      • Y Coordinate—Provide the y-coordinate.
      • Z Coordinate—Optionally, provide the z-coordinate.
      • Measure—This parameter notes the nearest measure to the input coordinates. The label for this parameter also displays the unit of measure defined by the network layer. For example, if the unit of measure is meters, this parameter is labeled Measure (Meters) at run time.
      • Distance—This parameter notes the distance between the input coordinates and the nearest measure. The label for this parameter also displays the unit of measure defined by the network layer. For example, if the unit of measure is meters, this parameter is labeled Distance (Meters) at run time.
    • Location Offset—Add a point event using an offset distance from an LRS intersection, LRS point event, LRS calibration point, or a non-LRS point feature.
      • Route ID or Route Name—Provide the route ID or name of the route where you want to add a point event. If the network layer has route name configured as an identifier, this parameter is labeled Route Name.
      • Referent—Provide the point layer that the point event will be offset from.
      • Offset Feature—Provide the point feature that the point event will be offset from.
        Note:

        The name of the parameter below the Referent parameter is dependent on the field configured in the Configure Display Field setting.

      • Offset—Provide the distance the point event will be from the offset feature.
  • Start Date—Specify the start date of the event or events.
  • End Date—Specify the end date of the event or events.
  • Add event to dominant route—Add events to the dominant route where route concurrencies exist.

Settings

The Add Point 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 on 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:
          • Label—Provide a meaningful label for the layer. This label appears in the widget panel at run time.
        • LRS intersection layers, LRS calibration point layer, and non-LRS point layers:
          • Label—Provide a meaningful label for the layer. This label appears in the widget panel at run time.
          • Configure Display Field—Choose a field to be displayed as the name of the parameter below the Referent parameter when adding point events using the Location Offset method.
        • LRS point 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 the 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 for Configure Fields only apply when the user is adding a single point event. For multiple point events, fields display if they are included in the attribute set the user chooses at run time.

          • Configure Display Field—Choose a field to be displayed as the name of the parameter below the Referent parameter when adding point events using the Location Offset method.
    • Interact with a Map widget—Connect the Add Point 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 Select layers 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 Select layers to open the Select Layers panel. You can select or unselect layers from the list in the panel.
  • 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 a single point event.
    • Network (Multiple Point)—Choose the default network layer for adding multiple point events. When the user is adding a single point event, the network is always the registered network for the selected event layer.
    • Method—The method the widget uses to specify the location of the point events to be added.
      • Route and Measure—The widget specifies the location of added point events using the route name and measure value that the user provides.
      • Coordinate—The widget specifies the location of added point events using the x-, y-, and z- coordinates that the user provides.
      • Location Offset—The widget specifies the point event location using an offset distance from an LRS intersection, LRS point event, LRS calibration point, or a non-LRS point feature.
    • 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 attribute set 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 the settings to display in the widget panel at run time. If you choose to hide a setting here, the widget settings you configure for 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.
  • Coordinate Settings—Configure settings related to the Coordinate method.
    • Spatial Reference Type—Set a spatial reference for the Coordinate method. You can use the spatial reference from the web map or from the LRS.
    • Search Units—Choose the unit of measure the distance will be displayed in. The distance is how far from the selected route the input coordinate is. This setting also determines the unit of measure for the search radius.
    • Radius—Set the maximum distance for the search radius. The search radius is the maximum distance the input coordinate can be from a route.
      Note:

      If the coordinate is not within the search radius, the No routes found with provided coordinate error message appears in the widget panel.

  • Location Offset Settings—Configure settings related to the Location Offset method.
    • Default Referent—Choose the default referent layer to be displayed in the Referent parameter.
    • Default Offset Units—Choose the unit of measure for the Offset parameter.
  • Concurrency Settings—Choose the settings for adding events to the dominant route in the widget panel at run time.
    • Hide Add to Dominant Route Option—Hide the Add event to dominant route option from the widget panel.
    • Enable Add to Dominant Route Option—Enable the Add event to dominant route option in the widget panel.
    • Don't allow override of event placement on dominant routes—Turn on this setting to allow the user to add events to the dominant route by default.

Add a point event

To add a point event, complete the following steps:

  1. Start Experience Builder, and sign in to an ArcGIS Enterprise portal.
  2. Add a Map widget, and connect it to a web map with LRS data published with the Linear Referencing and Version Management capabilities enabled.

    Learn more about enabling these capabilities in ArcGIS Pro for Pipeline Referencing

    Learn more about enabling these capabilities in ArcGIS Pro for Roads and Highways

  3. Add an Add Point Event widget, connect it to the Map widget, and load LRS layers from the Map widget.
  4. Publish the app.
  5. Launch the app, and, if prompted, sign in to your ArcGIS Enterprise portal.
  6. 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.

  7. Open the Add Point Event widget.

    Add Point Event widget panel
    The first image is an example of the Add Point Event widget panel with Roads and Highways data. The second image is an example of the Add Point Event widget panel with Pipeline Referencing data.

    Note:

    You can also use data actions to add line events.

  8. Use the default type, or click the Type drop-down arrow and change the type if necessary.
  9. 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 for the Network parameter is based on the selected event layer.

  10. If Type is set to Multiple Point, use the default attribute set or choose another attribute set.
  11. If there are multiple methods configured in the widget settings, choose one of the following options from the Method drop-down menu:
    • Route and Measure
    • Coordinate
    • Location Offset
  12. If you chose Route and Measure in step 11, complete the following steps to add a point event:
    1. Specify a route by doing one of the following:
      • Provide a route ID or name in the Route ID or Route Name text box.
      • Click the route picker Route picker, and click a route on the map.

        The Measure value is populated based on the location you click.

    2. 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 Measure picker, and click a point along the route.

      Once you provide a measure value, a green point appears at that location on the map.

  13. If you chose Coordinate in step 11, complete the following steps to add a point event:
    1. Specify a route by doing one of the following:
      • Provide a route ID or name in the Route ID or Route Name text box.
      • Click the route picker Route picker, and click a route on the map.
      • Leave the Route ID text box blank and proceed to the next step.
        Note:

        Once valid values are provided in the X Coordinate, Y Coordinate, and Z Coordinate (optional) text boxes, the nearest route’s route ID populates the Route ID or Route Name text box.

    2. Specify a location for the point event by providing values in the X Coordinate and Y Coordinate text boxes. Optionally, provide a value in the Z Coordinate text box.
      Note:

      Do not include commas in the coordinate value.

  14. If you chose Location Offset in step 11, complete the following steps to add a point event:
    1. Specify a route by doing one of the following:
      • Provide a route ID or name in the Route ID or Route Name text box.
      • Click the route picker Route picker, and click a route on the map.
    2. Choose a referent layer from the Referent drop-down menu.
    3. Specify an offset feature by doing one of the following:
      • Provide an attribute in the text box based on the referent layer's display field.
      • Click the route picker Route picker, and click an offset feature on the map.
    4. Specify an offset distance in the Offset text box.
      Note:

      A negative Offset value places the measure location opposite the direction of calibration from the selected offset feature.

  15. 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 Calendar, and choose a start date.
    • Check the Use route start date check box.
  16. 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 Calendar, and choose an end date.
    • Check the Use route end date check box.
      Note:

      If you do not provide an end date, the event remains valid from the route start date into the future.

  17. Optionally, if route concurrencies exist, add point events to the dominant route.

    Concurrent routes are routes that share the same centerlines. This relationship may exist to model two routes with different directions of calibration. Where these concurrent routes exist, you can use a set of rules to choose a route that's considered dominant.

    For example, in the diagram below, there are two routes with route IDs 100 and 200.

    Scenario of adding point events to routes with concurrencies

    The route dominance rule is set so that the greater the route ID, the more dominant the route. Using this condition, Route 200 is the dominant route, and Route 100 is the subordinate route.

    When adding point events at two locations on Route 100, the event will be added to Route 100 at location 1 because no other route exists at that point. At location 2, Route 200 has a greater order of dominance, so the event will be added to Route 200.

    Learn more about adding point events to the dominant route in Pipeline Referencing

    Learn more about adding point events to the dominant route in Roads and Highways

  18. Click Next.

    The attributes for the chosen point event appear on a second page.

  19. Provide attribute values for the event layer.
    Note:
    • You can use the Copy Attributes tool to copy attributes from an existing event.
    • When adding multiple events, the following apply:
      • An attribute set can contain events registered with different networks. Only events registered with the selected network appear.
      • Check or uncheck the check box next to each event layer to include or exclude it in the edit activity. Unchecked events will not be added.
      • The visibility and editability of an event field is dependent on the configuration of the attribute set. The event configuration for single events does not apply when adding multiple events.

    Manage event attributes
    The first image is an example of the Add Point Event widget panel with Roads and Highways data. The second image is an example of the Add Point Event widget panel with Pipeline Referencing data.

  20. Click Save.

    A confirmation message appears in the widget panel 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 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 app.

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.
  • LRS Identify widget—Data action populates the event or attribute set, network, route, measure, and date options.
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 Search By Route widget

To use the data action at run time with the Search By Route widget, complete the following steps:

  1. Select a route in the Search By Route results.
  2. Click the Actions button at the top of the Search By Route widget panel.
  3. Add a point event by doing one of the following:
    • If the search result contains a route with start and end measure values, click Add Point Event, and provide a measure value in the Measure parameter.
    • If the search result contains a route with a single measure value, click Add Point Event to use it as the measure of the point event to be added.

    The parameters are populated based on the selected route from the Search By Route widget.

Run data actions with the Table widget

To use the data action at run time with the Table widget, complete the following steps:

  1. Select a route from the network layer in the Table widget.
  2. Click the Actions button at the top of the Table widget panel.
  3. Click Add Point Event, and provide a measure value in the Measure parameter.

    The parameters are populated based on the selected route from the table.

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:

  1. Click a specific location on a route using the LRS Identify widget.
  2. Click the Actions button at the top of the LRS Identify widget panel.
  3. Click Add Point Event.

    The parameters are populated based on the route and location from the LRS Identify widget.

Feedback on this topic?

In this topic
  1. Examples for Pipeline Referencing
  2. Examples for Roads and Highways
  3. Usage notes
  4. Settings
  5. Add a point event
  6. Interaction options