Interact with circuits—ArcGIS Pro

The Find Circuits, Modify Circuit, and Create Circuit panes in ArcGIS Pro allow you to interact with telecom circuits in the utility network.

The Find Circuits pane allows you to search for and filter circuits in the network to perform operations against. The Modify Circuit pane allows you to alter details for a selected circuit, its sections, and subcircuits. The Create Circuit pane allows you to create circuits, circuit sections, and subcircuits in your network. This topic outlines how these panes can be used to create and work with circuits in a telecom domain network.

Requirements

To interact with circuits using the panes, a utility network containing a telecom domain network must be present in the active map. To perform circuit management tasks available through the context menu for a circuit, review the requirements for each operation.

Use the Find Circuits pane

The Find Circuits pane allows you to search for and filter circuits in your network to perform various operations. By default, a list of all circuits present in the active telecom domain network is presented when you open the pane. This list can be filtered by circuit name or by selecting a feature or object and using one of the prepopulated filters available from the drop-down menu.

Note:

When a domain network’s Circuit table or filter result contains 2,000 or more records, only the first 2,000 are populated. A circuit name can be entered in the Search field to further refine the result and display circuits.

In the circuits list, an icon in the Status column indicates that the circuit is clean, dirty, or invalid.

A green icon indicates that the circuit is clean and has been verified.
A yellow warning icon indicates that the circuit is dirty. This means that changes have been made to the circuit since the last time it was verified.
A red exclamation icon indicates that the circuit is invalid. This is displayed when an error is identified while verifying the circuit such as an invalid starting or stopping point, or if multiple paths are found between the starting and stopping points that define the circuit.

A context menu can be accessed by right-clicking a circuit in the grid view of the Find Circuits pane to perform various operations on circuits in the network that include export, modify, verify, and delete.

Find a circuit in the pane

Complete the following steps to search for and interact with a circuit using the Find Circuits pane:

Click the Utility Network tab.
In the Telecom Circuits group, click Find Circuits .
The Telecom Circuits group is enabled when a utility network that contains a telecom domain network is in the active map. For circuits to appear in the Find Circuits pane, they must be referenced in the Circuit table.
The Find Circuits pane appears.
If your network contains more than one telecom domain network, use the drop-down menu to the right of the Search field to specify the target telecom domain network.
Optionally, filter the circuits returned in the grid list by entering a circuit name in the Search field, by selecting a feature or object and using one of the predefined filters, or a combination of the two. Click the Reset button at the bottom of the pane to clear any filters or search terms from the pane.
- Search—Use the Search field to enter a circuit name and return circuits containing the text provided.
- Filters—You can expand a list of predefined filters to apply one of the following filters to the list of circuits in the grid. This can be used independently or in conjunction with the Search field or a selection to filter the circuits in the grid:
  - All Circuits—All circuits for the selected telecom domain network are returned. This is the default and is applied when the pane is opened.
  - Circuits starting from selected feature/object—Any circuit with a starting point that corresponds to the selected feature or object in the map is returned. This supports selection of a single feature or object.
  - Circuits ending on selected feature/object—Any circuit with a stopping point that corresponds to the selected feature or object in the map is returned. This supports selection of a single feature or object.
  - Circuits passing through selected feature/object—Any circuit that includes the selected feature or object in the map is returned. This supports selection of a single feature or object.
  - Deleted Circuits—Any circuit in the domain network with the Is deleted attribute value of True is returned.
Optionally, right-click a circuit in the list to access the context menu and perform circuit management tasks.
These tasks include the following:
- Export Circuit—Opens the Export Circuits tool with the selected circuit details prepopulated.
- Modify Circuit—Opens the Modify Circuit pane to allow modifications to the circuit, circuit sections, or subcircuits.
- Verify Circuit—Verifies a dirty circuit and updates the Status attribute value to Clean. This option does not use the geoprocessing framework and is unavailable when the circuit’s status is clean or invalid.
- Delete Circuit—Logically deletes the circuit from the network by updating the Is deleted attribute value to True.
- View Circuit Differences—View differences which cause a circuit to become dirty or invalid.
  Beta:
  View Circuit Differences is provided to support future work and is not currently in use.

Use the Create Circuit and Modify Circuit panes

The Create Circuit pane allows you to create circuits, circuit sections, and subcircuits, while the Modify Circuit pane allows you to alter details for existing circuits such as updating a starting point, or adding a section.

Create a nonsectioned circuit in the pane

Complete the following steps to create a nonsectioned circuit using the Create Circuit pane:

Click the Utility Network tab.
In the Telecom Circuits group, click Create Circuit .
The Create Circuit pane appears with the Details tab active.
If your network contains more than one telecom domain network, use the drop-down menu to the right of the Name field to specify the target telecom domain network in which to create the circuit.
For the Name parameter, specify a name for the circuit.
The circuit name must be unique in the utility network. The name may not exceed 128 characters, and the following special characters are invalid:
- Grave accent (`)
- Tilde (~)
- At sign (@)
- Dollar sign ($)
- Percent sign (%)
- Caret (^)
- Asterisk (*)
- Plus sign (+)
- Equal sign (=)
- Vertical bar (|)
- Backslash (\)
- Open-angle bracket (<)
- Close-angle bracket (>)
- Question mark (?)
- Open brace ({)
- Close brace (})
- Period (.)
- Exclamation point (!)
- Single quotation mark (')
- Open bracket ([)
- Close bracket (])
- Semicolon (;)
- Carriage return (\r)
- New line (\n)
- Double colon (::)
For the Multiple Sections parameter, leave the check box unchecked to create a nonsectioned circuit.
This will create a nonsectioned circuit with a single start and stop point. This is the default.
Learn how to create a sectioned circuit using the Create Circuit pane
Optionally, under the Attributes section, enter values for any user-defined fields you have added to the Circuit table.
For Start Point, use the Trace pane to select or load a selected feature to be the starting point for the circuit.
For Stop Point, use the Trace pane to select or load a selected feature to be the stopping point for the circuit.
Click the Load button to load the trace locations to the pane and populate the Start Point and Stop Point parameters.
Click the Trace button to validate the trace locations and ensure that a single path exists.
The Apply button is enabled.
Optionally, click the Subcircuits tab to create a subcircuit.
1. Click the Add button and provide a name for the subcircuit in the Name field.
2. Right-click the Consumer field and specify whether the subcircuit is reserved for use by its own circuit.
Click Apply.

The circuit is created.

Create a sectioned circuit in the pane

Complete the following steps to create a sectioned circuit using the Create Circuit pane:

Click the Utility Network tab.
In the Telecom Circuits group, click Create Circuit .
The Create Circuit pane appears with the Details tab active.
If your network contains more than one telecom domain network, use the drop-down menu to the right of the Name field to specify the target telecom domain network in which to create the circuit.
For the Name parameter, specify a name for the circuit.
The circuit name must be unique in the utility network. The name may not exceed 128 characters, and the following special characters are invalid:
- Grave accent (`)
- Tilde (~)
- At sign (@)
- Dollar sign ($)
- Percent sign (%)
- Caret (^)
- Asterisk (*)
- Plus sign (+)
- Equal sign (=)
- Vertical bar (|)
- Backslash (\)
- Open-angle bracket (<)
- Close-angle bracket (>)
- Question mark (?)
- Open brace ({)
- Close brace (})
- Period (.)
- Exclamation point (!)
- Single quotation mark (')
- Open bracket ([)
- Close bracket (])
- Semicolon (;)
- Carriage return (\r)
- New line (\n)
- Double colon (::)
For the Multiple Sections parameter, check the check box to create a sectioned circuit.
This will create a sectioned circuit. The Start Point and Stop Point parameters are removed from the pane and the Sections and Order tabs are added.
The Sections tab is used to specify the start and stop points for each section. The Order section is used to define the section ordering.
Optionally, under the Attributes section, enter values for any user-defined fields you have added to the Circuit table.
Optionally, click the Subcircuits tab to create a subcircuit.
1. On the Subcircuits tab, click the Add button and provide a name for the subcircuit in the Name field.
2. Right-click the Consumer field and specify whether the subcircuit is reserved for use by its own circuit. The default is Unreserved.
  If you specify that the subcircuit is reserved, this populates the Consumer field for the subcircuit with the Circuit name.
On the Sections tab, for the first section, specify whether the section should be defined using a trace or using a subcircuit.
- Using Trace—A section is configured using a starting and stopping point specified using the Trace pane.
1. For the Infer Connectivity parameter, specify whether connectivity inference will be used to establish connectivity for the circuit section. (This parameter is provided to support future work and is not currently in use.)
2. For the Start Point parameter, use the Trace pane to select or load a selected feature that will act as the starting point for the circuit section.
3. For the Stop Point parameter, use the Trace pane to select or load a selected feature that will act as the stopping point for the circuit section.
4. Click the Load button to load the trace locations to the pane and populate the Start Point and Stop Point parameters.
5. Click the Trace button to validate the trace locations and ensure that a single path exists.
6. Click the Accept button to confirm the trace result should be used to define the circuit section.
  Details are displayed for the start point and stop point which define the section.
7. Optionally, to create another section for the circuit, click the Add button and follow the steps to create a section.
- Using Subcircuit—An existing subcircuit is used to define the circuit section.
1. For the Select Circuit parameter, either select the current circuit to display the subcircuits for the circuit, or click the Load button to load all circuits in the telecom domain network that contain subcircuits.
2. For the Select Subcircuit parameter, select the subcircuit that should be used to define the circuit section.
3. Click the Trace button to validate the subcircuit and ensure that a path exists.
4. Click the Accept button to confirm the subcircuit's trace result should be used to define the circuit section.
  Details are displayed for the subcircuit which defines the section.
Click Apply.

The circuit is created.

Modify a nonsectioned circuit in the pane

Complete the following steps to modify an existing nonsectioned circuit using the Modify Circuit pane:

Click the Utility Network tab.
In the Telecom Circuits group, click Find Circuits .
The Find Circuits pane appears.
Right-click a circuit listed on the grid to display the context menu and click Modify Circuit.
The Modify Circuit pane appears with the Details tab active and populated with details for the selected circuit. Nonsectioned circuits display the Details and Subcircuits tabs, whereas sectioned circuits display additional Sections and Order tabs. All attributes for a circuit may be modified other than Name.
For the Multiple Sections parameter, leave the check box unchecked to maintain the circuit as a nonsectioned circuit with a single start and stop point. This is the default.
1. For Start Point, use the Trace pane to select or load a selected feature to be the starting point for the circuit.
2. For Stop Point, use the Trace pane to select or load a selected feature to be the stopping point for the circuit.
3. Click the Load button to load the start and stop points to the pane, and click the Trace button to validate the locations to ensure that a single path exists.
  The Apply button is enabled.
Optionally, for the Attributes parameter, edit the values for any user-defined fields you have added to the Circuit table.
Optionally, for the Start Point parameter, use the Trace pane to select or load a selected feature to replace the starting point used for the circuit.
Optionally, for the Stop Point parameter, use the Trace pane to select or load a selected feature to replace the stopping point used for the circuit.
Click the Load button to load the trace locations to the pane and populate the Start Point and Stop Point parameters.
Click the Trace button to validate the trace locations and ensure that a single path exists.
The Apply button is enabled.
Optionally, click the Subcircuits tab to create, delete, or modify a subcircuit.
1. Click the Add button and provide a name for a new subcircuit in the Name field.
2. Select the name of an existing subcircuit to modify the name.
3. Click the Delete button to remove a subcircuit.
4. Right-click the Consumer field to Reserve or Unreserve a subcircuit for use by its own circuit.
Click the Apply button.

The circuit is modified.

Modify a sectioned circuit in the pane

Complete the following steps to modify an existing sectioned circuit using the Modify Circuit pane:

Click the Utility Network tab.
In the Telecom Circuits group, click Find Circuits .
The Find Circuits pane appears.
Right-click a circuit listed on the grid to display the context menu and click Modify Circuit.
The Modify Circuit pane appears with the Details tab active and populated with details for the selected circuit. All attributes for a circuit may be modified other than Name.
Optionally, for the Multiple Sections parameter, if necessary, check the check box to make the circuit a sectioned circuit.
Click the Sections tab.
- Select a section and click the Edit button to modify a section.
  - The Select button can be used to trace and visualize the section in the map.
- Select a section and click the Delete button to delete an existing section.
- Click the Add button at the top of the pane and follow the steps to create a sectioned circuit in the pane.
Click the Apply button.