添加追踪配置 (公共设施网络工具)

汇总

在公共设施网络中创建指定追踪配置。

指定追踪配置用于配置和存储复杂追踪的属性，以供重用和共享。 在公共设施网络中创建的指定追踪配置可以在 ArcGIS Pro 中与追踪工具配合使用，或者通过 追踪窗格中的 指定配置选项卡来使用指定追踪配置。 在企业部署中工作时，指定追踪配置也可以通过 web 地图进行共享并由 web 和外业应用程序使用。

了解有关如何创建指定追踪配置的详细信息

用法

• 输入公共设施网络参数值必须为 5 或更高版本。

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

• 连接的门户账户将设置为指定追踪配置的创建者。 操作系统身份验证用于在单用户部署中使用公共设施网络时存储指定追踪配置的创建者。

  许可：

  活动门户账户必须分配 ArcGIS Advanced Editing 用户类型扩展模块许可，才能在企业部署中使用此工具。

参数

• Dialog
• Python

标注	说明	数据类型
输入公共设施网络	包含新的指定追踪配置的公共设施网络。	Utility Network; Utility Network Layer
追踪配置名称	指定追踪配置的名称。	String
追踪类型	指定将使用的追踪类型。 已连接—将使用从一个或多个起点开始，沿着已连接要素向外跨越的已连接追踪。 这是默认设置。 子网—将使用从一个或多个起点开始并向外跨越以涵盖子网范围的子网追踪。 仅传统域网络支持此追踪类型。 子网控制器—将使用能够定位与子网关联的子网控制器上的源和汇的子网控制器追踪。 仅传统域网络支持此追踪类型。 上游—将使用能够发现网络中某位置上游的要素的上游追踪。 除非选中 使用数字化方向，否则仅传统域网络支持此追踪类型。 下游—将使用能够发现网络中某位置下游的要素的下游追踪。 除非选中 使用数字化方向，否则仅传统域网络支持此追踪类型。 循环—将使用基于连通性从起点向外跨越的循环追踪。 循环是流向不明确的网络区域。 最短路径—将使用能够识别两个起点之间的最短路径的最短路径追踪。 旧版本： 最短路径追踪类型在 ArcGIS Pro 3.7 和 ArcGIS Enterprise 12.1 中已被弃用。 虽然最短路径追踪将继续使用并作为选项直到下一个主要版本发布，但我们建议您使用路径追踪返回最短路径。 路径追踪提供了返回最短路径结果的相同功能，同时还额外提供了在网络中寻找路径功能。 孤立—将使用能够发现孤立网络区域的要素的孤立追踪。 仅传统域网络支持此追踪类型。 路径—将使用能够识别一个或多个起始与终止位置之间的有效路径，或指定起点与终止点之间最短路径的路径追踪。 电路—将使用从电路的起始位置或提供的起始点开始的电路追踪，以返回物理电路和虚拟电路的电路定义和路径信息。 仅电信域网络支持此选项。	String
描述 （可选）	指定追踪配置的描述。	String
标签 （可选）	用于标识指定追踪配置的标签集。 可在搜索和索引中使用此类标签。	String
域网络 （可选）	传统域网络中将运行追踪的层的名称。 运行子网、子网控制器、上游、下游和电路追踪类型时，需要此参数	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 仅适用于交汇点。 换言之，此参数会为追踪指明是否要忽略交汇点和/或边。 交汇点和边 - 过滤器将同时应用于交汇点和边。 这是默认设置。 仅交汇点 - 过滤器将仅应用于交汇点。 仅边 - 过滤器将仅应用于边。 BOTH_JUNCTIONS_AND_EDGES—过滤器将同时应用于交汇点和边。 这是默认设置。 JUNCTIONS_ONLY—过滤器将仅应用于交汇点。 EDGES_ONLY—过滤器将仅应用于边。	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 时，此参数才会启用。 选中—当沿追踪路径遇到嵌套包含关联时，结果中仅返回遇到次数最多并包括第一个空间容器的容器。 如果空间容器不存在，则所有给定网络元素的非空间容器都将包含在结果中。 未选中—所有容器都将在结果中返回。 这是默认设置。	Boolean
结果类型 （可选）	指定追踪返回的结果的类型。 选择—追踪结果将作为相应网络要素上的选择集返回。 这是默认设置。 聚合几何—追踪结果按几何类型聚合，并存储在活动地图的图层中显示的多部件要素类中。 电路—追踪结果将以电路定义形式返回，可选择在指定的输出 .json 文件中包含每个分段的路径连通性信息及几何。 仅电信域网络中的电路追踪支持此选项，可启用 包含几何、 合成几何和 输出 JSON 参数。	String
允许不确定的流 （可选）	指定是否追踪具有不确定流向的要素。 仅在运行上游追踪、下游追踪或孤立追踪时应用此参数。 选中—将追踪具有不确定流向的要素。 这是默认设置。 未选中—具有不确定流向的要素将停止可遍历性并且不会被追踪。	Boolean
验证可定位性 （可选）	指定如果遇到非空间交汇点或边对象并且其关联层次结构中没有必要的连通性、包含或附件关联，是否在追踪操作期间返回错误。 此参数确保可以通过与要素或其他可定位对象的关联来定位追踪操作返回的非空间对象。 选中—如果遇到无法定位的非空间交汇点或边对象并且其关联层次结构中没有必要的连通性。包含或附件关联，则追踪将返回一条错误。 未选中—追踪不会检查是否存在无法定位的对象并返回结果，无论遍历要素的关联层次结构中是否存在无法定位的对象。 这是默认设置。	Boolean
使用数字化方向 （可选）	指定上游和下游追踪操作是否将使用线的数字化方向、关联中边对象的“起始”和“终止”全局 ID 以及“流向”属性来确定流向。 当 trace_type 参数设置为 UPSTREAM 或 DOWNSTREAM 选项时，此参数仅适用于 Utility Network 版本 7 及更高版本。 注: 对于企业级地理数据库，此参数需要 ArcGIS Enterprise 11.3 或更高版本。 选中—追踪操作将使用线的数字化方向、关联中边对象的“起始”和“结束”全局 ID 以及流向属性来确定流向。 选中此项后，domain_network、tier 和 target_tier 参数将被忽略。 未选中—跟踪操作将根据子网控制器的位置确定流向。 这是默认设置。	Boolean
合成几何 （可选）	指定是否为作为跟踪操作的一部分遍历的关联和边缘对象推断和创建（合成）几何。 此参数仅适用于聚合几何结果类型。 注: 对于企业级地理数据库，此参数需要 ArcGIS Enterprise 11.3 或更高版本。 选中—将为输出 Trace_Results_Aggreerated_Lines 要素类中遍历的关联和边对象推断并创建几何。 未选中—不会为遍历的关联和边对象合成几何。 这是默认设置。	Boolean
路径数 （可选）	路径追踪中给定的一组起点和终点之间将返回的最大路径数。 默认值为 2。 仅当将 追踪类型参数设置为 路径时，此参数才会处于活动状态。 注: 对于企业级地理数据库，此参数需要 ArcGIS Enterprise 12.1 或更高版本。	Long
最大跳数 （可选）	路径中允许的边之间的最大跳数（不包括起点）。 所有边以及交汇点-交汇点连通性关联在遍历时均被评估为具有固定单位长度 1。 默认值为 100。 仅当将 追踪类型参数设置为 路径时，此参数才会处于活动状态。 注: 对于企业级地理数据库，此参数需要 ArcGIS Enterprise 12.1 或更高版本。	Long
电路名称 （可选）	将在电信域网络中运行电路追踪的电路的名称。 注: 对于企业级地理数据库，此参数需要 ArcGIS Enterprise 12.0 或更高版本。	String
推断连通性 （可选）	指定路径追踪是否将使用连通性推断来遍历包含关联并确定指定的起始位置与停止位置之间的路径。 电信域网络中的路径追踪支持此参数，可实现在未明确提供连通性信息时发现分段间的路径。 有关详细信息，请参阅推断连通性。 选中—当连通性不完整阻碍遍历时，路径追踪将使用连通性推断来遍历包含关联并识别指定的起始位置与停止位置之间的路径。 未选中—将不会使用连通性推断来识别指定的起始位置与停止位置之间的路径。 这是默认设置。	Boolean

派生输出

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

环境

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

许可信息

• 基本: 否
• 标准: 是
• 高级: 是

相关主题

• “追踪配置”工具集概览
• 查找地理处理工具