MethodInstances 中的 Association 元素(BDCMetadata 架构)

上次修改时间: 2015年3月9日

适用范围: SharePoint Server 2010

命名空间:https://schemas.microsoft.com/windows/2007/BusinessDataCatalog

架构:BDCMetadata

关联元素链接系统内的相关外部内容类型。例如,某个客户在 AdventureWorks 系统中与某个销售订单关联:客户提交了销售订单。关联保留指向源外部内容类型和目标外部内容类型的指针,以及指向允许客户端从源外部内容类型获取目标外部内容类型的业务逻辑(MethodInstance 对象)的指针。关联的通道是对外部系统的方法调用。

在 BDC 模型中,关联逻辑 (MethodInstance) 可以针对任何外部内容类型(源外部内容类型、目标外部内容类型或不相关的外部内容类型),但前提是目标外部内容类型属于包含关联方法实例的 LobSystem。

警告注释警告

请注意使用 SharePoint Designer 2010 时,您必须针对目标外部内容类型创建关联操作。这是 SharePoint Designer 的要求,采用其他方法(针对源外部内容类型或其他外部内容类型)对其进行建模则不会生效。

BDC 还支持多个源外部内容类型方案和一个目标外部内容类型方案。

一个关联方法实例包含多个用于 SourceEntity 实例标识符值的槽,以及一个用于 DestinationEntity 实例标识符值的槽。因此,您必须在关联方法中使用与每个外部内容类型(作为关联中的源)的各标识符对应的标识符,对足够多的输入 TypeDescriptor 对象进行标记。输入 TypeDescriptor 对象的 IdentifierName 属性指示 BDC 插入相关的 EntityInstance 标识符值,然后再执行该方法。例如,在 AssociationMethodInstance 中,用户可能已提供他(或她)要检索的源 EntityInstance 的标识符值。BDC 在使用所有默认值完全实例化该参数后,将该值插入到此槽中。

BDC 还支持外键伪关联。外键伪关联不是一类关联。可以考虑返回客户的 Web 方法,并且客户的其中一个字段为客户地址键。还可以考虑另一种 Web 方法,其在赋予键之后便可以返回地址。元数据建模器可将此方法用作客户到地址的关联方法(可能会配合使用特定的地址查找工具)。外键伪关联会检查此方法的目标是否为地址,获取返回客户的地址键,然后调用此关联方法以自动返回地址。

警告注释警告

请注意,尽管 BDC 模型支持外键伪关联,但 SharePoint Designer 2010 却不支持。因此,您不能使用 SharePoint Designer 对外键伪关联进行建模。

关联元素接受以下属性。

重要注释重要说明

属性区分大小写。

属性

属性

类型

说明

是否必需

默认值

限制/接受值

HideOnProfilePage

System.Boolean

指定是否应将相关外部内容类型添加到主外部内容类型的配置文件页面。

可选

<Association Type = "String" Default = "Boolean" ReturnParameterName = "String" ReturnTypeDescriptorName = "String" ReturnTypeDescriptorLevel = "Integer" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </Association>

属性和元素

以下各节介绍了属性、子元素和父元素。

属性

属性

说明

Type

必需。

指定关联类型的 MethodInstanceType。

下表列出了该属性可能的值。

说明

AssociationNavigator

MethodInstance 是一个 AssociationNavigator。

Associator

MethodInstance 是一个 Associator。

Disassociator

MethodInstance 是一个 Disassociator。

BulkAssociatedIdEnumerator

MethodInstance 是一个 BulkAssociatedIdEnumerator。

BulkAssociationNavigator

MethodInstance 是一个 BulkAssociationNavigator。

Default

可选。

指定关联是否为在包含外部内容类型中共享其类型的所有关联的默认项。如果设置为 true,则关联为在包含外部内容类型中共享其类型的所有关联的默认项。如果设置为 false,则关联不是在包含外部内容类型中共享其类型的所有关联的默认项。

默认值:false

属性类型:Boolean

ReturnParameterName

可选。

包含关联 ReturnTypeDescriptor 的参数的名称。参数的方向属性必须包含"Out"、"InOut"或"Return"值中的一个。

属性类型:String

ReturnTypeDescriptorName

可选。

已弃用此属性。请改用 ReturnTypeDescriptorPath。

属性类型:String

ReturnTypeDescriptorLevel

可选。

已弃用此属性。请改用 ReturnTypeDescriptorPath。

属性类型:Integer

ReturnTypeDescriptorPath

可选。

关联 TypeDescriptor 的点式路径。

属性类型:String

Name

必需。

关联名称。

属性类型:String

DefaultDisplayName

可选。

关联的默认显示名称。

属性类型:String

IsCached

可选。

指定是否频繁使用此关联。

默认值:true

属性类型:Boolean

子元素

元素

说明

MetadataObject 中的 LocalizedDisplayNames 元素(BDCMetadata 架构)

LocalizedDisplayNames 元素指定已本地化的关联名称的列表。

MetadataObject 中的 Properties 元素(BDCMetadata 架构)

属性元素指定关联的属性。

AccessControlList 元素(BDCMetadata 架构)

AccessControlList 元素指定一组关联的访问权限。

Association 中的 SourceEntity 元素(BDCMetadata 架构)

SourceEntity 元素指定关联中的源外部内容类型。

Association 中的 DestinationEntity 元素(BDCMetadata 架构)

DestinationEntity 元素指定关联中的目标外部内容类型。

父元素

元素

说明

Method 中的 MethodInstances 元素(BDCMetadata 架构)

包含关联的 MethodInstances 元素。