Add Network Attribute (Trace Network Tools)

Summary

Adds a network attribute to a trace network.

Usage

• A network attribute can be associated with only one attribute on a feature class; however, it can be associated with multiple feature classes.

• The network topology must be disabled.

• This tool can be used with the Set Network Attribute tool, which is used to assign the network attribute to a feature class field in the trace network.

  Learn more about creating network attributes

• When working with an enterprise geodatabase, the requirements are as follows:

  • The input trace network must be from a database connection established as the database trace network owner.

  • The active ArcGIS Enterprise portal account must be the portal trace network owner.

  • License:

    Organization members must be assigned a license for the ArcGIS Advanced Editing user type extension to create, publish, and edit a trace network in an enterprise geodatabase. Query and trace operations do not require this user type extension.

  • To run this tool, it must be connected to the default version.

• The following table lists the network attribute types and their applicable parameters:

  Attribute type	Apportionable	Nullable
  Short
  Long
  Double
  Date

Parameters

• Dialog
• Python

Label	Explanation	Data type
Input Trace Network	The input trace network to which the network attribute will be added.	Trace Network; Trace Network Layer
Attribute Name	The name of the network attribute to add to the trace network.	String
Attribute Type	Specifies the data type of the network attribute. Short (16-bit integer)—The field type will be short. Long (32-bit integer)—The field type will be long. Double (64-bit floating point)—The field type will be double. Date—The field type will be date.	String
Nullable (Optional)	Specifies whether the network attribute will support null values. Checked—The network attribute will support null values. Unchecked—The network attribute will not support null values. This is the default.	Boolean
Apportionable (Optional)	Specifies whether the network attribute will be apportioned across multiple edges belonging to the same feature. Apportioned behavior is only supported with double network attributes. Network attributes with the apportionable property can be assigned to fields in line or point feature classes, but only line features will have apportioned behavior. To illustrate, consider the shape_length network attribute and a line feature that consists of five edge elements of 20 feet each, where the total length of that line feature is 100 feet. This attribute will be apportioned across all edges. For example, using a function in a connected trace to count the shape_length attribute for this line will return a count of 5 because it accounts for each individual edge element and not the entire line. The distribution of the value depends on the percentage along each edge element with respect to the from point of the original feature. Checked—The network attribute will be apportioned. Unchecked—The network attribute will not be apportioned. This is the default.	Boolean

Derived output

Label	Explanation	Data type
Updated Trace Network	The updated trace network.	Trace Network

Environments

This tool does not use any geoprocessing environments.

Licensing information

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

Related topics

• An overview of the Trace Network toolbox
• Find a geoprocessing tool