Skip to main content

Set Telecom Object Divide Policy (Utility Network Tools)

Summary

Sets the divide policy for grouped junction and edge objects in a telecom domain network to determine how attribute values will be handled during a divide operation.

You can divide grouped junction and edge objects that participate in a telecom domain network as part of the edit request on the applyEdits operation. The edit request contains the ID of the layer containing the feature you want to divide along with the global ID of the grouped feature to be divided. This, along with the numUnits property, is used to communicate how the units in the grouped object will be divided.

By setting the object divide policy for the various attribute fields, you can control how the attribute values will be handled when grouped objects are divided: either apportioning the values by the number of units in the new groups or setting the default value for both groups. This is defined for each user-defined attribute on the grouped junction or edge object. By default, when an attribute does not have a divide policy specified, new objects will be created with the same attribute values as the original object.

Learn more about using divideGroupedObjects with applyEdits in a utility network

Usage

  • The Input Utility Network parameter value must reference a utility network version 8 or later.

  • The utility network dataset provided for the Input Utility Network parameter must include a telecom domain network.

  • When working with an enterprise geodatabase, the Input Utility Network parameter value must be from a database connection established as the database utility network owner.

  • When working with an enterprise geodatabase, the connected ArcGIS Enterprise portal account must be the portal utility network owner.

Parameters

Label Explanation Data type

Input Utility Network

The utility network containing the telecom domain network.

Utility Network; Utility Network Layer

Domain Network

The telecom domain network that contains the objects that will be modified.

String

Input Table

The name of the input junction object or edge object table in the telecom domain network.

String

Policies

(Optional)

Specifies the editable fields and divide policy that will be applied.

Value table columns:

  • Attribute—The user-defined attribute field to which the divide policy will be applied.

  • Policy—The policy that will be applied to values in the attribute field on a divide operation.

    • Unit apportioned—The attribute values from the divided object will be apportioned in the attribute field of the updated objects. This applies to fields with numeric data types only.

    • Default value—The default value of the attribute field will be set for the updated and inserted objects.

Value Table

Derived output

Label Explanation Data type

Updated Utility Network

The updated utility network.

Utility Network

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: No
  • Standard: Yes
  • Advanced: Yes