追踪 (公共设施网络工具)

汇总

可根据指定起点的连通性或可遍历性返回公共设施网络的网络要素。

您可通过公共设施网络追踪功能分析网络中的路径。 可遍历性是指通过已连接或已关联的要素建立的路径，同时满足配置要求。

默认情况下，追踪结果将作为选择返回，并包含整个线要素。 为了返回与沿边放置的追踪位置（例如起点、停止点和障碍）相关的部分要素结果，请将结果类型参数设置为 聚合几何。 当边对象为线要素的内容时，使用 合成几何参数，沿边对象中跨放置的追踪位置可用于返回部分几何。

使用 聚合几何选项，沿边放置的起点将从具有中跨连通性的上一个交汇点或端点返回边元素。 如果在选中 包括障碍要素参数的情况下沿边放置障碍，追踪将在遇到中跨连通性的下一个交汇点或线终点处停止。 如果未选中 包括障碍要素参数，则追踪将在遇到中跨连通性的上一个交汇点或上一个线终点处停止。

然后，可以将追踪生成的结果选择集或输出要素类传播到另一个地图或网络的逻辑示意图，或者将其用作另一个工具或追踪的输入。

了解有关追踪公共设施网络的详细信息

用法

• 必须启用网络拓扑。 由于 追踪工具依赖于网络拓扑，如果对脏区进行追踪，则追踪的结果可能不精确。 待追踪区域的网络拓扑必须经过验证以反映对网络进行的最近编辑或更新。

• 使用企业级地理数据库时，输入公用设施网络必须是公共设施网络服务。

• 通过 Python 在传统域网络中运行使用 追踪工具的基于子网的追踪时，输入层的子网追踪配置不自动应用，而必须手动指定。

• 对于过滤器障碍、过滤器函数障碍、函数和输出条件，当使用分配给日期字段的网络属性时，日期值应采用格式 yyyy-mm-dd hh:mm:ss，例如，2020-10-12 18:45:31。

参数

• Dialog
• Python

标注	说明	数据类型
输入公共设施网络	将运行追踪的公共设施网络。 使用企业级地理数据库时，输入公共设施网络必须来自要素服务；不支持来自数据库连接的公共设施网络。	Utility Network; Utility Network Layer
追踪类型	指定将使用的追踪类型。 已连接—将使用从一个或多个起点开始，沿着已连接要素向外跨越的已连接追踪。 这是默认设置。 子网—将使用从一个或多个起点开始并向外跨越以涵盖子网范围的子网追踪。 仅传统域网络支持此选项。 子网控制器—将使用能够定位与子网关联的子网控制器上的源和汇的子网控制器追踪。 仅传统域网络支持此选项。 上游—将使用能够发现网络中某位置上游的要素的上游追踪。 除非选中 使用数字化方向参数，否则仅传统域网络支持此选项。 下游—将使用能够发现网络中某位置下游的要素的下游追踪。 除非选中 使用数字化方向参数，否则仅传统域网络支持此选项。 循环—将使用基于连通性从起点向外跨越的循环追踪。 循环是流向不明确的网络区域。 最短路径—将使用能够识别两个起点之间的最短路径的最短路径追踪。 旧版本： 最短路径追踪类型在 ArcGIS Pro 3.7 和 ArcGIS Enterprise 12.1 中已被弃用。 虽然最短路径追踪将继续使用并作为选项直到下一个主要版本发布，但我们建议您使用路径追踪返回最短路径。 路径追踪提供了返回最短路径结果的相同功能，同时还额外提供了在网络中寻找路径功能。 孤立—将使用能够发现孤立网络区域的要素的孤立追踪。 仅传统域网络支持此选项。 路径—将使用能够识别一个或多个起始与终止位置之间的有效路径，或指定起点与终止点之间最短路径的路径追踪。 电路—将使用从电路的起始位置或提供的起始点开始的电路追踪，以返回物理电路和虚拟电路的电路定义和路径信息。 仅电信域网络支持此选项。	String
起点 （可选）	使用 追踪窗格中的 开始选项卡创建的要素图层，或包含一个或多个表示追踪起点的记录的表或要素类。 该要素类或表必须包含 FEATUREGLOBALID 字段，用于存储来自关联网络要素的信息。 默认情况下，会使用工程默认地理数据库中的 UN_Temp_Starting_Points 要素类。	Feature Layer; Table View
障碍 （可选）	使用 追踪窗格中的 障碍选项卡创建的要素图层，或包含一个或多个表示防止追踪遍历超出此点的障碍的记录的表或要素类。 该要素类或表必须包含 FEATUREGLOBALID 字段，用于存储来自关联网络要素的信息。 默认情况下，会使用工程默认地理数据库中的 UN_Temp_Barriers 要素类。	Feature Layer; Table View
域网络 （可选）	将运行追踪的域网络的名称。 运行子网、子网控制器、上溯、下溯和电路追踪类型时，需要此参数。	String
层 （可选）	追踪在传统域网络中开始的层级名称。 运行子网、子网控制器、上游和下游追踪类型时，需要此参数。	String
目标层 （可选）	在定向追踪中，输入层级将流向的目标层级在传统域网络中的名称。 如果未指定上游和下游追踪中的此参数，当到达起始子网边界时，上述追踪将停止。 该参数可以使此类追踪在层级结构中继续向上或向下延伸。	String
子网名称 （可选）	在传统域网络中运行追踪的子网名称。 运行子网追踪类型时可以使用此参数。 当不使用 起点参数时，需要此参数。 当子网表包含层级的 10,000 条或更多记录时，不会填充参数的选择列表，并且会为子网名称提供一个空字段。	String
最短路径网络属性名称 （可选）	在使用路径或最短路径追踪类型时，用于计算最短路径的网络属性。 可以使用数字网络属性（例如形状长度）来计算最短路径。 基于成本和距离的路径都可以进行计算。 此参数对于路径追踪是可选的，但在运行最短路径追踪时是必需的。	String
包括容器 （可选）	指定追踪结果中是否包含容器要素。 选中—追踪结果中将包含容器要素。 未选中—追踪结果中将不包含容器要素。 这是默认设置。	Boolean
包括内容 （可选）	指定追踪是否将在结果中返回容器要素的内容。 选中—追踪结果将包含容器要素中的内容。 未选中—追踪结果将不包含容器要素中的内容。 这是默认设置。	Boolean
包括结构 （可选）	指定追踪结果中是否包含结构要素和对象。 选中—追踪结果中将包含结构要素和对象。 未选中—追踪结果中将不包含结构要素和对象。 这是默认设置。	Boolean
包括障碍要素 （可选）	指定追踪结果中是否包含可遍历性障碍要素。 即使已在子网定义中进行了预设，可遍历性障碍仍可选。 此参数不适用于具备终端的设备要素。 选中—追踪结果中将包含可遍历性障碍要素。 这是默认设置。 未选中—追踪结果中将不包含可遍历性障碍要素。	Boolean
验证一致性 （可选）	指定如果在任何遍历的要素中遇到脏区是否返回错误。 这是保证追踪通过网络中状态一致要素的唯一方法。 要移除脏区，请验证网络拓扑。 选中—如果在任何遍历的要素中遇到脏区，追踪将返回错误。 这是默认设置。 未选中—无论是否在遍历的要素中遇到脏区，追踪都将返回结果。	Boolean
条件障碍 （可选）	基于与网络属性的比较或对类别字符串的检查，对要素设置可遍历性障碍条件。 条件障碍根据网络属性或类别、操作符、类型及属性值来定义。 例如，当要素的 Device Status 属性等于特定值 Open 时，将停止追踪。 当要素满足此条件时，追踪将停止。 如果您要使用多个属性，可使用 组合方法参数来定义 And 或 Or 条件。 了解有关使用多条件表达式的详细信息 值表列： 名称—按网络属性名称过滤。 运算符—按运算符过滤。 等于—属性与值相等。 不等于—属性与值不相等。 大于—属性大于值。 大于或等于—属性大于或等于值。 小于—属性小于值。 小于或等于—属性小于或等于值。 包括值（按位与等于值）—值中的所有位都存在于属性中的“按位与”运算（按位与 == 值）。 不包括值（按位与不等于值）—并非值中的所有位都存在于属性中的“按位与”运算（按位与 != 值）。 包括任何值（按位与等于 True）—值中至少有一位存在于属性中的“按位与”运算（按位与 == True）。 不包括任何值（按位与等于 False）—值中的所有位均未存在于属性中的“按位与”运算（按位与 == False）。 类型—按特定类型过滤。 特定值—按特定值或网络类别过滤。 网络属性—按网络属性过滤。 值—按特定值过滤。 使用以下内容进行结合—使用此参数可合并多个条件障碍。 And—合并条件障碍。 Or—满足任一条件障碍时使用。	Value Table
函数障碍 （可选）	基于函数对要素设置可遍历性障碍。 函数障碍可用于执行以下操作：限制追踪距离起点的行程或设置停止追踪的最大值。 例如，所经过的每条线的长度和为目前经过的总距离。 当经过的总长度达到指定值时，追踪将停止。 值表列： 函数—按函数过滤。 最小值—将识别输入值的最小值。 最大值—将识别输入值的最大值。 平均值—将计算输入值的平均值。 计数—将识别要素数。 加—将计算输入值的总和。 减—将计算输入值之间的差值。 子网控制器和循环追踪类型不支持减法函数。 属性—按网络属性过滤。 运算符—按运算符过滤。 等于—函数结果等于该值。 不等于—函数结果不等于该值。 大于—函数结果大于该值。 大于或等于—函数结果大于或等于该值。 小于—函数结果小于该值。 小于或等于—函数结果小于或等于该值。 包括值（按位与等于值）—值中的所有位都存在于属性中的“按位与”运算（按位与 == 值）。 不包括值（按位与不等于值）—并非值中的所有位都存在于属性中的“按位与”运算（按位与 != 值）。 包括任何值（按位与等于 True）—值中至少有一位存在于属性中的“按位与”运算（按位与 == True）。 不包括任何值（按位与等于 False）—值中的所有位均未存在于属性中的“按位与”运算（按位与 == False）。 值—按特定值过滤。 使用局部值—布尔值将使用本地变量而不是全局变量。	Value Table
应用可遍历性至 （可选）	指定可遍历性是否应用于交汇点和/或边。 例如，如果定义了用于停止追踪的条件障碍，其中 Device Status 等于 Open 并将遍历范围仅设置为边，则即使追踪遇到开路设备，追踪也不会停止，因为 Device Status 仅适用于交汇点。 换言之，此参数会为追踪指明是否要忽略交汇点和/或边。 交汇点和边—可遍历性将同时应用于交汇点和边。 这是默认设置。 仅交汇点—可遍历性将仅应用于交汇点。 仅边—可遍历性将仅应用于边。	String
过滤器障碍 （可选）	用于指定针对特定类别或网络属性的追踪停止时间。 例如，针对生命周期状态属性等于特定值的要素，追踪停止。 此参数用于根据系统中定义的网络属性值设置终止符。 如果要使用多个属性，可使用 组合方法选项来定义 And 或 Or 条件。 了解有关使用多条件表达式的详细信息 值表列： 名称—按网络属性名称过滤。 运算符—按运算符过滤。 等于—属性与值相等。 不等于—属性与值不相等。 大于—属性大于值。 大于或等于—属性大于或等于值。 小于—属性小于值。 小于或等于—属性小于或等于值。 包括值（按位与等于值）—值中的所有位都存在于属性中的“按位与”运算（按位与 == 值）。 不包括值（按位与不等于值）—并非值中的所有位都存在于属性中的“按位与”运算（按位与 != 值）。 包括任何值（按位与等于 True）—值中至少有一位存在于属性中的“按位与”运算（按位与 == True）。 不包括任何值（按位与等于 False）—值中的所有位均未存在于属性中的“按位与”运算（按位与 == False）。 类型—按特定类型过滤。 特定值—按特定值过滤。 网络属性—按网络属性过滤。 值—按特定值过滤。 使用以下内容进行结合—使用此参数可合并多个过滤器障碍。 And—合并条件障碍。 Or—满足任一条件障碍时使用。	Value Table
过滤器函数障碍 （可选）	用于过滤特定类别的追踪结果。 值表列： 函数—按函数过滤。 最小值—将识别输入值的最小值。 最大值—将识别输入值的最大值。 平均值—将计算输入值的平均值。 计数—将识别要素数。 加—将计算值的总和。 减—将计算值之间的差值。 子网控制器和循环追踪类型不支持减法函数。 属性—按网络属性过滤。 运算符—按运算符过滤。 等于—属性与值相等。 不等于—属性与值不相等。 大于—属性大于值。 大于或等于—属性大于或等于值。 小于—属性小于值。 小于或等于—属性小于或等于值。 包括值（按位与等于值）—值中的所有位都存在于属性中的“按位与”运算（按位与 == 值）。 不包括值（按位与不等于值）—并非值中的所有位都存在于属性中的“按位与”运算（按位与 != 值）。 包括任何值（按位与等于 True）—值中至少有一位存在于属性中的“按位与”运算（按位与 == True）。 不包括任何值（按位与等于 False）—值中的所有位均未存在于属性中的“按位与”运算（按位与 == False）。 值—按特定值过滤。 使用局部值—布尔值将使用本地变量而不是全局变量。	Value Table
将过滤器应用于 （可选）	指定是否在交汇点、边或这两处应用特定类别的过滤器。 例如，如果定义了用于停止追踪的过滤器障碍，其中 Device Status 等于 Open 并将遍历范围设置为仅边，则即使追踪遇到开路设备，追踪也不会停止，因为 Device Status 仅适用于交汇点。 换言之，此参数会为追踪指明是否要忽略交汇点和/或边。 交汇点和边 - 过滤器将同时应用于交汇点和边。 这是默认设置。 仅交汇点 - 过滤器将仅应用于交汇点。 仅边 - 过滤器将仅应用于边。 交汇点和边—过滤器将同时应用于交汇点和边。 这是默认设置。 仅交汇点—过滤器将仅应用于交汇点。 仅边—过滤器将仅应用于边。	String
按 bitset 网络属性过滤 （可选）	将用于按 bitset 过滤的网络属性的名称。 此参数仅适用于上游、下游和循环追踪类型。 此参数可用于在追踪过程中添加特殊逻辑，以便追踪能够更好地反映真实世界的场景。 例如，对于循环追踪而言，Phases current 网络属性可以确定该循环是否为实际的电气循环（循环各处均由同一相供电，例如 A 相），并且追踪结果只返回实际的电气循环。 上游追踪的示例如下；如果追踪配电网络时指定 Phases current 网络属性，则追踪结果将只包含在网络属性中指定的有效路径，而不是所有路径。	String
按最近过滤 （可选）	指定是否使用 k-最近邻算法在给定距离内返回一些特定类型的要素。 可以提供计数、成本以及类别和/或资产类型的集合。 选中—将使用 k 最近邻算法来返回 nearest_count、nearest_cost_network_attribute、nearest_categories 或 nearest_assets 参数中指定的一定数量的要素。 未选中—k 最近邻算法不会用于过滤结果。 这是默认设置。	Boolean
计数 （可选）	按最近过滤为选中状态时要返回的要素数量。	Long
成本网络属性 （可选）	当 按最近过滤为选中状态时，将用于计算接近度、成本或距离的数值型网络属性（例如形状长度）。	String
最近类别 （可选）	当 按最近过滤处于选中状态时，将返回的类别（例如保护类别）。	String
最近资产组/类型 （可选）	当 按最近过滤处于选中状态时，将返回的资产组和资产类型，例如，ElectricDistributionDevice/Transformer/Step Down。	String
函数 （可选）	将应用于追踪结果的计算函数。 值表列： 函数—计算函数。 平均值—将计算输入值的平均值。 计数—将识别要素数。 最大值—将识别输入值的最大值。 最小值—将识别输入值的最小值。 加—将计算输入值的总和。 减—将计算输入值之间的差值。 子网控制器和循环追踪类型不支持减法函数。 属性—按网络属性过滤 过滤器名称—按属性名称过滤。 过滤运算符—按运算符过滤。 等于—属性与值相等。 不等于—属性与值不相等。 大于—属性大于值。 大于或等于—属性大于或等于值。 小于—属性小于值。 小于或等于—属性小于或等于值。 包括值（按位与等于值）—值中的所有位都存在于属性中的“按位与”运算（按位与 == 值）。 不包括值（按位与不等于值）—并非值中的所有位都存在于属性中的“按位与”运算（按位与 != 值）。 包括任何值（按位与等于 True）—值中至少有一位存在于属性中的“按位与”运算（按位与 == True）。 不包括任何值（按位与等于 False）—值中的所有位均未存在于属性中的“按位与”运算（按位与 == False）。 过滤器类型—按属性类型过滤。 特定值—按特定值过滤。 网络属性—按网络属性过滤。 过滤值—按特定值过滤。 函数名称—描述函数结果的别名名称。	Value Table
传播程序 （可选）	指定要传播的网络属性以及传播将在追踪过程中的发生方式。 传播的类属性表示子网控制器上已传播至子网余下要素的关键值。 例如，在配电模型中，您可传播相位值。 在电信域网络中，您可以从定义为电路位置的要素中传播波长值。 了解有关按位运算符的详细信息 注: 此参数仅适用于 Python。 值表列： 属性—按网络属性过滤。 替换属性—用于替换的网络属性。 函数—按函数过滤。 运算符—按运算符过滤。 值—按特定值过滤。	Value Table
输出资产类型 （可选）	过滤要包含在结果中的输出资产类型 - 例如，仅返回架空变压器。	String
输出条件 （可选）	按网络属性或类别返回的要素类型。 例如，如果将追踪配置为“过滤掉除水龙头要素外的所有要素”，那么未分配水龙头类别的追踪要素均不会包含在结果中。 任何追踪的要素都会返回到结果选择集中。 了解有关使用多条件表达式的详细信息 值表列： 名称—按网络属性名称过滤。 运算符—按运算符过滤。 等于—属性与值相等。 不等于—属性与值不相等。 大于—属性大于值。 大于或等于—属性大于或等于值。 小于—属性小于值。 小于或等于—属性小于或等于值。 包括值（按位与等于值）—值中的所有位都存在于属性中的“按位与”运算（按位与 == 值）。 不包括值（按位与不等于值）—并非值中的所有位都存在于属性中的“按位与”运算（按位与 != 值）。 包括任何值（按位与等于 True）—值中至少有一位存在于属性中的“按位与”运算（按位与 == True）。 不包括任何值（按位与等于 False）—值中的所有位均未存在于属性中的“按位与”运算（按位与 == False）。 类型—按特定类型过滤。 特定值—按特定值过滤。 网络属性—按网络属性过滤。 值—按特定值过滤。 使用以下内容进行结合—使用此参数可合并多个条件。 And—组合条件。 Or—满足任一条件时使用。	Value Table
包括孤立要素 （可选）	指定在传统域网络中，追踪结果中是否包含孤立要素。 此参数仅在运行孤立追踪时使用。 选中—追踪结果中将包含孤立要素。 未选中—追踪结果中将不包含孤立要素。 这是默认设置。	Boolean
忽略起点处障碍 （可选）	指定是否在追踪配置中忽略起点处的动态障碍。 这在执行上游保护设备追踪并使用所发现的保护设备（屏障）作为起始点以找到后续上游保护设备时可能非常有用。 选中—追踪过程中将忽略起点处的障碍。 未选中—追踪过程中不会忽略起点处的障碍。 这是默认设置。	Boolean
最多包含第一个空间容器 （可选）	指定返回的容器是否仅限于追踪结果中每个网络元素的第一个空间容器（包括第一个空间容器）。 如果没有遇到空间容器，但是存在给定网络元素的非空间容器，则所有非空间容器都将包含在结果中。 仅当将 include_containers 设置为 INCLUDE_CONTAINERS 时，才会启用此参数。 选中—当沿追踪路径遇到嵌套包含关联时，结果中仅返回遇到次数最多并包括第一个空间容器的容器。 如果空间容器不存在，则所有给定网络元素的非空间容器都将包含在结果中。 未选中—所有容器都将在结果中返回。 这是默认设置。	Boolean
结果类型 （可选）	指定追踪返回的结果的类型。 选择—追踪结果将作为相应网络要素上的选择集返回。 这是默认设置。 聚合几何—追踪结果按几何类型聚合，并存储在活动地图的图层中显示的多部件要素类中。 连通性—追踪结果将作为已遍历网络要素的指定输出 .json 文件中的连通图返回。 此选项可以启用 包括几何、 包括域描述和 输出 JSON 参数。 元素—追踪结果将作为遍历网络要素的指定输出 .json 文件中的基于要素的信息返回。 此选项将启用 输出 JSON 参数。 要素—追踪结果将作为遍历网络要素的指定输出 .json 文件中的基于要素的信息返回。 此选项可以启用 包括几何、 包括域描述、 结果网络属性、 结果字段和 输出 JSON 参数。 注: 对于企业级地理数据库，此选项需要 ArcGIS Enterprise 11.1 或更高版本。 包含和附件关联—追踪结果将作为关联信息在指定的输出 .json 文件中返回，这些信息针对的是通过包含和结构附件关联进行关联的遍历网络要素。 此选项可以启用 包含域描述和 输出 JSON 参数。 注: 对于企业级地理数据库，此选项需要 ArcGIS Enterprise 11.1 或更高版本。 相关记录—对于输出 .json 文件中的遍历要素，将通过指定的关系类和字段返回相关对象的值。 此选项可以启用 包括几何、 包括域描述、 关联记录字段和 输出 JSON 参数。 注: 对于企业级地理数据库，此选项需要 ArcGIS Enterprise 11.5 或更高版本。 电路—追踪结果将以电路定义形式返回，可选择在指定的输出 .json 文件中包含每个分段的路径连通性信息及几何。 仅电信域网络中的电路追踪支持此选项，可启用 包含几何、 合成几何和 输出 JSON 参数。	String
选择内容类型	指定如何应用所选内容以及如果已存在当前内容要执行的操作。 新建选择内容—生成的选择内容将替换当前选择内容。 这是默认设置。 添加到当前选择内容—当存在一个选择内容时，会将生成的选择内容添加到当前选择内容中。 如果不存在选择内容，该选项的作用与新选择内容选项的作用相同。 从当前选择内容中移除—将生成的选择内容从当前选择内容中移除。 如果不存在选择内容，该选项不起作用。 选择当前选择内容的子集—将生成的选择内容与当前选择内容进行组合。 仅两者共有的记录保持选中状态。 切换当前选择内容—生成的选择内容将被切换。 所选的结果将从当前选择内容中移除，同时未被选择的结果将添加到当前选择内容中。 如果不存在选择内容，该选项的作用与新选择内容选项的作用相同。	String
清除所有之前的追踪结果 （可选）	指定是将内容从选择用于存储聚合几何的要素类截断还是追加到其上。 此参数仅适用于 聚合几何结果类型。 选中—将截断用于存储聚合追踪几何的要素类。 将仅写入当前追踪操作的输出几何。 这是默认设置。 未选中—当前追踪操作的输出几何将追加到用于存储聚合几何的要素类。	Boolean
追踪名称 （可选）	追踪操作的名称。 此值将存储在输出要素类的 TRACENAME 字段中，以协助识别追踪结果。 此参数仅适用于 聚合几何结果类型。	String
聚合的点 （可选）	包含聚合结果几何的输出多点要素类。 默认情况下，将使用名为 Trace_Results_Aggregated_Points 的系统生成要素类填充该参数，该要素类将存储在工程的默认地理数据库中。 如果该要素类不存在，则系统会自动创建。 也可以使用现有要素类存储聚合几何。 如果使用非默认要素类，则该要素类必须是多点要素类，并且包含名为 TRACENAME 的字符串字段。 此参数仅适用于 聚合几何结果类型。	Feature Class
聚合的线 （可选）	包含聚合结果几何的输出折线要素类。 默认情况下，将使用名为 Trace_Results_Aggregated_Lines 的系统生成要素类填充该参数，该要素类将存储在工程的默认地理数据库中。 如果该要素类不存在，则系统会自动创建。 也可以使用现有要素类存储聚合几何。 如果使用非默认要素类，则该要素类必须是折线要素类，并且包含名为 TRACENAME 的字符串字段。 此参数仅适用于 聚合几何结果类型。	Feature Class
聚合的面 （可选）	包含聚合结果几何的输出面要素类。 默认情况下，将使用名为 Trace_Results_Aggregated_Polygons 的系统生成要素类填充该参数，该要素类将存储在工程的默认地理数据库中。 如果该要素类不存在，则系统会自动创建。 也可以使用现有要素类存储聚合几何。 如果使用非默认要素类，则该要素类必须是面要素类，并且包含名为 TRACENAME 的字符串字段。 此参数仅适用于 聚合几何结果类型。	Feature Class
允许不确定的流 （可选）	指定是否追踪具有不确定流向的要素。 不确定流是指子网中流向模糊或无法确定的区域。 仅在运行上游追踪、下游追踪或孤立追踪时应用此参数。 注: 此参数需要公共设施网络版本值为 5 或更高。 选中—将追踪具有不确定流向的要素。 这是默认设置。 未选中—具有不确定流向的要素将停止可遍历性并且不会被追踪。	Boolean
验证可定位性 （可选）	指定如果遇到非空间交汇点或边对象并且其关联层次结构中没有必要的连通性、包含或附件关联，是否在追踪操作期间返回错误。 此参数确保可以通过与要素或其他可定位对象的关联来定位追踪或更新子网操作返回的非空间对象。 选中—如果遇到无法定位的非空间交汇点或边对象并且其关联层次结构中没有必要的连通性。包含或附件关联，则追踪将返回一条错误。 未选中—追踪不会检查是否存在无法定位的对象并返回结果，无论遍历对象的关联层次结构中是否存在无法定位的对象。 这是默认设置。	Boolean
使用追踪配置 （可选）	指定是否将使用现有指定追踪配置来填充该工具的参数。 注: 此参数需要公共设施网络版本值为 5 或更高。 选中—将使用现有指定追踪配置来定义追踪的属性。 将忽略除 trace_config_name、starting_points 和 barriers 之外的所有参数。 未选中—不使用现有指定追踪配置来定义追踪的属性。 这是默认设置。	Boolean
追踪配置名称 （可选）	将用于定义追踪属性的现有指定追踪配置的名称。 仅当选中 使用追踪配置参数时，才启用此参数。 注: 此参数需要公共设施网络版本值为 5 或更高。	String
输出 JSON （可选）	使用 连通性、 元素、 要素、 包含和附件关联或 相关记录结果类型返回追踪结果时将生成的 .json 文件的名称和位置。	File
在服务器上以异步模式运行 （可选）	指定在使用企业级地理数据库中的公共设施网络时是否异步处理追踪操作。 选中—将异步处理追踪操作。 未选中—将同步处理追踪操作。 这是默认设置。	Boolean
包括几何 （可选）	指定是否在结果中包括几何。 注: 对于企业级地理数据库，此参数需要 ArcGIS Enterprise 11.1 或更高版本。 选中—结果中将包含几何。 未选中—结果中将不包含几何。 这是默认设置。	Boolean
包括域描述 （可选）	指定域描述是否将包含在输出 .json 文件中以传达控制器、要素元素、连通性和关联的域映射。 注: 对于企业级地理数据库，此参数需要 ArcGIS Enterprise 11.1 或更高版本。 选中—将在结果中包含域描述。 未选中—不会在结果中包含域描述。 这是默认设置。	Boolean
结果网络属性 （可选）	将包含在结果中的网络属性。 注: 对于企业级地理数据库，此参数需要 ArcGIS Enterprise 11.1 或更高版本。	String
结果字段 （可选）	要素类中将作为结果返回的字段。 该字段的值将在追踪要素的结果中返回。 注: 对于企业级地理数据库，此参数需要 ArcGIS Enterprise 11.1 或更高版本。 值表列： 要素类—参与公共设施网络的要素类。 字段名—要素类中将在结果中返回其值的字段的名称。	Value Table
使用数字化方向 （可选）	指定上游和下游追踪操作是否将使用线的数字化方向、关联中边对象的“起始”和“终止”全局 ID 以及“流向”属性来确定流向。 当 trace_type 参数设置为 UPSTREAM 或 DOWNSTREAM 选项时，此参数仅适用于 Utility Network 版本 7 及更高版本。 注: 对于企业级地理数据库，此参数需要 ArcGIS Enterprise 11.3 或更高版本。 选中—追踪操作将使用线的数字化方向、关联中边对象的“起始”和“结束”全局 ID 以及流向属性来确定流向。 使用此选项，将忽略在层级上配置的传播程序，也将忽略 domain_network、tier 和 target_tier 参数。 未选中—跟踪操作将根据子网控制器的位置确定流向。 这是默认设置。	Boolean
合成几何 （可选）	指定是否为作为跟踪操作的一部分遍历的关联和边缘对象推断和创建（合成）几何。 此参数仅适用于 聚合几何和 电路结果类型。 注: 对于企业级地理数据库，此参数在与 聚合几何结果类型配合使用时要求 ArcGIS Enterprise 11.3 或更高版本，与 电路结果类型配合使用时要求 ArcGIS Enterprise 12.1 或更高版本。 选中—将为输出 Trace_Results_Aggreerated_Lines 要素类中遍历的关联和边对象推断并创建几何。 未选中—不会为遍历的关联和边对象合成几何。 这是默认设置。	Boolean
停止点 （可选）	使用 追踪窗格中的 结束选项卡创建的要素图层，或包含一个或多个表示路径追踪停止点的记录的表或要素类。 该要素类或表必须包含 FEATUREGLOBALID 字段，用于存储来自关联网络要素的信息。 默认情况下，会使用工程默认地理数据库中的 UN_Temp_Stopping_Points 要素类。 注: 对于企业级地理数据库，此参数需要 ArcGIS Enterprise 12.1 或更高版本。	Feature Layer; Table View
路径数 （可选）	路径追踪中给定的一组起始与终止位置之间将返回的最大路径数。 默认值为 1。 仅当将 追踪类型参数设置为 路径时，此参数才会处于活动状态。 注: 对于企业级地理数据库，此参数需要 ArcGIS Enterprise 12.1 或更高版本。	Long
最大跳数 （可选）	路径中允许的边之间的最大跳数（不包括起点）。 所有边以及交汇点-交汇点连通性关联在遍历时均被评估为具有固定单位长度 1。 终端设备被评估为具有固定单位长度 2。 默认值为 100。 仅当将 追踪类型参数设置为 路径时，此参数才会处于活动状态。 注: 对于企业级地理数据库，此参数需要 ArcGIS Enterprise 12.1 或更高版本。	Long
关联记录字段 （可选）	将作为结果返回的关联对象类的字段。 字段的值将随输出 .json 文件中的遍历要素一起在结果中返回。 值表列： 关系类—与参与公共设施网络的要素类或对象类建立关联关系的关系类。 字段名—相关对象类中将在结果中返回其值的字段的名称。	Value Table
电路名称 （可选）	将在电信域网络中运行电路追踪的电路的名称。 当未使用 起点参数时，这对于电路追踪是必需的。 注: 对于企业级地理数据库，此参数需要 ArcGIS Enterprise 12.1 或更高版本。	String
推断连通性 （可选）	指定路径追踪是否将使用连通性推断来遍历包含关联并识别指定的起始与终止位置之间的路径。 仅电信域网络中的路径追踪支持此参数，可实现在未明确提供连通性信息时发现分段间的路径。 有关详细信息，请参阅推断连通性。 选中—当连通性不完整阻碍遍历时，路径追踪将使用连通性推断来遍历包含关联并识别指定的起始与终止位置之间的路径。 未选中—不使用连通性推断来识别指定的起始与终止位置之间的路径。 这是默认设置。	Boolean
包括流向 （可选）	指定输出 .json 文件中是否包含流向。 如果包含，该文件将包含从子网控制器派生的流向信息，涉及遍历的线、边对象、带终端设备的内部边以及连通性关联。 此参数仅适用于与子网、上游和下游追踪类型一起使用的 连通性、 元素和 要素结果类型选项。 注: 对于企业级地理数据库，此参数需要 ArcGIS Enterprise 12.1 或更高版本。 选中—结果中将包含流向。 未选中—结果中将不包含流向。 这是默认设置。	Boolean
包括传播值 （可选）	指定在运行基于子网的追踪时，输出 .json 文件中是否包含传播值。 此参数仅适用于 要素结果类型。 注: 对于企业级地理数据库，此参数需要 ArcGIS Enterprise 12.1 或更高版本。 选中—结果中将包含传播值。 未选中—结果中将不包含传播值。 这是默认设置。	Boolean

派生输出

标注	说明	数据类型
输出公共设施网络	更新的公共设施网络。	Utility Network

环境

此工具不使用任何地理处理环境。

许可信息

• 基本: 受限
  在使用 ArcGIS Enterprise 授权用户许可时，支持企业部署。
• 标准: 是
• 高级: 是

相关主题

• 公共设施网络工具箱概览
• 查找地理处理工具