UtilityTraceParameters QML Type

  • Esri.ArcGISRuntime
  • UtilityTraceParameters
  • Utility network trace parameters. More...

    Import Statement: import Esri.ArcGISRuntime
    Since: Esri.ArcGISRuntime 100.6
    Inherits:

    Object

    Properties

    Signals

    Detailed Description

    If you would like to create this type from utilityNamedTraceConfiguration and startingLocations, then you can see the following code block:

    property var locations; // starting location you got from elsewhere
    property var namedTraceConfiguration; // received from elsewhere
    
    UtilityTraceParameters {
        startingLocations: locations
        resultTypes: namedTraceConfiguration.resultTypes
        traceConfiguration: namedTraceConfiguration.defaultTraceConfiguration()
        traceType: namedTraceConfiguration.traceType
    }

    See also UtilityNetwork::trace.

    Property Documentation

    [read-only] barriers : list<UtilityElement>

    The list of barriers to use in the trace operation.

    Barriers are used in traces to mark the locations to stop tracing.

    To update the barriers list, assign a new JavaScript array that contains the desired elements:

    params.barriers = [barrier1, barrier2, barrier3];

    [read-only, since Esri.ArcGISRuntime 100.10] filterBarriers : list<UtilityElement>

    The collection of filter barriers.

    A regular barrier, specified by barriers, prevents traversal which, when used with subnetwork-based traces, can prevent traversal to the subnetwork controller. Like UtilityTraceConfiguration::filter, filter barriers are evaluated in the second pass of a trace. Therefore, it can restrict the result set without impacting the ability to find subnetwork controllers from starting points.

    One example of where filter barriers can be used is in the gas distribution domain. Filter barriers can be used to simulate the location of a squeeze-off when executing a valve isolation trace. The user can place a filter barrier at the proposed location of the squeeze-off and then verify its impact, using a trace.

    To update the filterBarriers list, assign a new JavaScript array that contains the desired elements:

    params.filterBarriers = [barrier1, barrier2, barrier3];

    This property was introduced in Esri.ArcGISRuntime 100.10.


    resultTypes : list<Enums.UtilityTraceType>

    Returns a collection that is pre-populated with the default of Enums.UtilityTraceResultTypeElements.

    This corresponds to the UtilityTraceResult collection returned by UtilityNetwork::trace.

    See also Enums.UtilityTraceType.


    [read-only] startingLocations : list<UtilityElement>

    The list of starting locations to use in the trace operation.

    A starting point defines the location in the network where a trace begins.

    To update the starting location list, assign a new JavaScript array that contains the desired elements:

    params.startingLocations = [location1, location2, location3];

    [since Esri.ArcGISRuntime 100.7] traceConfiguration : UtilityTraceConfiguration

    The complete collection of trace options.

    This property was introduced in Esri.ArcGISRuntime 100.7.


    traceType : Enums.UtilityTraceType

    The traceType of the UtilityTraceParameters.

    See also Enums.UtilityTraceType.


    Signal Documentation

    barriersChanged()

    Emitted when the barriers property changes.

    Note: The corresponding handler is onBarriersChanged.


    [since Esri.ArcGISRuntime 100.10] filterBarriersChanged()

    Emitted when the filterBarriers property changes.

    Note: The corresponding handler is onFilterBarriersChanged.

    This signal was introduced in Esri.ArcGISRuntime 100.10.


    resultTypesChanged()

    Emitted when the resultTypes property changes.

    Note: The corresponding handler is onResultTypesChanged.


    startingLocationsChanged()

    Emitted when the startingLocations property changes.

    Note: The corresponding handler is onStartingLocationsChanged.


    [since Esri.ArcGISRuntime 100.7] traceConfigurationChanged()

    Emitted when the traceConfiguration property changes.

    Note: The corresponding handler is onTraceConfigurationChanged.

    This signal was introduced in Esri.ArcGISRuntime 100.7.


    traceTypeChanged()

    Emitted when the traceType property changes.

    Note: The corresponding handler is onTraceTypeChanged.


    Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.