设置关联角色 (公共设施网络工具)
汇总
用于更改分配到网络要素类或表的资产类型级别关联角色。
关联角色用于定义某些网络要素参与公共设施网络的方式。 公共设施网络具有针对结构和容器的系统提供的现有关联角色。 对于使用关联设置为容器或结构的网络要素，必须首先设置 关联角色。 关联角色在要素类或对象级别下进行分配，分配对象为特定资产组和资产类型。
了解有关如何设置或修改关联角色分配的详细信息
用法
资产类型角色的视图比例和删除语义可以使用该工具进行定义和更新。
必须 禁用 网络拓扑。
只能在首次启用网络拓扑之前执行取消分配容器或结构关联角色的操作。 有关示例和所需的网络拓扑状态，请参阅 公共设施网络管理任务。
使用企业级地理数据库时，已连接的 ArcGIS Enterprise 门户账户必须是 门户公共设施网络所有者。
在使用企业级地理数据库时，输入公共设施网络参数值必须来自以 数据库公共设施网络所有者 身份建立的数据库连接。
参数
|
标注
|
说明
|
数据类型
|
|
输入公共设施网络
|
公共设施网络，其中包含要设置关联角色的资产类型。
|
Utility Network; Utility Network Layer
|
|
域网络
|
域网络，其中包含要设置关联角色的资产类型。
|
String
|
|
输入表
|
将设置关联角色的公共设施网络要素类或表。
|
String
|
|
资产组
|
包含资产类型的资产组。
|
String
|
|
资产类型
|
将为其设置关联角色的资产类型。
|
String
|
|
角色类型
|
指定要分配到资产类型的关联角色的类型。
容器—将分配容器关联角色类型。 该角色类型的要素或对象可以包含其他要素和对象作为其内容。
结构—将分配结构关联角色类型。 该角色类型的要素或对象可以附加其他要素或对象。
无—未分配角色类型。 这些要素或对象既不是容器，也不是结构，但确实与其他结构相连接。
|
String
|
|
删除语义
|
指定网络要素的删除语义，定义删除容器或结构时如何管理内容或附件网络要素。 这适用于容器和结构关联角色。
级联—删除容器或结构时，所有内容或附件网络要素也会一并删除。
设为无—当删除容器或结构时，将不会删除其内容或附件网络要素；但是会从包含或结构附件关联中将其移除。
受限—如果存在内容或附件网络要素，则在尝试删除容器或结构时将返回错误。 必须移除内容或附件网络要素后，才能删除容器或结构。
|
String
|
|
视图比例
（可选）
|
将输入包含模式比例，以开始编辑参与容器的要素。 例如，将视图比例设置为 5 意味着当您进入容器要素的包含模式时，比例将为 1:5。 单位基于公共设施网络图层属性窗格的源选项卡上的公共设施网络单位。 此参数不适用于交汇点和边对象。
|
Double
|
|
分割内容
（可选）
|
指定对容器要素进行分割后，是否分割容器的关联内容。 仅当关联角色为容器时，才会启用此参数，并且仅适用于线要素。
选中—如果对容器要素进行分割，则将分割容器的内容。 如果找到平行内容线要素，则也会对内容进行分割，并且每部分将包含在最近的容器要素内。 如果内容线不平行，则内容将包含在最近的容器要素内。 当内容为非空间交汇点对象时，将会复制该内容，以便每个容器要素都具有一个交汇点对象作为内容。 当内容为非空间边对象时，将会分割该内容，以便每个容器要素都具有一个边对象作为内容。
未选中—如果对容器要素进行分割，则将不会分割容器的内容。 如果找到平行内容线要素，则内容将包含在容器要素的两个部分中。 如果内容线不平行，则内容将包含在最近的容器要素内。 当使用非空间交汇点对象内容时，该内容将包含在较大的容器中。 在使用非空间边对象内容时，该内容将保留为两个父容器的内容。 这是默认设置。
|
Boolean
|
派生输出
|
标注
|
说明
|
数据类型
|
|
更新的公共设施网络
|
更新的公共设施网络。
|
Utility Network
|
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)
环境
此工具不使用任何地理处理环境。
许可信息