Utility Isolation Trace

Configure application

The Water Isolation Trace app requires the Network Trace widget, which is used to run the isolation trace and save the results to the Outage Details feature service. To deploy this widget you will need to install and deploy the widget using the Web AppBuilder for ArcGIS (Developer Edition).

Network Trace widget

Before configuring the water isolation trace app, you will need to add the Network Trace widget to your Web AppBuilder (Developer Edition). To deploy the widget, complete the following steps:

  1. In Windows Explorer, browse to the download's Applications folder.
  2. Deploy the Network Trace widget.
  3. Start Web AppBuilder (Developer Edition). You will now be able to configure an application using the Network Trace widget.

Water isolation trace app

Once the Network Trace widget is added to your Web AppBuilder, you can configure the Water Isolation Trace app to determine valves to close and the affected area in the event of a main break or service shutdown.

To configure the Utility Isolation Trace app, complete the following steps:

  1. Create an app from the Isolation Trace map and Web AppBuilder (Developer Edition) with the following settings:
    • Name: Water Isolation Trace
    • Description: The Water Isolation Trace app allows the user to determine valves to close and affected customers and hydrants in the event of a main break or service shutdown. When the isolation area is determined, the results can be saved to a layer.
  2. Configure a new Network Trace widget with the following settings:
    • Widget Name: Water Isolation Trace
    • Task URL: The REST URL to your published Isolation Trace geoprocessing service
  3. Configure the Input parameters using the following settings:
    Input Settings
    Flags

    Tooltip: Input locations from which to start the trace.

    Type: Flag

    Symbol: Select a symbol
    Barriers

    Label: Input locations from which to block the trace.

    Type: Barriers

    Symbol: Select a symbol
    Skip Locations

    Tooltip: Locations of disabling features to "skip" in the trace.

    Type: Skip

    Symbol: Select a symbol
  4. Configure the Output parameters using the following settings:
    Output Settings
    Isolating Valves

    Label: Isolating Valves

    Skippable: Enabled

    Unique ID field: FACILITYID

    Tooltip: System valves features returned from the trace.

    Display text: {DIAMETER} inch; Valve ID: {FACILITYID}

    Min scale: 0

    Max scale: 0

    Export to CSV: Disabled

    Save to layer: Enabled

    Target layer: Isolating System Valves

    Symbol: Select a symbol
    Isolated Hydrants

    Label: Isolated Hydrants

    Skippable: Disabled

    Tooltip: Hydrant features returned from the trace.

    Display text: {MANUFACTURER}; Hydrant ID: {FACILITYID}

    Min scale: 0

    Max scale: 0

    Export to CSV: Disabled

    Save to layer: Enabled

    Target layer: Isolated Hydrants

    Symbol: Select a symbol
    Isolated Customers

    Label: Isolated Customers

    Skippable: Disabled

    Tooltip: The customers affected by the trace.

    Display text: Customer Account ID: {ACCOUNTID}

    Min scale: 0

    Max scale: 0

    Export to CSV: Disabled

    Save to layer: Enabled

    Target layer: Isolated Customers

    Symbol: Select a symbol
    Isolated Mains

    Label: Isolated Mains

    Skippable: Disabled

    Tooltip: Main features returned from the trace.

    Display text: {DIAMETER} {MATERIAL} main with ID: {FACILITYID}

    Min scale: 0

    Max scale: 0

    Export to CSV: Disabled

    Save to layer: Enabled

    Target layer: Isolated Mains

    Symbol: Select a symbol
    Isolated Laterals

    Label: Isolated Laterals

    Skippable: Disabled

    Tooltip: Lateral features returned from the trace

    Display text: {DIAMETER} {MATERIAL} lateral with ID: {FACILITYID}

    Min scale: 0

    Max scale: 0

    Export to CSV: Disabled

    Save to layer: Enabled

    Target layer: Isolated Lateral Lines

    Symbol: Select a symbol
    Flag Locations

    Label: Flag Locations

    Skippable: Disabled

    Tooltip: The snap locations used to trace the network.

    Display text: No information

    Min scale: 0

    Max scale: 0

    Export to CSV: Disabled

    Save to layer: Disabled

    Symbol: Select a symbol
    Barrier Locations

    Label: Barrier Locations

    Skippable: Disabled

    Tooltip: The snap locations used to limit the network.

    Display text: No information

    Min scale: 0

    Max scale: 0

    Export to CSV: Disabled

    Save to layer: Disabled

    Symbol: Select a symbol
  5. Configure the Summary using the following settings:
    • Summary text:
      {Flags:Count} break location(s) entered.
      {Isolating_Valves:Count} valves required to closed, {Isolating_Valves:SkipCount} skipped.
      {Isolated_Customers:Count} meters and {Isolated_Hydrants:Count} hydrants will be out of service.
  6. Configure the Overview using the following settings:
    • Visible: Enabled
    • Buffer Distance: 50
    • Buffer Type: Select an option
    • Unit: Feet
    • Min scale: 0
    • Max scale: 0
    • Save to layer: Enabled
    • Target Layer: Outage Area
    • Save Summary Options:
      • SnappedFlags: None
      • SnappedBarriers: None
      • wServiceConnection: CUSTOUT
      • wHydrant: NUMHYDS
      • wSystemValve: NUMVALVES
      • wLateralLine: None
      • wMain: None
      • Trace ID: TRACEID
    • Symbol: Select a symbol
  7. Configure the Other parameters to set the highlight image parameters and button text.
  8. Update the app's attributes to meet your utility's needs and branding.
  9. Save the application.
  10. Deploy the app and register the app to your ArcGIS Online organization.
Top