配置追踪

追踪公共设施网络的目的是为随时发现并解决有关您网络状态的问题。 要追踪公共设施网络，请使用追踪地理处理工具。

追踪工具提供多种追踪类型：

• 在线
• 子网
• 子网控制器
• 上游
• 下游
• 循环
• 最短路径
• 隔离

除了这些追踪类型以外，追踪工具同时也包含一整套用于细化所提供的每种追踪类型的高级配置。 这些配置可用于建立可遍历性，区分应返回的要素或对象，以及设置要执行的计算。 使用 模型构建器 可保存复杂的配置，并减少模型工具界面上显示的参数数量。 指定追踪配置可用于创建并存储可在整个组织共享的复杂追踪。 这样，您和其他用户仅需一键即可重新运行高级追踪。

在子网定义中设置子网追踪配置，可使追踪工具在对特定层运行追踪时实现自动填充。 此工具适用于基于子网的追踪。 例如，您可能希望子网追踪始终在保护设备处停止，以指示馈电线的末端并计算每个馈电线的总负荷，但可能不希望每次运行基于子网的追踪时都设置这些参数。 因此，系统提供了为一个层中的所有子网定义标准子网定义的功能。 子网定义由管理员在创建层时设置。 在追踪工具中指定层时，系统会自动填充高级参数，同时为输入层设置子网追踪定义。 运行追踪之前，可以在工具中手动覆盖填充的所有追踪配置参数。

在追踪设置期间，您可以对子网追踪配置进行修改或添加。 您可以进行如下操作：控制追踪的要素和对象类型（管道直径大于 6 英寸）、选择您想要返回的网络要素类型（所有打开的阀门）以及使用网络属性执行计算（计算 AB 相位线的长度总和）。

下面的部分将对各配置组件分别进行检查。 有关参数选项和使用方法信息，请参阅追踪工具。

异步运行追踪

从 ArcGIS Pro 2.9 和 ArcGIS Enterprise 10.9.1 开始，在服务器上以异步模式运行参数提供了使用 UtilityNetworkTools 地理处理服务异步处理进程追踪操作的选项。 仅在企业部署中使用公共设施网络时可以使用此选项。 默认情况下，系统将以同步方式处理追踪操作。

配置选项	描述
在服务器上以异步模式运行	选中 - 将异步处理追踪操作。 未选中 - 将同步处理追踪操作。 这是默认设置。

定义追踪区域

在追踪工具中，必须指定追踪在您的网络中允许行进的区域。 定义可追踪区域有助于确保追踪网络的预期部分。 也可将其用于限制某些追踪类型遍历到其他层。 三个信息片段将用于表示可追踪区域的范围：域网络、层和子网。 追踪类型决定了所需的信息片段，因此并非所有追踪都会具备这些参数。

指定域网络将限制为只追踪该域网络。 所有基于子网的追踪都需要设置一个域网络。 一些追踪要求指定层，且在一些情况下会要求指定子网。 其他追踪类型要求设置层和目标层（上游和下游）。 目标层支持沿域网络中的多个层进行追踪。

通过在追踪工具中指定层参数，可以将追踪范围限制为特定层。 借助此参数，还可以使用为子网定义设置的值来自动填充追踪配置参数。 如果将起点与层参数结合使用，则起点必须位于指定层内。 目标层参数用于上溯和下溯追踪，表示可追踪网络的边界；追踪可在目标层中遍历，但不能超过目标层。

当跨多个层进行追踪时，将加载初始层的追踪配置设置。 对于追踪遇到的每个新层，将加载以下追踪配置设置：

• 可遍历性范围
• 条件障碍
• 函数障碍
• 传播程序

对于子网追踪，通过提供子网名称值可指定要追踪的子网，而不必使用起点。 此方法使用子网控制器或指定子网的控制器作为追踪的起点。

在结果中包括容器、内容、结构和障碍

追踪工具中的可配置选项集可用于配置在结果中包含基于关联角色或障碍状态的网络要素。 关联要素可包括容器、内容和结构。 默认情况下，除了容器、容器中的内容和结构以外的其他内容都将在追踪结果中返回。

包括容器

在追踪结果中包含容器。 追踪的所有内容要素和对象容器都将包括在追踪结果中。 此配置还可以用于追踪结构网络，例如，返回连接的地下管道。

配置选项	描述
包括容器	选中 - 追踪结果中将包含容器网络要素。 未选中 - 追踪结果中将不包含容器网络要素。 这是默认设置。

最多包含第一个空间容器

指定是否将已返回的容器限制为仅在追踪结果中包含那些所遇到的容器，且最多包含每个网络元素的第一个空间容器。 如果没有遇到空间容器，但是给定网络元素存在非空间容器，则所有非空间容器都将包含在结果中。 此参数仅在已启用包括容器时可用。

配置选项	描述
最多包含第一个空间容器	选中 - 当沿着追踪路径遇到嵌套的包含关联时，返回追踪结果中网络元素的所有容器，且最多包含第一个空间容器。 如果空间容器不存在，则所有给定网络元素的非空间容器都将包含在结果中。 未选中 - 所有容器都将返回到结果中。 这是默认设置。

包括内容

在追踪结果中包括内容要素和对象。 这包括追踪结果中包含的容器中的内容。 要明确不同类型的容器，使用输出过滤器过滤结果。

配置选项	描述
包括内容	选中 - 追踪结果中将包含容器网络要素的内容。 未选中 - 追踪结果中将不含容器网络要素的内容。 这是默认设置。

包括结构

在追踪结果中包括结构。 这有助于报告结构资产之类的任务。

配置选项	描述
包括结构	选中 - 追踪结果中将包含结构要素和对象。 未选中 - 追踪结果中将不包含结构要素和对象。 这是默认设置。

包括障碍要素

在追踪结果中包括障碍。 这涵盖在追踪窗格的障碍选项卡上设置的要素障碍以及所有动态配置的障碍，包括：条件障碍、函数障碍、过滤器障碍和过滤器函数障碍。 子网定义可用于配置障碍是否作为子网追踪配置的一部分包括在追踪结果中。

注：

如果将障碍放置在具有中跨连通性的边要素上并取消选中包括障碍要素选项，由追踪返回的选择集可能会显示意外结果。 如果追踪返回了要素的任何部分，则将选择整个要素并将其显示在追踪结果中。

配置选项	描述
包括障碍要素	选中 - 追踪结果中将包含障碍要素。 这是默认设置。 未选中 - 追踪结果中将不包含障碍要素。 注： 此追踪配置选项也受基于子网的追踪类型的子网追踪配置影响。 将在指定层参数时加载此选项。

注：

包括障碍要素配置选项不适用于具备终端的要素。

忽略起点处障碍

如果追踪配置中的障碍是起点，则将其忽略。 这在执行上游保护设备追踪并使用所发现的保护设备（屏障）作为起始点以找到后续上游保护设备时可能非常有用。

配置选项	描述
忽略起点处障碍	选中 - 追踪过程中将忽略起点处的障碍。 未选中 - 追踪过程中不会忽略起点处的障碍。 这是默认设置。

配置资源流

在公共设施网络中执行定向追踪时，了解资源如何沿网络边流动至关重要。 当您创建公共设施网络或将其升级到版本 7 或更高版本时，将提供使用数字化方向参数来执行上游和下游追踪。 如果使用的模型依靠线的数字化方向来确定资源在网络中的流向，该选项可能非常有用。 如果您当前正在使用子网控制器对流进行建模，请勿使用此选项。 默认情况下，公共设施网络中的追踪操作根据子网控制器的位置确定流量。

选中此项后，域网络、层和目标层参数将被隐藏并忽略。 当追踪类型为上游或下游时，此参数仅适用于公共设施网络版本 7 及更高版本。

配置选项	描述
使用数字化方向	选中 - 追踪操作将使用线的数字化方向、关联中边对象的“起始”和“结束”全局 ID 以及流向属性来确定流向。 未选中 - 追踪操作将根据子网控制器的位置确定流向。 这是默认设置。

确保网络一致性

网络的一致区域不含任何脏区。 验证网络拓扑是保证追踪从网络拓扑读取有关您的网络的最新信息的唯一方法。 一些追踪类型要求您追踪的子网也为清洁子网。 有关详细信息，请参阅子网生命周期。

追踪工具中验证一致性选项可用于确保追踪结果与网络拓扑相一致。 当验证一致性设置为 true 时，如果任何脏区与追踪路径相交，则追踪操作将失败。 发生这种情况时，该工具将返回一个错误，其中包括被发现是脏区的追踪路径中任何要素或对象的类名称和全局 ID，如以下示例所示：

ERROR 002041: One or more dirty areas were discovered.
[[ElectricDistributionLine: {C0060506-AG17-4B64-B2E0-9162BE613C05}]]
Failed to execute (Trace).

以下情况不会导致追踪结果中产生有关不一致性的错误：

• 来自新创建的要素的脏区。
• 包括容器或包括结构选项未启用时的来自相关容器或结构的脏区。

要清理和移除脏区，请验证网络拓扑。

在不选中验证一致性复选框的情况下运行追踪可能导致意外的追踪结果。 请考虑以下示例情况：在一个网络中删除了某个要素，破坏了位置 A 到位置 B 的唯一路径。 系统为删除的要素创建了一个脏区，但是在验证网络拓扑之前，以位置 A 为起点运行了一次追踪以查找连接的要素，且运行时未选中验证一致性选项。 在这种情况下，追踪可以到达位置 B，且工具运行完成，未产生警告。 可以到达位置 B 是因为未通过运行验证操作将连接 A 和 B 的要素的删除反映在网络拓扑中。

如果在以上示例中选中验证一致性选项，当追踪到达标记删除要素的脏区时，追踪将失败，并会返回错误以告知您遇到脏区。 当被追踪区域已经验证了拓扑之后，则追踪无法到达位置 B，因为被删除要素已经反映到了网络拓扑中。 如果未针对要追踪区域的整个范围来验证网络拓扑，则可能会遇到其他脏区。

即使网络拓扑中的信息是可追踪区域的最新信息，子网也可能是脏子网。 请确保可追踪子网也进行了更新。 要了解详细信息，请参阅更新子网。

配置选项	描述
验证一致性	选中此选项时，追踪将失败，并且工具会在有任何脏区与追踪路径相交时返回错误。 如果不选中此选项，则会忽略脏区。 此选项默认为选中。

确保非空间对象的可定位性

关联用于确定位置，并在视觉上表示在地图上非空间交汇点和边对象。 如果删除此关联，可能会导致交汇点或边对象无法定位的情况。 追踪中的验证可定位性选项和设置子网定义工具能够识别对象，而无需在遍历对象的关联层次结构中进行必要的包含、附加或连通性关联。

当验证可定位性设置为 true 时，如果在追踪路径中未发现不可定位对象，则追踪操作将失败并显示一条错误。 发生这种情况时，该工具将返回一个错误，其中包括追踪路径中的不可定位对象的类名称和全局 ID，如以下示例所示：

ERROR 003326: Unlocatable objects discovered.
[[GasDistributionJunctionObject: {4F860903-PK17-5c15-Y2W0-3512BP436C00}]]
Failed to execute (Trace).

修改关联窗格可用于为被视为可定位的对象创建必要的关联。

要了解详细信息，请参阅可定位性。

配置选项	描述
验证可定位性	选中此选项时，追踪将失败，并且工具会在发现任何不可定位对象时返回错误。 如果未选中此选项，则不会对不可定位对象执行检查。 此选项默认为不选中。

控制追踪内容

在追踪过程中，可以使用障碍来表示停止位置；将不会追踪超出此位置范围的网络要素。 追踪结果不包括经过障碍的网络要素，但可选择包含障碍本身。 其他参数（例如允许不确定流向以及那些在可遍历性部分中找到的参数）有助于定义控制网络路径可遍历性的因素。

允许不确定的流

在执行上游、下游或分离追踪时，存在无法确定具体流向的场景。 当使用子网控制器对流向进行建模时，具有循环的场景被定义为不确定。 同样，当使用使用数字化方向参数执行上游或下游追踪时，具有设置为 Indeterminate 的 Flow direction 属性的线或边对象也被定义为不确定。

默认情况下，当选中允许不确定流向参数时，追踪结果中将包括不确定流向的要素和对象。 如果未选中此选项，具有不确定流向的这些网络要素将停止可遍历性并且不会被包括在追踪结果中。 此参数仅在运行上溯追踪、下溯追踪或分离追踪时使用。

配置选项	描述
允许不确定的流	选中 - 将追踪具有不确定流向的要素和对象。 这是默认设置。 未选中 - 具有不确定流向的要素和对象将停止可遍历性并且不会被追踪。

可遍历性

追踪工具的可遍历性部分包括条件障碍和函数障碍，用于控制追踪的可遍历性。 条件障碍指基于网络属性或网络类别的表达式，用于定义追踪的停止位置。 函数屏障用于定义满足条件时追踪的停止时间。

可遍历性范围由追踪工具中的可遍历性范围参数应用可遍历性至进一步控制。 此参数用于确定可遍历性是否应用于交汇点和/或边。 例如，如果可遍历性仅应用于交汇点，且边满足条件障碍中指定的条件，则根据可遍历性范围，追踪不会在边处停止。

有关详细信息，请参阅障碍。

设置函数

函数是一种追踪配置属性，可用于在与被追踪网络要素相关联的网络属性上运行计算，例如，所有追踪的电线的总长度。 可为追踪指定多个函数。

另外，可选网络属性过滤器可添加到每个函数中；当被指定后，函数仅会被应用到满足网络属性过滤器的网络要素。 函数中的过滤器可用来引入条件要求，例如，可以将 Phases Current 属性包含值 A、B 和 C 的所有线的长度加起来。

注：

使用具有函数（Add、Average、Count、Max、Min 和 Subtract）的已分配网络属性的追踪配置可返回基于边元素的可分配结果。 例如，使用已连接追踪中的函数对 shape length 属性进行计数可返回基于各个边要素（而非整行）的计数。 有关详细信息，请参阅可分配网络属性。

控制返回的内容

要控制追踪结果中返回的内容，请使用输出过滤器。

输出过滤器

输出过滤器将筛选追踪过程中遇到的每个网络要素，以确定其是否满足过滤器中指定的条件。 例如，追踪将返回从电网起点开始的所有上游保护设备。

追踪工具中提供以下两种类型的输出过滤器：输出资产类型和输出条件。

输出资产类型过滤器用于仅包括追踪结果中指定的资产类型。 例如，电网的电线杆报告会包含一个输出资产类型过滤器，且结果中将仅包含电线杆。

输出条件过滤器支持网络类别和网络属性。 例如，输出条件将使用特定网络类别名称来返回天然气网络中的所有隔离设备。 此操作将返回已分配隔离网络类别的所有要素和对象。 针对天然气网络的追踪可以返回应急阀、旁通阀、系统阀或短止回阀。 虽然也会追踪不属于此网络类别的要素和对象，但是不会将其包括在结果中。

网络属性存储在网络拓扑中，并与一个或多个网络类中的字段相关联。 在输出条件中，可以指定网络属性的名称、运算符以及对于网络属性有效的值。 如果供水管网中出现泄漏，则网络属性为用于返回可挤压管道的输入。 在这种情况下，线类具有名为 Pinchable 的字段。 该字段与名为 Pinchable 的网络属性相关联。 可将输出条件参数配置为查找具有 Pinchable 网络属性且值为 True 的类。 追踪结果中包含具有此字段且值为 True 的类中的要素和对象，同时也包括不具有 Pinchable 字段的类中的网络要素。

如果给定输出条件中网络属性的行为，要返回可挤压管道，则需要使用“输出资产类型”过滤器。 例如，在 Esri 提供的天然气公共设施网络中，可以在“分配管道”资产组中的 PipelineLine 类中指定塑料 PE 资产类型。 利用两个过滤器 IsPinchable = True AND AssetType = Plastic PE，追踪结果将仅包含塑料 PE 可挤压管道。

通过使用组合使用参数，可以执行多个输出条件值。 可以使用两种类型的输出，并且可以设置多个输出类型。 组合多种输出类型可用于返回所有超过 80 PSI 的 12 英寸塑料 PE 可挤压管道。

了解有关使用多条件表达式的详细信息

结果类型

通过结果类型参数（可选），您可以控制追踪返回的结果类型。

可以分别指定或同时指定聚合几何、选择、连通性、元素、要素以及包含和附件关联结果类型，从而相应地实现以下功能：生成输出几何，为追踪操作创建选择集，返回通过几何重叠或连通性关联连接的网络要素的连通图，返回要素相关信息，返回包含几何、网络属性和字段信息的要素相关信息，或者返回通过包含和结构附件关联连接至 .json 文件的要素。

参数

选项

结果类型

选择内容 - 追踪操作的结果将作为相应网络要素上的选择集返回。 这是默认设置。 聚合几何 - 追踪操作的结果按几何类型聚合，并存储在活动地图的图层中显示的多部分要素类中。 连通性 - 针对遍历的网络要素，追踪结果将在指定的输出 .json 文件中以连通图的形式返回。 元素 - 针对遍历的网络要素，追踪结果将在指定的输出 .json 文件中以要素相关信息的形式返回。 要素 - 追踪结果将在指定的输出 .json 文件中以要素相关信息的形式返回，可以选择包含所遍历网络要素的要素几何、网络属性信息和字段值。 包含和附件关联 - 针对所遍历的具有包含和结构附件关联的网络要素，追踪结果将在指定的输出 .json 文件中以关联信息的形式返回。 注： 使用企业级地理数据库时，必须满足以下要求： 连通性选项需要 ArcGIS Enterprise 10.9.1 或更高版本。 要素和包含和附件关联选项需要 ArcGIS Enterprise 11.1 或更高版本。

聚合几何选项用于追踪可在要素类中作为多部分几何返回的结果。 此选项支持线要素和边对象的中跨上放置的起点和障碍的位置返回部分要素结果。

查看下面的图像，以比较下溯追踪中选择内容和聚合几何结果类型选项之间的差异。 下面的网络包含五个线要素（表示为 f1、f2、f3、f4 和 f5），而这些线要素由九个边元素（表示为 e1、e2、e3，以此类推）组成。

在此包含障碍要素的示例中，选择结果将返回由九个边元素组成的七个点要素和五个线要素（f1::e1,e2,e3、f2::e1,e2 和 f5::e1,e2）。 聚合几何结果将返回相同的要素，但不包括边元素 f1::e1,e2 和 f5::e2。

在选中包括障碍要素配置选项的情况下沿着边放置障碍时，追踪将在障碍要素处停止，并在追踪结果中返回边的部分要素几何。 如果未选中包括障碍要素选项，则追踪将在中跨连通性遇到的前一个线端点或交汇点处停止。

下例显示了使用包括障碍要素选项在追踪结果中包括或排除障碍要素的差异。 在此示例中，起点和障碍都沿着边放置。 启用此选项后，选择结果将返回由九个边元素组成的六个点要素和五个线要素（f1::e1,e2,e3、f2::e1,e2、f3::e1、f4::e1 和 f5::e1,e2）。 聚合几何结果将返回相同的五个要素，但不包括边元素 f1::e1 和 f5::e2。返回边元素 f1::e2 的部分几何。 如果您通过取消选中包括障碍要素来排除障碍要素，则选择结果可能会更改；聚合几何结果将另外排除 f1::e2。

当针对结果类型选择了聚合几何选项时，提供了六个附加参数来定义追踪输出行为。

• 清除所有之前的追踪结果
• 合成几何
• 追踪名称
• 聚合的点
• 聚合的线
• 聚合的面

清除所有先前追踪结果复选框提供了一个选项，用于截断或附加到为存储聚合几何而选择的要素类的内容

参数	选项
清除所有之前的追踪结果	选中 - 将截断用于存储聚合追踪几何的要素类。 将仅写入当前追踪操作的输出几何。 这是默认设置。 未选中 - 当前追踪操作的输出几何将追加到用于存储聚合几何的要素类。

合成几何参数允许您通过在聚合几何输出中合成几何来可视化追踪期间遍历的关联路径和边对象。

边对象的几何可以通过两种方式合成。 当边对象是线的内容时，从空间容器推断几何。 当边对象没有空间包含且这是不可能的时，几何将在边对象的端点之间合成。

了解有关如何合成追踪中边对象的几何的详细信息

使用关联时，几何是在关联的端点之间合成的。 当边对象或关联的端点容器是非空间时，其位置源自包含层等级中的第一个空间要素。

了解有关如何合成追踪中关联几何的详细信息

参数	选项
合成几何	选中 - 追踪操作为 Trace_Results_Aggregated_Lines 要素类中遍历的关联和边对象推断并创建几何。 未选中 - 追踪操作不为遍历的关联和边对象推断并创建几何。 这是默认设置。 注： 使用企业级地理数据库时需要 ArcGIS Enterprise 11.3 或更高版本。

追踪名称参数（可选）可用于为追踪操作创建字符串标识符，以帮助识别追踪结果。 如果使用时取消选中了清除所有之前的追踪结果参数复选框，则此参数允许运行多个追踪操作并比较输出聚合几何要素类中的结果。

聚合点、聚合线和聚合面参数可指定用于存储聚合结果几何的要素类。 默认情况下，将使用存储在工程默认地理数据库中的系统生成的要素类填充该参数。

• Trace_Results_Aggregated_Lines - 线要素类
• Trace_Results_Aggregated_Points - 多点要素类
• Trace_Results_Aggregated_Polygons - 面要素类

如果这些要素类不存在，则系统会自动创建。 也可以使用现有要素类存储聚合几何。 如果使用非默认要素类，则该要素类必须包含一个名为 TRACENAME 字符串字段并与输出的几何类型相匹配。

使用部分要素结果生成输出几何将提供更精确的追踪表示，并且可以比较和重用其他任务的追踪结果。

警告：

如果聚合几何结果类型的输出要素类存在于工程的默认地理数据库中，则禁用地理处理选项允许地理处理工具覆盖现有数据集会导致工具验证问题。 可通过启用地理处理选项或在工程的默认地理数据库中重命名聚合的点、线和面要素类来解决此问题。

当针对结果类型选择了选择内容选项时，将提供另外一个选择类型参数，以定义将如何应用选择，以及在选择已经存在时将执行哪些操作。

参数	选项
选择内容类型	新建选择内容 - 生成的选择内容将替换当前选择内容。 这是默认设置。 添加到当前选择内容 - 当存在一个选择内容时，会将生成的选择内容添加到当前选择内容中。 如果不存在选择内容，该选项的作用与新选择内容选项的作用相同。 从当前选择内容中移除 - 结果选择内容将从当前选择内容中删除。 如果不存在选择内容，该选项不起作用。 选择当前选择内容的子集 - 结果选择内容与当前选择内容将会合并在一起。 仅两者共有的记录保持选中状态。 切换当前选择内容 - 将会切换结果选择内容。 将所选的结果从当前选择内容中移除，同时将未选取的结果添加到当前选择内容中。 如果不存在选择内容，该选项的作用与新选择内容选项的作用相同。

连通性结果类型选项可将追踪结果作为通过几何重叠或连通性关联连接的网络要素的连通图返回。 选择此选项后，系统会将连通性信息输出到指定位置的 .json 文件中，可对该文件进行解析，并将其导入其他系统，以构建您自己的数据图形表示。 仅为追踪返回的网络要素返回连通性信息。 输出 .json 文件包含 connctivity 下所有遍历网络要素的以下信息：

• fromNetworkSourceId
• fromGlobalId
• fromObjectId
• fromTerminalId
• fromGeometry
• viaNetworkSourceId
• viaGlobalId
• viaObjectId
• viaPositionFrom
• viaPositionTo
• viaGeometry
• toNetworkSourceId
• toGlobalId
• toObjectId
• toTerminalId
• toGeometry

元素结果类型选项会将基于要素的信息返回到指定的输出 .json 文件中，该文件可用作执行其他分析的输入。 输出 .json 文件包含 elements 下所有遍历网络要素的以下信息：

• networkSourceId
• globalId
• objectId
• assetGroupCode
• assetTypeCode

对于点要素和交汇点对象，还会返回其他信息：

• terminalId

对于线要素和边对象，还会返回其他信息：

• positionFrom
• positionTo

要素结果类型选项会在指定的输出 .json 文件中将追踪结果以要素相关信息的形式返回。 与元素选项类似，您可通过此选项在输出中包含其他信息以用于其他应用程序，例如要素几何、网络属性相关信息以及属性字段值。 针对 featureElements 下所有已遍历的网络要素，输出 .json 文件包含的信息与上方元素选项返回的信息相同，还包含以下附加信息：

使用包括几何时返回的信息（不适用于交汇点和边对象）：

• geometry

使用包括域描述时返回的信息：

• networkSourceName
• assetGroupName
• assetTypeName
• networkAttributeDescriptions（指定结果网络属性时）

• 对于点要素和交汇点对象，还会返回其他信息：

  • terminalName

使用结果网络属性时返回的信息：

• networkAttributeValues

使用结果字段时返回的信息：

• fieldValues

包含和附件关联结果类型选项可针对具有包含和结构附件关联的已遍历网络要素在指定的输出 .json 文件中返回关联信息。 输出 .json 文件包含 associations 下所有遍历网络要素的以下信息：

• associationType
• fromNetworkSourceId
• fromGlobalId
• fromTerminalId
• toNetworkSourceId
• toGlobalId
• toTerminalId

使用包括域描述时返回的信息：

• fromNetworkSourceName
• fromTerminalName
• toNetworkSourceName
• toTerminalName

选择某些结果类型选项时，会启用一些附加参数：

• 选择连通性、元素、要素或包含和附件关联选项时，会提供附加的输出 JSON 参数以指示输出 .json 文件的位置。
• 选择要素或包含和附件关联选项时，会提供附加的包括域描述参数以包含所遍历网络要素的域描述。
• 选择要素选项时，会另提供包括几何、结果网络属性和结果字段参数，以输出所遍历网络要素的要素几何、网络属性信息和字段级信息。

选择连通性、元素、要素或包含和附件关联选项时，输出 .json 文件将包含位于该文件底部的 sourceMapping 元素。 此元素允许您查找与每个 networkSourceId 相关联的图层名称。

"sourceMapping": {
		"1": "UN_6_Associations",
		"2": "UN_6_SystemJunctions",
		"4": "Structure Junction",
		"5": "Structure Line",
		"6": "Structure Boundary",
		"7": "Structure Junction Object",
		"8": "Structure Edge Object",
		"9": "Electric Distribution Device",
		"10": "Electric Distribution Line",
		"11": "Electric Distribution Assembly",
		"12": "Electric Distribution Junction",
		"13": "Electric Distribution SubnetLine",
		"14": "Electric Distribution Junction Object",
		"15": "Electric Distribution Edge Object"
	},

使用按位运算符

追踪配置使用一组通用运算符定义追踪结果的障碍、过滤器、函数和输出。 标准运算符用于评估要素属性，可确定它们是否等于、小于或大于某个值。

按位运算符使用位来从给定的整数值导出二进制值。 这些运算符功能强大且灵活方便，常用于高级追踪应用程序。 追踪框架可以使用这些独立于用户在域的编码值对中定义的含义的位。

追踪配置中使用的按位运算符包括以下各项：

• Includes the values - 所提供值中的所有位都存在于属性中的“按位与”运算（按位与 == 值）。
  • 使用此运算符时，配置值中包含的所有位也必须出现在网络属性值中，才能评估为 true。
• Does not include the values - 所提供值中的所有位并非都存在于属性中的“按位与”运算（按位与 != 值）。
  • 使用此运算符时，仅当网络属性不包含配置值中的所有位时，它才会评估为 true。
• Includes any - 所提供值中至少有一位存在于属性中的“按位与”运算（按位与 == True）。
  • 使用此运算符时，配置值中存在的任何位（也存在于网络属性中）都会计算为 true。
• Does not include any - 所提供值中的所有位均未存在于属性中的“按位与”运算（按位与 == False）。
  • 使用此运算符时，仅当网络属性值中不存在配置值中的任何位时，它才会评估为 true。

在对电力公共设施网络中的相位建模时，可以将数据集配置为使用为域代码指定的整数的二进制值。 为编码值属性域中的每个允许的相位组合配置一组值，并将其分配给使用相位的属性。 为了在追踪配置中使用，然后配置网络属性并将其分配给相位字段。

下表概述了如何使用这些二进制值对相位建模。 十进制值存储为编码，相位值用于编码值属性域中的描述。 每个十进制值都有一个相应的要计算的二进制值。 表中的二进制值列显示了每个十进制值的二进制表示。 按位运算符可以解构属性，以评估每个部分并确定其是否符合运算逻辑。

示例相位编码值属性域

二进制值	代码（十进制值）	描述（相位值）
001	1	C
010	2	B
100	4	A
011	3	BC
101	5	AC
110	6	AB
111	7	ABC

例如，要找到子网中 Phases Current 值中包括 A 的所有网络要素，则需要在配电域网络上执行子网追踪。 将在 Phases Current 值为 A (100) 的服务点上设置起点，并将以下追踪指定为过滤器障碍。

过滤器障碍配置为从追踪结果中排除不包括相位 A 的要素和对象。 要确保追踪结果中不包括障碍要素，请将包括障碍要素追踪配置选项设置为 false。 追踪结果中包括 Phases Current 值为 A 或包括 A 的 Phases Current 值的子网要素。 遇到的任何不具有包含 A 的 Phases Current 值的子网要素都将被视为障碍，并且不会包含在结果中。

Filter Barriers
Name: Phases Current
Operator: Does not include any (Bitwise AND equals False)
Type: Specific value
Value: 4 //code for A (100)

下表提供了帮助说明按位运算符评估为 true 并充当追踪中障碍的场景的指南。 例如，考虑一种场景：设备上的 Phase 字段包含网络属性值 AB (110)，并且与追踪配置进行比较的值是 ABC (111)：

• 如果使用 Includes the values 运算符，则这将评估为 false 并且不会作为障碍，因为所有位都不存在于网络属性值中。 位 C (001) 不存在于 AB (110) 中。
• 如果对相同的配置使用 Includes any 运算符，则该值将计算为 true，因为某些配置值位存在于网络属性中。 位 A (100) 和位 B (010) 存在于 ABC (111) 中。
• 使用 Does not include the values 运算符也将评估为 true，因为即使存在 A (100) 和 B (010)，网络属性值 AB (110) 也不包括位 C (001)。
• 最后，使用此配置示例的 Does not include any 运算符在遇到网络属性值 AB (110) 时将评估为 false，因为配置值包含匹配位 A (100) 和 B (010)。 为了使其评估为 true，A (100)、B (010) 和 C (001) 不需要存在。

网络属性值	配置值	包括值	包括任何	不包括值	不包括任何
ABC (111)	A (100)	True	True	False	False
AC (101)	BC (011)	False	True	True	False
C (001)	B (010)	False	False	True	True
AB (110)	ABC (111)	False	True	True	False

对追踪的网络要素执行计算

公共设施网络可提供名为属性传播的高级功能，以便在更新或追踪子网时使用。

可以通过为数据库字段配置网络属性来处理属性替换。 替换是一种网络属性类型，对于将属性替换类别分配给其资产类型的要素，其值用于计算该要素的传播值。 然后，可以使用生成的替换值来计算下一个连接的要素的值。 要使用属性替换，必须配置属性传播。

有关详细信息，请参阅属性传播程序和属性替换。

加载指定追踪配置

指定追踪配置允许创建复杂的追踪以进行共享和重用。 您可通过追踪工具加载现有的指定追踪配置，以定义追踪的属性。 这简化了与追踪相关的用户体验，并通过重用组织中的常见追踪来提供一致性。

参数	选项
使用追踪配置	选中 - 此工具将使用现有指定追踪配置来定义追踪的属性。 选中该选项后，将仅显示追踪配置名称、起点和障碍参数。 加载使用聚合的几何结果类型选项的指定追踪配置时，聚合的点、聚合的线和聚合的面参数也会一并显示。 未选中 - 此工具将不使用指定追踪配置来定义追踪的属性。 这是默认设置。

将提供指定将用于定义追踪属性的追踪配置的名称的追踪配置名称参数。 此参数仅在已启用使用追踪配置时可用。

注：

通过追踪窗格中的指定配置选项卡，您也可以使用之前配置的指定追踪配置运行追踪。

了解有关指定追踪配置的详细信息