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

汇总

用于将传统域网络 中的子网导出到 .json 文件中。 如果 Is deleted 属性设置为 true，则该工具也可以用于删除子网表 中的行。 这表示子网控制器已从子网中移除。

注:

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

了解有关导出子网的详细信息

用法

• 导出子网前必须对其进行清理。需先运行更新子网 工具。

• Trace Parameters 类别中的参数只能在 Python 中使用。

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

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

  • 许可：

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

• 在选中设置导出确认参数后，必须满足以下条件：

  • 必须启用 网络拓扑。

  • 企业级地理数据库具有以下附加要求：

    • 此工具必须连接到默认版本才能运行。

      • 在启用操作期间，将阻止连接到默认版本的所有其他会话运行验证或启用操作。

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

参数

• Dialog
• Python

标注	说明	数据类型
输入公共设施网络	包含将导出的子网的公共设施网络。	Utility Network; Utility Network Layer
域网络	包含子网的域网络。	String
层	包含子网的层。	String
子网名称	将从层导出的子网的名称。 选择一个特定源可导出相应的子网信息。 当子网表包含层级的 10,000 条或更多记录时，不会填充参数的选择列表，并且会为子网名称提供一个空字段。	String
设置导出确认	指定是否更新 Subnetworks 表中相应控制器以及 SubnetLine 要素类中要素的 LASTACKEXPORTSUBNETWORK 属性。 选中—子网表中相应控制器的 LASTACKEXPORTSUBNETWORK 属性将更新。 如果源已标记为删除 (Is deleted = True)，则将从子网表中将其删除。 此选项要求输入公共设施网络引用默认版本。 未选中—子网表中相应控制器的 LASTACKEXPORTSUBNETWORK 属性不会更新。 这是默认设置。	Boolean
输出 JSON	将生成的 .json 文件的名称和位置。	File
条件障碍 （可选）	基于与网络属性的比较或对类别字符串的检查，对要素设置可遍历性障碍条件。 条件障碍根据网络属性或类别、操作符、类型及属性值来定义。 例如，当要素的 Device Status 属性等于 Open 的特定值时，将停止追踪。 当要素满足此条件时，追踪将停止。 如果您要使用多个属性，可使用组合方法参数来定义 And 或 Or 条件。 了解有关使用多条件表达式的详细信息 注: 此参数仅可用于 Python。 值表列： 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
函数障碍 （可选）	基于函数对要素设置可遍历性障碍。 函数障碍可用于执行以下操作：限制追踪距离起点的行程或设置停止追踪的最大值。 例如，所经过的每条线的长度和为目前经过的总距离。 当经过的总长度达到指定值时，追踪将停止。 注: 此参数仅可用于 Python。 值表列： 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 in the input values will be calculated. Subnetwork controllers and loops trace types do not support the subtract function. Attribute—Filter by a network attribute. 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). Value—Filter by a specific value. Use Local Values—Boolean value to use local variables instead of a global variable.	Value Table
包括障碍要素 （可选）	指定追踪结果中是否包含可遍历性障碍要素。 即使已在子网定义中进行了预设，可遍历性障碍仍可选。 选中—追踪结果中将包含可遍历性障碍。 这是默认设置。 未选中—追踪结果中将不会包含可遍历性障碍。	Boolean
应用可遍历性至 （可选）	指定将应用的可遍历性类型。 可遍历性范围用于确定是否在交汇点和/或边处应用可遍历性。 例如，如果定义了一个用于停止追踪的条件障碍，其中 DEVICESTATUS 设置为 Open 且遍历范围设置为仅边，则即使遇到开路设备，追踪也不会停止，因为 DEVICESTATUS 仅适用于交汇点。 换言之，此参数会为追踪指明是否要忽略交汇点和/或边。 注: 此参数仅可用于 Python。 交汇点和边—可遍历性将同时应用于交汇点和边。 这是默认设置。 仅交汇点—可遍历性将仅应用于交汇点。 仅边—可遍历性将仅应用于边。	String
传播程序 （可选）	指定要传播的网络属性，以及传播将在传统域网络 的追踪过程中的发生方式。 传播的类属性表示子网控制器上已传播至子网余下要素的关键值。 例如，在配电模型中，您可传播相位值。 注: 此参数仅可用于 Python。 值表列： Attribute—Filter by a network attribute. Substitution Attribute—The field used for substitution. Function—Filter by a function. Operator—Filter by an operator. Value—Filter by a specific value.	Value Table
包括几何 （可选）	指定是否在结果中包括几何。 选中—结果中将包含几何。 未选中—结果中将不包含几何。 这是默认设置。	Boolean
结果类型 （可选）	指定将要返回的结果类型。 连通性—将返回通过几何重叠或连通性关联连接的要素。 要素—将返回要素级别信息。 包含和附件关联—将返回通过包含和结构附件关联进行关联的要素。 相关记录—对于指定关系类和字段，将返回子网中要素的关联对象值。 注: 对于企业级地理数据库，此选项数需要 ArcGIS Enterprise 11.5 或更高版本。	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
包括域描述 （可选）	指定域描述是否将包含在输出 .json 文件中以传达控制器、要素元素、连通性和关联的域映射。 选中—将在结果中包含域描述。 未选中—不会在结果中包含域描述。 这是默认设置。	Boolean
关联记录字段 （可选）	将作为结果返回的关联对象类的字段。 字段的值将在子网中要素的结果中返回。 值表列： Relationship Class—A relationship class that relates to a feature or object class that participates in the utility network. Field Name—The name of a field from the related object class that will have its values returned in the results.	Value Table
包括流向 （可选）	指定输出 .json 文件中是否包含流向。 如果包含，该文件将包含从子网控制器派生的流向信息，涉及遍历的线、边对象、带终端设备的内部边以及连通性关联。 此参数仅适用于连通性和要素结果类型选项。 注: 对于企业级地理数据库，此参数需要 ArcGIS Enterprise 12.1 或更高版本。 选中—结果中将包含流向。 未选中—结果中将不包含流向。 这是默认设置。	Boolean
包括传播值 （可选）	指定是否将传播值包含在导出的子网所对应的输出 .json 文件中。 此参数仅适用于要素结果类型。 注: 对于企业级地理数据库，此参数需要 ArcGIS Enterprise 12.1 或更高版本。 选中—结果中将包含传播值。 未选中—结果中将不包含传播值。 这是默认设置。	Boolean

派生输出

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

环境

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

许可信息

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

相关主题

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