设置关联角色 (公共设施网络)

摘要

用于更改分配到网络要素类或表的资产类型级别关联角色。

关联角色用于定义某些网络要素参与公共设施网络的方式。 公共设施网络具有针对结构和容器的系统提供的现有关联角色。 对于使用关联设置为容器或结构的网络要素，必须首先设置关联角色。 关联角色在要素类或对象级别下进行分配，分配对象为特定资产组和资产类型。

了解有关如何设置或修改关联角色分配的详细信息

使用情况

• 资产类型角色的视图比例和删除语义可以使用该工具进行定义和更新。

• 必须禁用网络拓扑。

• 只能在首次启用网络拓扑之前执行取消分配容器或结构关联角色的操作。 有关其他示例和所需的网络拓扑状态，请参阅公共设施网络管理任务。

• 使用企业级地理数据库时，已连接的 ArcGIS Enterprise 门户账户必须是门户公共设施网络所有者。

• 在使用企业级地理数据库时，输入公共设施网络参数值必须来自以数据库公共设施网络所有者身份建立的数据库连接。

参数

对话框

标注	说明	数据类型
输入公共设施网络	公共设施网络，其中包含要设置关联角色的资产类型。	Utility Network; Utility Network Layer
域网络	域网络，其中包含要设置关联角色的资产类型。	String
输入表	将设置关联角色的公共设施网络要素类或表。	String
资产组	包含资产类型的资产组。	String
资产类型	将为其设置关联角色的资产类型。	String
角色类型	指定要分配到资产类型的关联角色的类型。 容器—将分配容器关联角色类型。 该角色类型的要素或对象可以将其他要素或对象包含为内容。 结构—将分配结构关联角色类型。 该角色类型的要素或对象可以附加其他要素或对象。 无—未分配角色类型。 这些要素或对象既不是容器，也不是结构，但确实与其他结构相连接。	String
删除语义	指定网络要素的删除语义，定义删除容器或结构时如何管理内容或附件网络要素。 这适用于容器和结构关联角色。 级联—删除容器或结构时，所有内容或附件网络要素也会一并删除。 设为无—删除容器或结构时，不会删除其内容或附件网络要素；但是会从包含或结构附件关联中将其移除。 受限—如果存在内容或附件网络要素，则在尝试删除容器或结构时将返回错误。 必须移除内容或附件网络要素后，才能删除容器或结构。	String
视图比例 (可选)	将输入包含模式比例，以开始编辑参与容器的要素。 例如，将视图比例设置为 5 意味着当您进入容器要素的包含模式时，比例将为 1:5。 单位基于公共设施网络图层属性窗格的源选项卡上的公共设施网络单位。 此参数不适用于交汇点和边对象。	Double
分割内容 (可选)	指定对容器要素进行分割后，是否分割容器的关联内容。 仅当关联角色为容器时，此参数才处于活动状态，并且仅适用于线要素。 选中 - 如果对容器要素进行分割，则分割容器的内容。 如果找到平行内容线要素，也会对内容进行分割，并且每部分将包含在最近的容器要素内。 如果内容线不平行，则内容将包含在最近的容器要素内。 当内容为非空间交汇点对象时，将会复制该内容，以便每个容器要素都具有一个交汇点对象作为内容。 当内容为非空间边对象时，将会分割该内容，以便每个容器要素都具有一个边对象作为内容。 未选中 - 如果对容器要素进行分割，不会分割容器的内容。 如果找到平行内容线要素，则内容将包含在容器要素的两个部分中。 如果内容线不平行，则内容将包含在最近的容器要素内。 当使用非空间交汇点对象内容时，该内容将包含在较大的容器中。 在使用非空间边对象内容时，该内容将保留为两个父容器的内容。 这是默认设置。	Boolean

派生输出

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

Python

arcpy.un.SetAssociationRole(in_utility_network, domain_network, featureclass, assetgroup, assettype, association_role_type, association_deletion_semantics, {view_scale}, {split_content})

名称	说明	数据类型
in_utility_network	公共设施网络，其中包含要设置关联角色的资产类型。	Utility Network; Utility Network Layer
domain_network	域网络，其中包含要设置关联角色的资产类型。	String
featureclass	将设置关联角色的公共设施网络要素类或表。	String
assetgroup	包含资产类型的资产组。	String
assettype	将为其设置关联角色的资产类型。	String
association_role_type	指定要分配到资产类型的关联角色的类型。 CONTAINER—将分配容器关联角色类型。 该角色类型的要素或对象可以将其他要素或对象包含为内容。 STRUCTURE—将分配结构关联角色类型。 该角色类型的要素或对象可以附加其他要素或对象。 NONE—未分配角色类型。 这些要素或对象既不是容器，也不是结构，但确实与其他结构相连接。	String
association_deletion_semantics	指定网络要素的删除语义，定义删除容器或结构时如何管理内容或附件网络要素。 这适用于容器和结构关联角色。 CASCADE—删除容器或结构时，所有内容或附件网络要素也会一并删除。 SET_TO_NONE—删除容器或结构时，不会删除其内容或附件网络要素；但是会从包含或结构附件关联中将其移除。 RESTRICTED—如果存在内容或附件网络要素，则在尝试删除容器或结构时将返回错误。 必须移除内容或附件网络要素后，才能删除容器或结构。	String
view_scale (可选)	将输入包含模式比例，以开始编辑参与容器的要素。 例如，将视图比例设置为 5 意味着当您进入容器要素的包含模式时，比例将为 1:5。 单位基于公共设施网络图层属性窗格的源选项卡上的公共设施网络单位。 此参数不适用于交汇点和边对象。	Double
split_content (可选)	指定对容器要素进行分割后，是否分割容器的关联内容。 仅当关联角色为容器时，才会启用此参数，并且仅适用于线要素。 SPLIT—如果对容器要素进行分割，则分割容器的内容。 如果找到平行内容线要素，也会对内容进行分割，并且每部分将包含在最近的容器要素内。 如果内容线不平行，则内容将包含在最近的容器要素内。 当内容为非空间交汇点对象时，将会复制该内容，以便每个容器要素都具有一个交汇点对象作为内容。 当内容为非空间边对象时，将会分割该内容，以便每个容器要素都具有一个边对象作为内容。 DO_NOT_SPLIT—如果对容器要素进行分割，不会分割容器的内容。 如果找到平行内容线要素，则内容将包含在容器要素的两个部分中。 如果内容线不平行，则内容将包含在最近的容器要素内。 当使用非空间交汇点对象内容时，该内容将包含在较大的容器中。 在使用非空间边对象内容时，该内容将保留为两个父容器的内容。 这是默认设置。	Boolean

派生输出

名称	说明	数据类型
out_utility_network	更新的公共设施网络。	Utility Network

代码示例

SetAssociationRole 示例（Python 窗口）

为资产类型 transformer 设置容器关联角色。 视图比例已设置为 10，删除语义为受限。

import arcpy
arcpy.un.SetAssociationRole("Utility Network", "ElectricDistribution", 
                            "ElectricDistributionAssembly", "Transformer Bank", 
                            "Transformer", "CONTAINER", "RESTRICTED", 10)

环境

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

许可信息

• Basic: 否
• Standard: 是
• Advanced: 是