Skip to main content

Condition properties

Summary

The properties below are returned by the conditions object when using Describe on a utility network.

Learn more about setting up functions for a trace

Properties

Property Explanation Data Type

combineUsingOr

(Read only)

Whether the condition is using an Or condition for the combine using parameter.

  • True—The combine using parameter is using an Or condition.

  • False—The combine using parameter is not using an Or condition. This means the combine using parameter could be using the And condition, or no value if there are not multiple conditions.

Boolean

isSpecificValue

(Read only)

Whether the condition is using a specific value to terminate the trace.

  • True—The condition is set to a specific value.

  • False—The condition is not set to a specific value.

Boolean

name

(Read only)

The name of the network attribute or category used for the condition—for example, Device status.

String

operator

(Read only)

The operator used for the condition—for example, is equal to or is greater than or equal to.

String

type

(Read only)

The type of condition used—for example, using a specific value or a network attribute.

String

value

(Read only)

The specific value of the network attribute or category used for the condition.

Integer

Code sample

Utility network functions and conditions properties example (stand-alone script)

This stand-alone Python script prints a report of some utility network properties.

# Import required modules
import arcpy

# Describe functions on a Utility Network
UN = "C:\\Projects\\MyProject\\unowner.sde\\Naperville.UNOWNER.Naperville\\Naperville.UNOWNER.Naperville"
d = arcpy.Describe(UN)

# Domain Network properties
domnets = d.domainNetworks

# For each domain network in the utility network
for dom in domnets:
    print(f"Domain Network Name: {dom.domainNetworkName}")

    # For each tier in the domain network
    for tier in dom.tiers:
        print(f"Tier Name: {tier.name}")

        # Update Subnetwork Trace Configuration Properties
        ust = tier.updateSubnetworkTraceConfiguration

        # Functions Properties
        print(" - Functions Properties - ")
        for f in ust.functions:
            # Try to get these properties if the exist, else, print the empty list
            try:
                print(f"Function Type: {f.functionType}")
                print(f"Function Network Attribute Name: {f.networkAttributeName}")
                print(f"Function Summary Attribute Name: {f.summaryAttributeName} \n")
                # Function Conditions
                print(" - Function Conditions - ")
                for fc in f.conditions:
                    print(f"Name: {fc.name}")
                    print(f"Type: {fc.type}")
                    print(f"Operator: {fc.operator}")
                    print(f"Value: {fc.value}")
                    print(f"CombineUsingOr: {fc.combineUsingOr}")
                    print(f"Is Specific Value: {fc.isSpecificValue} \n")
            except:
                print("Skipped functions properties. \n")