用于向追踪网络中添加网络属性。
一个网络属性只能与要素类上的一个属性相关联；但是，它可以与多个要素类相关联。
必须禁用网络拓扑。
此工具可与设置网络属性工具配合使用，后者用于将网络属性分配给追踪网络的要素类字段。
在使用企业级地理数据库时，需要满足以下要求：
输入追踪网络必须来自作为数据库追踪网络所有者建立的数据库连接。
活动的 ArcGIS Enterprise 门户账户必须为门户追踪网络所有者。
下表列出了网络属性类型及其适用的参数：
| 属性类型 | 可分配 | 可为空 |
|---|---|---|
短整型 |  | |
长整型 | | |
双精度 | | |
日期 | |
| 标注 | 说明 | 数据类型 |
输入追踪网络 | 将添加网络属性的输入追踪网络。 | Trace Network; Trace Network Layer |
属性名称 | 要添加至追踪网络的网络属性的名称。 | String |
属性类型 | 指定网络属性的数据类型。
| String |
可为空 (可选) | 指定网络属性是否支持空值。
| Boolean |
可分配 (可选) | 指定是否在同一要素的多条边之间分配网络属性。 分配行为仅支持使用双精度型网络属性。 可以将具有可分配属性的网络属性分配给行内字段或点要素类，但仅行要素具有已分配行为。 为了进行说明，请考虑 shape_length 网络属性以及由 5 个边元素组成的线要素，每个边元素 20 英尺，该线要素的总长度为 100 英尺。 将在所有边上分配此属性。 例如，使用已连接追踪中的函数对此线的 shape length 属性进行计数将返回计数 5，因为它考虑了每个单独的边元素，而非整条线。 值的分布取决于每个边元素方向上相对于原始要素起点的百分比。
| Boolean |
| 标注 | 说明 | 数据类型 |
| 已更新的追踪网络 | 更新的追踪网络。 | Trace Network |
arcpy.tn.AddNetworkAttribute(in_trace_network, attribute_name, attribute_type, {is_nullable}, {is_apportionable})| 名称 | 说明 | 数据类型 |
in_trace_network | 将添加网络属性的输入追踪网络。 | Trace Network; Trace Network Layer |
attribute_name | 要添加至追踪网络的网络属性的名称。 | String |
attribute_type | 指定网络属性的数据类型。
| String |
is_nullable (可选) | 指定网络属性是否支持空值。
| Boolean |
is_apportionable (可选) | 指定是否在同一要素的多条边之间分配网络属性。 分配行为仅支持使用双精度型网络属性。 可以将具有可分配属性的网络属性分配给行内字段或点要素类，但仅行要素具有已分配行为。 为了进行说明，请考虑 shape_length 网络属性以及由 5 个边元素组成的线要素，每个边元素 20 英尺，该线要素的总长度为 100 英尺。 将在所有边上分配此属性。 例如，使用已连接追踪中的函数对此线的 shape_length 属性进行计数将返回计数 5，因为它考虑了每个单独的边元素，而非整条线。 值的分布取决于每个边元素方向上相对于原始要素起点的百分比。
| Boolean |
| 名称 | 说明 | 数据类型 |
| out_trace_network | 更新的追踪网络。 | Trace Network |
添加一个名为 Velocity 且具有双精度属性类型的可分配网络属性。
import arcpy
arcpy.tn.AddNetworkAttribute("Trace Network", "Velocity", "DOUBLE", "APPORTIONABLE")