MethodInstances (BDCMetadata 架构) 中的 Association 元素
适用于：SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013
命名空间： http://schemas.microsoft.com/windows/2007/BusinessDataCatalog
架构：BDCMetadata
Association 元素链接系统内的相关外部内容类型。 例如，某个客户在 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>
下面各部分介绍了属性、子元素和父元素。
元素和属性
属性
属性 |
说明 |
||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
**类型** |
必填。 指定关联类型的 MethodInstanceType。 下表列出了该属性可能的值。
|
||||||||||||
**默认** |
可选。 指定关联是否为在包含外部内容类型中共享其类型的所有关联的默认项。 如果设置为 true，则关联为在包含外部内容类型中共享其类型的所有关联的默认项。 如果设置为 false，则关联不是在包含外部内容类型中共享其类型的所有关联的默认项。 默认值：false** 属性类型：**布尔值** |
||||||||||||
**ReturnParameterName** |
可选。 包含关联 ReturnTypeDescriptor 的参数的名称。 参数的 Direction 属性必须包含值“Out”、“InOut”或“Return”。 属性类型：**String** |
||||||||||||
**ReturnTypeDescriptorName** |
可选。 已弃用此属性。 请改用 ReturnTypeDescriptorPath。 属性类型：**String** |
||||||||||||
**ReturnTypeDescriptorLevel** |
可选。 已弃用此属性。 请改用 ReturnTypeDescriptorPath。 属性类型：**Integer** |
||||||||||||
**ReturnTypeDescriptorPath** |
可选。 关联 TypeDescriptor 的点式路径。 属性类型：**String** |
||||||||||||
**名字** |
必填。 关联名称。 属性类型：**String** |
||||||||||||
**DefaultDisplayName** |
可选。 关联的默认显示名称。 属性类型：**String** |
||||||||||||
**IsCached** |
可选。 指定是否频繁使用此关联。 默认值：**true** 属性类型：**布尔值** |
子元素
| 元素 | 说明 |
|---|---|
| MetadataObject (BDCMetadata 架构) 中的 LocalizedDisplayNames 元素 | LocalizedDisplayNames 元素指定 Association 的本地化名称列表 |
| MetadataObject (BDCMetadata 架构) 中的 Properties 元素 | Properties 元素指定关联的属性。 |
| AccessControlList 元素 (BDCMetadata 架构) | AccessControlList 元素指定一组关联的访问权限。 |
| 关联 (BDCMetadata 架构) 中的 SourceEntity 元素 | SourceEntity 元素指定关联中的源外部内容类型。 |
| 关联 (BDCMetadata 架构) 中的 DestinationEntity 元素 | DestinationEntity 元素指定关联中的目标外部内容类型。 |
父元素
| 元素 | 说明 |
|---|---|
| 方法 (BDCMetadata 架构) 中的 MethodInstances 元素 | 包含关联的 MethodInstances 元素。 |