Skip to main content

Verify circuits

A circuit comprises a collection of components that represent a dedicated path between specified elements in a telecom domain network. A circuit may be composed of disconnected collections of connected elements, which are called sections. A circuit can be nonsectioned or composed of more than one section that are partially ordered (arranged in parallel or sequentially).

When a circuit is verified using the Verify Circuits tool or from the Find Circuits pane, the following checks are performed:

  • Evaluate the start and stop locations to confirm that they exist and are valid.

    • When the start and stop location correspond with junctions or junction objects, the asset type must be assigned the Circuit Location network category.

    • When the start and stop location correspond with lines or edge objects, ensure that the feature does not possess both From and To side connectivity.

    • Ensure that the start or stop location for a nonsectioned circuit is not empty when the corresponding start or stop location is populated.

  • If the Share Circuit Locations parameter value is false for the telecom domain network, evaluate the start and stop locations to ensure that they are not used to define other circuits.

  • If a circuit or circuit section is physical, ensure that the stop location is reachable from the start location on a single unique path.

  • Confirm all sections are physical when the Circuit Type value for a sectioned circuit is Physical.

  • Confirm at least one section is virtual when the Circuit Type value for a sectioned circuit is Virtual.

  • Confirm that any subcircuits consumed by the circuit are clean.

When the tool runs successfully, the Circuit table is updated, the Status field is updated to Clean, and the Last verified field is updated with a timestamp. If any issues are identified that prevent the circuit from being verified, the Status field is updated to Invalid and an error is returned indicating the problem. The error is stored in the Error message field on the Circuit table.

Caution:

Consumed circuits must be verified before the consuming circuit can be verified. If any subcircuit consumed by the circuit being verified is dirty, the circuit cannot be verified, and the operation will fail.

Requirements

The following requirements must be met to verify a circuit:

  • The telecom domain network must contain one or more circuits.

  • The network topology must be enabled.

  • Any edits must be saved.

  • When working with an enterprise geodatabase, the following additional requirements must be met:

    • The Input Utility Network parameter value must be from a utility network service.

    • License:

      The active portal account must be assigned a license with the ArcGIS Advanced Editing user type extension to use this tool in an enterprise deployment.

Verify one or more circuits

To verify one or more circuits in a telecom domain network using the Verify Circuits tool, 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 Verify Circuits.

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

  4. Click the Domain Network parameter drop-down arrow and choose a telecom domain network.

  5. For the Circuits parameter, provide the name or names of the dirty circuits to be verified.

    When specifying multiple circuits, use a comma-delimited list.

  6. Optionally, for the Force verify parameter in the Advanced options section of the tool, specify whether you want to force the verification of any clean or invalid circuits in the list.

    • Unchecked—The operation will honor the status of the circuit and will not attempt to verify clean or invalid circuits. This is the default.

    • Checked—The operation will ignore the status of the circuit and run against clean or invalid circuits. This can be useful to verify circuits in scenarios where circuits were imported as clean.

  7. Click Run.

The provided circuits are verified. Any circuit that fails verification returns an error and the status becomes invalid in the Circuit table.

Note:

You can also use the Find Circuits pane to explore and verify circuits. When you use the pane for verification, the Verify Circuits tool is not used and nothing is logged in the geoprocessing history.

After the verify circuit operation completes, review the Circuit table to inspect the Status and Last verified attribute values.

Learn more about how to interact with and verify circuits using the Find Circuits pane