Set or modify the circuit properties

A circuit comprises a collection of components that represent a dedicated path between specified elements in the network.

Circuits are assigned an initial property set when the telecom domain network they reside in is created; however, you can set or modify the properties for circuits using the Set Circuit Properties tool.

Requirements

To set circuit properties, the following requirements must be met:

• The network topology must be disabled.

• When working with an enterprise geodatabase, ensure the following:

  • The Input Utility Network parameter value must be from a database connection established as the database utility network owner.

  • The connected ArcGIS Enterprise portal account must be the portal utility network owner.

Set the circuit properties for a telecom domain network

To set the circuit properties for a telecom domain network, complete the following steps:

1. On the Analysis tab, in the Geoprocessing group, click Tools to open the Geoprocessing pane.

2. In the Geoprocessing pane, search for and select Set Circuit Properties.

3. For the Input Utility Network parameter, specify the utility network.

4. For the Telecom Domain Network parameter, specify the domain network.

5. Optionally, check the Share circuit locations parameter.

   This parameter specifies whether start and stop locations can be shared between circuits.

   • Checked—A start or stop location can be used to define one or more circuits in the telecom domain network.

   • Unchecked—A start or stop location can only be used to define a single circuit in the telecom domain network. This is the default.

6. Optionally, check the Import circuits as clean parameter.

   This parameter specifies whether circuit definitions are imported to the Circuit table with the Status attribute value of Clean or Dirty.

   • Checked—The Status attribute value of imported circuits is Clean and the Last verified attribute is null. When the network topology is disabled, the Status attribute field is not updated.

   • Unchecked—The Status attribute value of imported circuits is Dirty. When the network topology is disabled, the Status attribute field is updated to Dirty for all circuits.

7. Optionally, expand the Circuit Trace Configuration section to set the defaults that are used for trace when you create, modify, verify, and export circuits in a network.

   The settings in this section automatically populate the trace configuration used by the traces that are run to identify valid paths for a circuit when it is created, modified, or exported. The trace configuration is also used by the Verify Circuits tool to confirm that a circuit can be traced from the start location to the stop location and to confirm that the Share Circuit Locations setting is honored.

   • Max Hops—Specifies the the maximum number of hops allowed between edges in the path, excluding the start location when you run a path trace. This can be used as a barrier to constrain the result when running a circuit trace. The default is 100.

   • Include containers—Specifies whether containers of traversed features will be included.

   • Include content—Specifies whether content of traversed features will be included.

   • Include structures—Specifies whether structures with attachments to traversed features will be included.

   • Include barrier features—Specifies whether barriers will be included.

   • Validate locatability—Specifies whether an error will be returned if unlocatable junction or edge objects are encountered.

   • Summaries—Calculates and stores function information for user-defined attributes in the Circuit table.

     • This parameter is not currently implemented and is reserved for future use.

   • Condition Barriers—Specifies a feature or object that will stop an operation based on network attributes and categories.

   • Function Barriers—Specifies a feature or object that will stop an operation based on a function.

   • Apply Traversability To—Specifies the traversability scope that will be applied. You can apply traversability to only junctions, only edges, or both junctions and edges.

   • Propagators—Uses network attributes to propagate values from circuit locations during a trace.

     • Propagators configured for wavelength propagation are persisted in the trace configuration used to perform a circuit trace using the Trace tool.

8. Optionally, use the User Attributes parameter in the User Attributes Marking Circuits Dirty section to specify user-defined attribute fields on circuit management tables that should mark a circuit as dirty when modified.

   1. For the Circuit Table property, specify the circuit management table containing the user-defined attributes.

   2. For the Attribute Name property, select the fields that should mark a circuit as dirty when modified.

9. Click Run.

The specified circuit properties are defined for circuits in the telecom domain network. To view the circuit properties, open the utility network's layer properties and click the Network Properties tab.