导出电路 (公共设施网络工具)

汇总

导出电信域网络 中构成电路的要素和对象的要素与连通性信息。 数据将以 .json 文件形式保存到指定的输出文件夹中，每个电路对应一个文件。

导出的数据可用于存档，或通过 ModelBuilder、脚本或模型工具，或通过与外部第三方系统的集成，作为其他工具的输入。

注:

当使用企业级地理数据库中的公共设施网络时，将使用 UtilityNetworkTools 地理处理服务对导出电路操作进行异步处理。 针对包含公共设施网络的要素服务，将在系统文件夹中对 UtilityNetworkTools 服务进行预配置。 该服务具有更长的超时设置，并且针对公共设施网络地理处理任务保留该服务。

了解有关导出电路的详细信息

用法

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

• 使用企业级地理数据库时，必须满足以下要求：

  • 输入公共设施网络参数值必须来自公共设施网络服务。

  • 连接的 ArcGIS Enterprise 门户账户必须为门户公共设施网络所有者。

  • 许可：

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

• 选中设置导出确认参数时，需提供以下信息：

  • 必须启用 网络拓扑。

  • 输入公共设施网络参数值必须引用默认分支版本。

参数

• Dialog
• Python

标注	说明	数据类型
输入公共设施网络	包含将导出的电路的公共设施网络。	Utility Network; Utility Network Layer
域网络	包含将导出的电路的电信域网络。	String
设置导出确认	指定是否更新 Circuit 表中相应电路的 LASTEXPORTED 属性。 选中—将更新“电路”表中相应电路的 LASTEXPORTED 属性。 如果电路已标记为删除（状态 = 已删除），则将从公共设施网络中移除该电路。 输入公共设施网络参数必须引用默认版本才能使用此选项。 未选中—不更新“电路”表中相应电路的 LASTEXPORTED 属性。 这是默认设置。	Boolean
输出文件夹	用于存储为每个导出电路创建的 .json 文件的输出文件夹的名称和位置。	Folder
最大跳数 （可选）	路径中允许的边之间的最大跳数，不包括起始位置。 所有边以及交汇点-交汇点连通性关联在遍历时均被评估为具有固定单位长度 1。 默认值为 100。	Long
包括容器 （可选）	指定追踪结果中是否包含容器要素。 选中—追踪结果中将包含容器要素。 未选中—追踪结果中将不包含容器要素。 这是默认设置。	Boolean
最多包含第一个空间容器 （可选）	指定返回的容器是否仅限于追踪结果中每个网络元素的第一个空间容器（包括第一个空间容器）。 如果没有遇到空间容器，但是存在给定网络元素的非空间容器，则所有非空间容器都将包含在结果中。 仅当将 include_containers 设置为 INCLUDE_CONTAINERS 时，才会启用此参数。 选中—当沿追踪路径遇到嵌套包含关联时，结果中仅返回遇到次数最多并包括第一个空间容器的容器。 如果空间容器不存在，则所有给定网络元素的非空间容器都将包含在结果中。 未选中—所有容器都将在结果中返回。 这是默认设置。	Boolean
包括内容 （可选）	指定追踪是否将在结果中返回容器要素的内容。 选中—追踪结果将包含容器要素中的内容。 未选中—追踪结果将不包含容器要素中的内容。 这是默认设置。	Boolean
包括结构 （可选）	指定追踪结果中是否包含结构要素和对象。 选中—追踪结果中将包含结构要素和对象。 未选中—追踪结果中将不包含结构要素和对象。 这是默认设置。	Boolean
包括障碍要素 （可选）	指定追踪结果中是否包含可遍历性障碍要素。 即使已在子网定义中进行了预设，可遍历性障碍仍可选。 此参数不适用于具备终端的设备要素。 选中—追踪结果中将包含可遍历性障碍要素。 这是默认设置。 未选中—追踪结果中将不包含可遍历性障碍要素。	Boolean
忽略起点处障碍 （可选）	指定是否在追踪配置中忽略起点处的动态障碍。 选中—追踪过程中将忽略起点处的障碍。 未选中—追踪过程中不会忽略起点处的障碍。 这是默认设置。	Boolean
验证可定位性 （可选）	指定如果遇到非空间交汇点或边对象并且其关联层次结构中没有必要的连通性、包含或附件关联，是否在追踪操作期间返回错误。 此参数确保可以通过与要素或其他可定位对象 的关联来定位追踪或更新子网操作返回的非空间对象。 选中—如果遇到无法定位 的非空间交汇点或边对象并且其关联层次结构中没有必要的连通性、包含或附件关联，则追踪将返回一条错误。 未选中—追踪不会检查是否存在无法定位的对象并返回结果，无论遍历对象的关联层次结构中是否存在无法定位的对象。 这是默认设置。	Boolean
在服务器上以异步模式运行 （可选）	指定在使用企业级地理数据库中的公共设施网络时，导出操作是否将以异步方式执行。 选中—将异步处理导出操作。 未选中—将同步处理导出操作。 这是默认设置。	Boolean
条件障碍 （可选）	基于与网络属性的比较或对类别字符串的检查，对要素设置可遍历性障碍条件。 条件障碍根据网络属性或类别、操作符、类型及属性值来定义。 例如，当要素的 Device Status 属性等于 Open 的特定值时，将停止追踪。 当要素满足此条件时，追踪将停止。 如果您要使用多个属性，可使用组合方法参数来定义 And 或 Or 条件。 了解有关使用多条件表达式的详细信息 值表列： Name—Filter by network attribute name. Operator—Filter by an operator. Is equal to—The attribute is equal to the value. Does not equal—The attribute is not equal to the value. Is greater than—The attribute is greater than the value. Is greater than or equal to—The attribute is greater than or equal to the value. Is less than—The attribute is less than the value. Is less than or equal to—The attribute is less than or equal to the value. Includes the values (bitwise AND equals the value)—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). Does not include the values (bitwise AND does not equal the value)—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). Includes any (bitwise AND equals True)—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). Does not include any (bitwise AND equals False)—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). Type—Filter by a specific type. Specific value—Filter by a specific value or network category. Network attribute—Filter by a network attribute. Value—Filter by a specific value. Combine Using—Use this parameter to combine multiple condition barriers. And—Combine the condition barriers. Or—Use if either condition barrier is met.	Value Table
函数障碍 （可选）	基于函数对要素设置可遍历性障碍，以限制用于筛选待导出电路的电路追踪。 函数障碍可用于执行以下操作：限制追踪距离起点的行程或设置停止追踪的最大值。 这可用于约束将要导出的电路。 例如，考虑一个场景：您希望导出长度大于 1 千米的电路。 可以使用函数障碍，仅在总长度超过 1,000 米时导出指定电路。 值表列： Function—Filter by a function. Minimum—The minimum of the input values will be identified. Maximum—The maximum of the input values will be identified. Average—The average of the input values will be calculated. Count—The number of features will be identified. Add—The sum of the input values will be calculated. Subtract—The difference between the input values will be calculated. Attribute—Filter by a network attribute. Operator—Filter by an operator. Is equal to—The function result is equal to the value. Does not equal—The function result is not equal to the value. Is greater than—The function result is greater than the value. Is greater than or equal to—The function result is greater than or equal to the value. Is less than—The function result is less than the value. Is less than or equal to—The function result is less than or equal to the value. Includes the values (bitwise AND equals the value)—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). Does not include the values (bitwise AND does not equal the value)—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). Includes any (bitwise AND equals True)—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). Does not include any (bitwise AND equals False)—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). Value—Filter by a specific value. Use Local Values—Boolean value that uses local variables instead of a global variable.	Value Table
应用可遍历性至 （可选）	指定可遍历性障碍是否应用于交汇点和/或边。 例如，如果定义了用于停止追踪的条件障碍，其中 Device Status 等于 Proposed 并将可遍历性范围设置为仅边，则即使遇到拟建设备，电路追踪也不会停止，因为 Device Status 仅适用于交汇点。 换言之，此参数会为追踪指明是否要忽略交汇点和/或边。 交汇点和边—可遍历性将同时应用于交汇点和边。 这是默认设置。 仅交汇点—可遍历性将仅应用于交汇点。 仅边—可遍历性将仅应用于边。	String
传播程序 （可选）	指定要传播的网络属性以及传播将在追踪过程中的发生方式。 传播的类属性表示网络中各个要素上已传播至电路中其余要素的关键值。 例如，在电信域网络中，您可以从定义为电路位置 的要素中传播波长值。 注: 此参数仅可用于 Python。 值表列： Attribute—Filter using any network attribute defined in the system. Substitution Attribute—Substitution is not supported with telecom domain networks. Function—Wavelength propagation supports use of the function PROPAGATED_BITWISE_AND. Operator—Choose from the operators INCLUDES_ANY and DOES_NOT_INCLUDE_ANY for wavelength propagation. Value—Provide a specific value for the input attribute type that would cause termination based on the operator value.	Value Table
包括几何 （可选）	指定是否在结果中包括几何。 选中—结果中将包含几何。 未选中—结果中将不包含几何。 这是默认设置。	Boolean
包括域描述 （可选）	指定域描述是否将包含在输出 .json 文件中以传达电路的域映射。 此参数不适用于 circuits 结果类型选项。 选中—将在结果中包含域描述。 未选中—不会在结果中包含域描述。 这是默认设置。	Boolean
合成几何 （可选）	指定当使用 circuits 结果类型选项时，是否将为作为电路追踪一部分遍历的非空间交汇点和边对象推断并创建（合成）几何。 include_geometry 参数也必须设为 true，才能将几何包含在输出 .json 文件中。 选中—将为遍历的非空间交汇点和边对象推断并创建几何，并包含在输出 .json 文件中。 未选中—不会为遍历的非空间交汇点和边对象合成几何。 这是默认设置。	Boolean
结果类型 （可选）	指定将要返回的结果类型。 连通性—将返回通过几何重叠或连通性关联连接的要素。 这是默认设置。 要素—将返回要素级别信息。 这是默认设置。 包含和附件关联—将返回通过包含和结构附件关联进行关联的要素。 电路—将返回电路定义，并可选择包含电路中每个部分的路径连通性信息和几何。	String
结果网络属性 （可选）	使用要素结果类型选项时，将包含在结果中的网络属性。	String
结果字段 （可选）	使用要素结果类型选项时，要素类中将作为结果返回的字段。 该字段的值将在电路要素的结果中返回。 值表列： Feature Class—A feature or object class that participates in the utility network. Field Name—The name of a field from the feature or object class that will have its values returned in the results.	Value Table

派生输出

标注	说明	数据类型
更新的公共设施网络	更新的公共设施网络。	Utility Network
更新的工作空间	更新的工作空间。	Utility Network
输出电路表	包含导出电路信息的输出表。	Value Table

环境

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

许可信息

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

相关主题

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