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

描述

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

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

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

使用方法

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

• 必须禁用网络拓扑。

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

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

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

语法

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	更新的公共设施网络。	公共设施网络

代码示例

SetAssociationRole 示例（Python 窗口）

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

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

环境

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

许可信息

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