SharePoint 的 BDC 模型架构引用

包含针对 BDC 模型架构 (BDCMetadata.xsd) 的参考文档,您可以使用该文档在 SharePoint 中创建外部内容类型。

AccessControlEntry 元素

包含为父元素指定访问权限的访问控制项 (ACE)。

请参阅 Business Connectivity Services 安全性概述 ,详细了解 Business Connectivity Services 和安全性。

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

架构: BDCMetadata


<AccessControlEntry Principal = "String"> </AccessControlEntry>

如下章节中介绍了属性、子元素和父元素。

属性

属性 说明
主体
必需。
具有此 ACE 的安全主体的名称。
属性类型: String

子元素

Element 说明
AccessControlEntry 中的 Right 元素(BDCMetadata 架构)
一个 Right 元素,指定安全主体的可用权限。

父元素

元素 说明
AccessControlList 元素(BDCMetadata 架构)
包含此 ACE 的访问控制列表 (ACL)。

AccessControlList 元素

为父元素指定访问控制列表 (ACL)。

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

架构: BDCMetadata

<AccessControlList></AccessControlList>

如下章节中介绍了属性、子元素和父元素。

属性

子元素

Element 说明
AccessControlList 中的 AccessControlEntry 元素(BDCMetadata 架构)
访问控制项 (ACE)。

父元素

元素 说明
Model 元素(BDCMetadata 架构)
包含业务应用程序中的外部内容类型的模型。
LobSystems 中的 LobSystem 元素(BDCMetadata 架构)
包含在模型中的 LobSystems。
Entities 中的 Entity 元素(BDCMetadata 架构)
外部内容类型。
Methods 中的 Method 元素(BDCMetadata 架构)
外部内容类型的方法。
MethodInstances 中的 Association 元素(BDCMetadata 架构)
一个关联。
MethodInstances 中的 MethodInstance 元素(BDCMetadata 架构)
外部内容类型的方法实例。

Action 元素

指定外部内容类型支持的操作。

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

Schema: BDCMetadata

操作通过提供返回到外部系统的链接,在 SharePoint 和 Office 2013 以及外部系统的用户界面之间架起沟通的桥梁。

默认情况下,在 BDC 模型中对这些操作建模之后,Business Data Connectivity (BDC) 服务 会提供 View ItemEdit ItemDelete Item 等操作。 除了这些默认操作之外,还可以为要附加到外部内容类型的其他功能创建操作。 例如,可使用各种操作执行一些简单的操作,如从"客户"外部内容类型向客户发送电子邮件或在浏览器中打开客户的主页。

操作会随外部内容类型一起出现。 也就是说,在为外部内容类型定义操作后,该操作会显示在显示该外部内容类型的位置(无论是在外部列表或业务数据 Web 部件中,还是在外部数据列中)。

<Action Position = "Integer" IsOpenedInNewWindow = "Boolean" Url = "String" ImageUrl = "String" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </Action>

如下章节中介绍了属性、子元素和父元素。

属性

属性 说明
Position
必需。
此操作的建议位置位于该外部内容类型的其他操作之间。
属性类型: Integer
IsOpenedInNewWindow
可选。
指定是否在新的用户界面窗口中显示执行操作的结果。
默认值: false
属性类型: Boolean
Url
必需。
调用该操作时要转到的 URL。 此 URL 字符串是 .NET Framework 格式的字符串。 每个格式说明符(例如 {0})都对应一个 Action 参数。
属性类型: String
ImageUrl
可选。
该操作的图标图像的绝对路径或相对路径。 图标图像应为 16x16 像素。
属性类型: String
名称
必需。
此操作的名称。
属性类型: String
DefaultDisplayName
可选。
此操作的默认显示名称。
属性类型: String
IsCached
可选。
指定是否频繁使用此操作。 BDC 客户端运行时使用该属性来缓存此操作。
默认值: true
属性类型: Boolean

子元素

Element 说明
MetadataObject 中的 LocalizedDisplayNames 元素(BDCMetadata 架构)
此操作的本地化名称。
MetadataObject 中的 Properties 元素(BDCMetadata 架构)
此操作的属性。
Action 中的 ActionParameters 元素(BDCMetadata 架构)
此操作的参数。

父元素

元素 说明
Entity 中的 Actions 元素(BDCMetadata 架构)
外部内容类型的操作列表。

ActionParameter 元素

指定基于 URL 的操作的参数。 该参数定义如何使用特定于 EntityInstance 的数据来将某个操作的 URL 参数化。

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

架构: BDCMetadata

基于 URL 的操作的 URL 属性可通过 ActionParameter 元素接收参数。

重要说明:ActionParameters 可以表示标识符值,也可以表示与实体的 SpecificFinder 中的 TypeDescriptors 对应的值。 当显示 IdOrdinal 属性时, ActionParameter 表示一个标识符值。 该属性值指定 ActionParameter 所表示的值的标识符的索引。 如果未指定 IdOrdinal 属性,则 ActionParameter 表示一个 TypeDescriptor,且 Name 属性指定所表示的类型描述符。 将 Name 属性指定为 Dotted Path

ActionParameter 元素接受以下属性。

重要说明:属性区分大小写。

属性

属性 类型 说明 必需。 默认值 限制/接受值
IdOrdinal
System.Int32
指定 ActionParameter 是否表示标识符而不是字段。
可选
<ActionParameter Index = "Integer" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </ActionParameter>

如下章节中介绍了属性、子元素和父元素。

属性

属性 说明
Index
必需。
一个序号属性,用于指定此 ActionParameter 在 URL 中的其他 ActionParameters 中的位置。
属性类型: Integer
名称
必需。
ActionParameter 的名称。
属性类型: String
DefaultDisplayName
可选。
ActionParameter 的默认显示名称。
属性类型: String
IsCached
可选。
指定是否频繁使用此 ActionParameter。 BDC 客户端运行时使用该属性来缓存此 Action
默认值: true
属性类型: Boolean

子元素

Element 说明
MetadataObject 中的 LocalizedDisplayNames 元素(BDCMetadata 架构)
ActionParameter 的本地化显示名。
MetadataObject 中的 Properties 元素(BDCMetadata 架构)
ActionParameter 的属性。

父元素

元素 说明
Action 中的 ActionParameters 元素(BDCMetadata 架构)
包含此 ActionParameterActionParameters 元素。

ActionParameters 元素

指定操作的 ActionParameters 的列表。

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

架构: BDCMetadata

<ActionParameters></ActionParameters>

如下章节中介绍了属性、子元素和父元素。

属性

无。

子元素

Element 说明
ActionParameters 中的 ActionParameter 元素(BDCMetadata 架构)
一个 ActionParameter

父元素

元素 说明
Actions 中的 Action 元素(BDCMetadata 架构)
这些 Action 所属的 ActionParameters

Action 元素

指定外部内容类型的操作列表。

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

架构: BDCMetadata

<Actions></Actions>

如下章节中介绍了属性、子元素和父元素。

属性

子元素

Element 说明
Actions 中的 Action 元素(BDCMetadata 架构)
外部内容类型的操作。

父元素

元素 说明
Entities 中的 Entity 元素(BDCMetadata 架构)
这些操作所属的外部内容类型。

Association 元素

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

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

架构: BDCMetadata

重要说明:属性区分大小写。

属性

属性 类型 说明 必需 默认值 限制/接受值
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

MethodInstanceBulkAssociationNavigator

Default
可选。
指定关联是否为在包含外部内容类型中共享其类型的所有关联的默认项。 如果设置为 true,则关联为在包含外部内容类型中共享其类型的所有关联的默认项。 如果设置为 false,则关联不是在包含外部内容类型中共享其类型的所有关联的默认项。
默认值: false
属性类型:Boolean
ReturnParameterName
可选。
包含关联 ReturnTypeDescriptor 的参数的名称。 参数的 Direction 属性必须包含"Out"、"InOut"或"Return"值中的一个。
属性类型:String
ReturnTypeDescriptorName
可选。
此属性已被弃用。 请改用 ReturnTypeDescriptorPath
属性类型:String
ReturnTypeDescriptorLevel
可选。
此属性已被弃用。 请改用 ReturnTypeDescriptorPath
属性类型:Integer
ReturnTypeDescriptorPath
可选。
关联的 TypeDescriptor 的点线路径。
属性类型: String
名称
必需。
关联名称。
属性类型: String
DefaultDisplayName
可选。
关联的默认显示名称。
属性类型: String
IsCached
可选。
指定是否频繁使用此关联。
默认值: true
属性类型: Boolean

子元素

Element 说明
MetadataObject 中的 LocalizedDisplayNames 元素(BDCMetadata 架构)
LocalizedDisplayNames 元素为关联指定已本地化名称的列表。
MetadataObject 中的 Properties 元素(BDCMetadata 架构)
Properties 元素指定关联的属性。
AccessControlList 元素(BDCMetadata 架构)
AccessControlList 元素为关联指定一组访问权限。
Association 中的 SourceEntity 元素(BDCMetadata 架构)
SourceEntity 元素指定关联中的源外部内容类型。
Association 中的 DestinationEntity 元素(BDCMetadata 架构)
DestinationEntity 元素指定关联中的目标外部内容类型。

父元素

元素 说明
Method 中的 MethodInstances 元素(BDCMetadata 架构)
包含关联的 MethodInstances 元素。

AssociationGroup 元素

指定 AssociationGroupAssociationGroup 是将相关的 AssociationMethods 关联在一起的构造结构。 例如, GetOrdersForCustomerGetCustomerForOrderAssociateCustomerToOrder 是处理客户与订单之间的相同关系的所有关联方法。

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

架构: BDCMetadata

必须在 Entity 元素上定义 AssociationGroup,此元素作为未标记为 ReverseAssociationReferences 的目标或标记为 Reverse 的 AssociationReferences 的源。

<AssociationGroup Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </AssociationGroup>

如下章节中介绍了属性、子元素和父元素。

属性

属性 说明
名称
必需。
AssociationGroup 的名称。
属性类型: String
DefaultDisplayName
可选。
AssociationGroup 的默认显示名称。
属性类型: String
IsCached
可选。
指定是否频繁使用 AssociationGroup
默认值: true
属性类型: Boolean

子元素

Element 说明
MetadataObject 中的 LocalizedDisplayNames 元素(BDCMetadata 架构)
AssociationGroup 的本地化名称。
MetadataObject 中的 Properties 元素(BDCMetadata 架构)
AssociationGroup 的属性。
AssociationGroup 中的 AssociationReference 元素(BDCMetadata 架构)
AssociationGroupAssociationReference

父元素

元素 说明
Entity 中的 AssociationGroups 元素(BDCMetadata 架构)
包含此 AssociationGroupsAssociationGroup 元素。

AssociationGroups 元素

指定 AssociationGroup 元素的列表。

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

架构: BDCMetadata

<AssociationGroups></AssociationGroups>

如下章节中介绍了属性、子元素和父元素。

属性

子元素

Element 说明
AssociationGroups 中的 AssociationGroup 元素(BDCMetadata 架构)
一个 AssociationGroup

父元素

元素 说明
Entities 中的 Entity 元素(BDCMetadata 架构)
与此 AssociationGroups 元素相关的外部内容类型。

AssociationReference 元素

AssociationGroup 中指定 AssociationReference

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

架构: BDCMetadata

<AssociationReference EntityNamespace = "String" EntityName = "String" AssociationName = "String" Reverse = "Boolean"> </AssociationReference>

如下章节中介绍了属性、子元素和父元素。

属性

属性 说明
EntityNamespace
可选。
用于定义 Association 的外部内容类型的命名空间。 如果指定 EntityName,则 EntityNamespace 是必需的。
属性类型: String
EntityName
可选。
用于定义 Association 的外部内容类型的命名空间。 如果指定 EntityNamespace,则 EntityName 是必需的。
属性类型: String
AssociationName
必需。
Association 的名称。
属性类型: String
反转
可选。
指定引用的 Association 已将其源和目标反转。 这表示 Association 与同一 AssociationGroup 中的其他关联的工作方向相反。 例如,如果 AssociationGroup 引用 Association"GetOrdersForCustomer"(它返回给定客户项目的订单项目),则 AssociationGroup 的工作方向为客户到订单。 必须将引用另一个关联 "GetCustomerForOrder" 的另一个 AssociationReference 标记为反转,因为此关联的工作方向为订单到客户。
默认值: false
属性类型: Boolean

子元素

父元素

元素 说明
AssociationGroups 中的 AssociationGroup 元素(BDCMetadata 架构)
AssociationReference 所属的 AssociationGroup

ConvertType 元素

指定将数据值的数据类型转换为另一种数据类型的规则。

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

Schema: BDCMetadata

Convert 元素指定将数据值的数据类型转换为另一种数据类型的规则。 在按顺序应用规则时,此规则指定将数据值的数据类型转换为 BDCType 属性指定的数据类型。 在反向应用规则时,此规则指定将数据值的数据类型转换为 LOBType 属性指定的数据类型。 例如,此规则可以指定将从外部系统获取的日期值转换为将最终显示给用户的区域性和区域设置敏感的字符串,并将该字符串的更新值转换回与外部系统兼容的日期。

警告:ConvertType 不支持非公历在 System.StringSystem.DateTime 之间进行转换。

<ConvertType LOBType = "String" BDCType = "String"> </ConvertType>

下面各部分介绍了属性、子元素和父元素。

属性

属性 说明
LOBType
必需。
反向应用规则时要将数据值转换为的数据类型。
属性类型: String
BDCType
必需。
按顺序应用规则时要将数据值转换为的数据类型。
属性类型: String
LOBLocale
可选。
从外部系统收到的数据的区域设置。

子元素

父元素

元素 说明
TypeDescriptor 中的 Interpretation 元素(BDCMetadata 架构)
应用于 TypeDescriptor 所表示的数据结构中存储的数据的规则。

DefaultValue 元素

表示默认值。

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

架构: BDCMetadata

<DefaultValue MethodInstanceName = "String" Type = "String"> </DefaultValue>

如下章节中介绍了属性、子元素和父元素。

属性

属性 说明
MethodInstanceName
必需。
要将此 DefaultValue 应用于的 MethodInstance 的名称。
属性类型: String
Type
必需。
默认值的数据类型。
以下是此属性的可接受的值。
System.Int16
System.Int32
System.Int64
System.Single
System.Double
System.Decimal
System.Boolean
System.Byte
System.UInt16
System.UInt32
System.UInt64
System.Guid
System.String
System.DateTime
任何其他可序列化的类型(例如,此处 Type.IsSerializable == true
属性类型: String

子元素

父元素

元素 说明
TypeDescriptor 中的 DefaultValues 元素(BDCMetadata 架构)

DefaultValues 元素

指定 TypeDescriptorDefaultValues 列表。

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

架构: BDCMetadata

<DefaultValues></DefaultValues>

如下章节中介绍了属性、子元素和父元素。

属性

子元素

Element 说明
DefaultValues 中的 DefaultValue 元素(BDCMetadata 架构)
MethodInstanceTypeDescriptor 的默认值。

父元素

元素 说明
TypeDescriptor 元素(BDCMetadata 架构)
这些 TypeDescriptor 所属的 DefaultValues

DestinationEntity 元素

指定 Association 中的目标外部内容类型。

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

架构: BDCMetadata

<DestinationEntity Namespace = "String" Name = "String"> </DestinationEntity>

如下章节中介绍了属性、子元素和父元素。

属性

属性 说明
命名空间
必需。
实体命名空间的名称。
属性类型: String
名称
必需。
目标实体的名称。
属性类型: String

子元素

父元素

元素 说明
MethodInstances 中的 Association 元素(BDCMetadata 架构)

Entities 元素

指定外部系统中的外部内容类型的类表。

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

架构: BDCMetadata

<Entities></Entities>

如下章节中介绍了属性、子元素和父元素。

属性

子元素

Element 说明
Entities 中的 Entity 元素(BDCMetadata 架构)
外部系统中的外部内容类型。

父元素

元素 说明
LobSystems 中的 LobSystem 元素(BDCMetadata 架构)
外部系统。

Entity 元素

指定外部内容类型。

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

架构: BDCMetadata

<Entity Namespace = "String" Version = "String" EstimatedInstanceCount = "Integer" DefaultOperationMode = "String" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </Entity>

如下章节中介绍了属性、子元素和父元素。

属性

属性 说明
命名空间
必需。
此外部内容类型所属的命名空间。
属性类型: String
注意:命名空间不得包含星号特殊字符“*”。
版本
必需。
此外部内容类型的版本号。
属性类型:String
警告:当 BDC 模型变化时,必须增加外部内容类型的版本号。 如果外部内容类型的结构发生变化,应增加主要版本号。 结构性更改的示例包括向 SpecificFinder 添加字段或更改标识符字段。 如果更改不影响外部内容类型的结构(例如,添加 Creator 方法、更改连接信息或更改 LobSystems 和类型描述符的名称),应更改内部版本号和修订号。
EstimatedInstanceCount
可选。
外部系统包含的外部项的估计数目。
默认值:10000
属性类型: Integer
DefaultOperationMode
可选。
指定在创建、删除、更新或读取外部项时与外部系统交互时的默认行为。
默认值:Default
下表列出了该属性可能的值。

说明

联机

绕过所有操作的缓存的外部项,直接与外部系统交互。

Cached

直接针对缓存的外部项执行 CreateReadUpdateDelete 操作。 对于 Read 操作,如果请求的外部项在缓存中可用,请使用缓存中的外部项。 否则,绕过缓存从外部系统获取外部项,然后将它放置在缓存中以便以后使用。

Offline

只针对缓存的外部项执行 CreateReadUpdateDelete 操作。

Default

使用系统默认行为。 如果环境支持缓存外部项,则使用缓存模式。

名称
必需。
外部内容类型的名称。
属性类型: String
注意:外部内容类型的名称不得包含星号特殊字符“*”。
DefaultDisplayName
可选。
外部内容类型的默认显示名称。
属性类型: String
IsCached
可选。
指定此外部内容类型是否将经常使用。 如果设置为 True,Business Data Connectivity (BDC) 服务 将在内存中缓存此外部内容类型。
默认值: true
属性类型: Boolean

子元素

Element 说明
MetadataObject 中的 LocalizedDisplayNames 元素(BDCMetadata 架构)
此外部内容类型的本地化显示名称。
MetadataObject 中的 Properties 元素(BDCMetadata 架构)
此外部内容类型的属性。
AccessControlList 元素(BDCMetadata 架构)
此外部内容类型的访问控制列表 (ACL)。
Entity 中的 Identifiers 元素(BDCMetadata 架构)
外部内容类型的标识符。
Entity 中的 Methods 元素(BDCMetadata 架构)
外部内容类型的方法。
Entity 中的 AssociationGroups 元素(BDCMetadata 架构)
外部内容类型的关联组。
Entity 中的 Actions 元素(BDCMetadata 架构)
外部内容类型的操作。

父元素

元素 说明
LobSystem 中的 Entities 元素(BDCMetadata 架构)
此外部系统中外部内容类型的列表。

FilterDescriptor 元素

指定方法的筛选器描述符。

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

架构: BDCMetadata

<FilterDescriptor Type = "String" FilterField = "String" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </FilterDescriptor>

如下章节中介绍了属性、子元素和父元素。

属性

属性 说明
类型
必需。
筛选器描述符的类型。
下表列出了该属性可能的值。

说明

Limit

查询外部系统时使用,此属性的值可以解释为调用所属方法时返回的外部项 EntityInstances 的项数限制。

PageNumber

通配符

查询外部系统时使用。 它的值表示常规字符和通配符模式,该模式与一组 EntityInstances 的特定字段的值进行匹配。 外部系统仅返回其字段值与指定模式匹配的那些 EntityInstances

UserContext

查询外部系统时使用。 它的值可以由任何客户端应用程序自动设置为调用外部系统的用户的标识。 然后,外部系统可以使用该值进行授权并筛选返回的结果。

UserCulture

Username

Password

LastId

SsoTicket

UserProfile

查询外部系统时使用。 它的值可以通过检查当前用户的配置文件获得。 外部系统可以使用它的值筛选返回的结果。

Comparison

查询外部系统时使用。 外部系统可以将 ComparisonFilter 值与一组 EntityInstances 的特定字段的值进行比较,并仅返回其字段值通过了比较测试的那些 EntityInstances

Timestamp

Input

在调用外部系统中的操作时使用。 外部系统可以使用 InputFilter 的值作为操作的其他参数。

Output

在调用外部系统中的操作时使用。 ReturnTypeDescriptor 不能捕获的其他操作结果可以作为 InputOutputFilter 的值进行检索。

InputOutput

在调用外部系统中的操作时使用。 外部系统可以使用 InputOutputFilter 的值作为操作的其他参数, ReturnTypeDescriptor 不能捕获的其他操作结果可以作为 InputOutputFilter 的值进行检索。

Batching

BatchingTermination

ActivityId

ActivityId 在调用外部系统的操作时使用。 它的值设置为表示当前操作上下文的 GUID。 如果没有提供此类值,则此筛选器将生成随机 GUID。 在 SharePoint Foundation 2010 中,此筛选器使用 CorrelationID

FilterField
可选。
属性类型: String
名称
必需。
筛选器描述符的名称。
属性类型: String
DefaultDisplayName
可选。
筛选器描述符的默认显示名称。
属性类型: String
IsCached
可选。
指定是否经常使用此筛选器描述符。 如果设置为 true,则 Business Data Connectivity (BDC) 服务 会在内存中缓存此筛选器描述符。
默认值: true
属性类型: Boolean

子元素

Element 说明
MetadataObject 中的 LocalizedDisplayNames 元素(BDCMetadata 架构)
此筛选器描述符的本地化显示名称。
MetadataObject 中的 Properties 元素(BDCMetadata 架构)
此筛选器描述符的属性。

父元素

元素 说明
Method 中的 FilterDescriptors 元素(BDCMetadata 架构)
方法的筛选器描述符列表。

FilterDescriptors 元素

指定方法的筛选器描述符的列表。

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

架构: BDCMetadata

<FilterDescriptors></FilterDescriptors>

如下章节中介绍了属性、子元素和父元素。

属性

子元素

Element 说明
FilterDescriptors 中的 FilterDescriptor 元素(BDCMetadata 架构)
筛选器描述符。

父元素

元素 说明
Methods 中的 Method 元素(BDCMetadata 架构)
此筛选器描述符列表所属的方法。

Identifier 元素

指定外部内容类型的标识符。

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

架构:BDCMetadata

注意

Business Data Connectivity (BDC) Service 支持将标识符映射到数据类型可以为 null 的字段。 不过,对于主标识符,如果这些标识符的值为 null,BDC 会导致错误生成。

<Identifier TypeName = "String" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </Identifier>

下面各部分介绍了属性、子元素和父元素。

属性

属性 说明
TypeName
必需。
与标识符相对应的值的数据类型。
下表列出了该属性可能的值。

说明

System.Boolean

一位。

System.Byte

一个介于 0 到 255 之间(含这两个值)的数字。

System.Char

一个 Unicode 字符。

System.DateTime

一个介于公元 1 年 1 月 1 日午夜 12:00:00 到公元 9999 年 12 月 31 日 11:59:59 P.M. 之间(含这两个值)的日期和时间,分辨率为 100 纳秒。

System.Decimal

一个介于 -79,228,162,514,264,337,593,543,950,335 到 +79,228,162,514,264,337,593,543,950,335 之间(含这两个值)的数字。

System.Double

一个介于 -1.79769313486232e308 到 +1.79769313486232e308 之间(含这两个值)的双精度数字,以及正零、负零、无穷大正数、无穷大负数和非数值 (NAN)。

System.Guid

一个 GUID。

System.Int16

一个介于 -32768 到 +32767 之间(含这两个值)的数字。

System.Int32

一个介于 0 到 4,294,967,295 之间(含这两个值)的数字。

System.Int64

一个介于 0 到 18,446,744,073,709,551,615 之间(含这两个值)的数字。

System.SByte

一个介于 -128 到 +127 之间(含这两个值)的数字。

System.Single

一个介于 -3.402823e38 到 +3.402823e38 之间(含这两个值)的单精度数字。

System.String

一个 Unicode 文本字符串。

System.TimeSpan

一个介于 -10675199 天 2 小时 48 分 5 秒 477 毫秒 580 微秒 800 纳秒到 +10675199 天 2 小时 48 分 5 秒 477 毫秒 580 微秒 800 纳秒之间(含这两个值)的持续时间,分辨率为 100 纳秒。

System.UInt16

一个介于 0 到 65535 之间(含这两个值)的数字。

System.UInt32

一个介于 0 到 4,294,967,295 之间(含这两个值)的数字。

System.UInt64

一个介于 0 到 18,446,744,709,551,615 之间(含这两个值)的数字。

名称
必需。
标识符的名称。
属性类型: String
DefaultDisplayName
可选。
标识符的默认显示名称。
属性类型: String
IsCached
可选。
指定是否频繁使用此标识符。 如果设置为 true,则 Business Data Connectivity (BDC) 服务 将此标识符缓存到内存中。
默认值: true
属性类型: Boolean

子元素

Element 说明
MetadataObject 中的 LocalizedDisplayNames 元素(BDCMetadata 架构)
标识符的本地化显示名称。
MetadataObject 中的 Properties 元素(BDCMetadata 架构)
标识符的属性。

父元素

元素 说明
Entity 中的 Identifiers 元素(BDCMetadata 架构)
外部内容类型的标识符列表。

Identifiers 元素

指定外部内容类型的标识符的列表。

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

架构: BDCMetadata

<Identifiers></Identifiers>

如下章节中介绍了属性、子元素和父元素。

属性

子元素

Element 说明
Identifiers 中的 Identifier 元素(BDCMetadata 架构)
指定标识符。

父元素

元素 说明
Entities 中的 Entity 元素(BDCMetadata 架构)
包含此标识符列表的外部内容类型。

Interpretation 元素

指定要应用于存储在由 TypeDescriptor 表示的数据结构中的数据的规则。 这些规则通常专用于更改由外部系统返回的数据值,以便能更轻松地在用户界面中表示它们。 在从外部系统获取数据值时,必须按照在 Interpretation 元素中指定规则的顺序来应用这些指定的规则。 必须将第一个规则应用于从外部系统接收的数据值;后面的规则将应用于通过应用上一个规则所生成的数据值。 在将数据值发送到外部系统时,必须按照在 Interpretation 元素中指定规则的顺序的相反顺序来应用这些指定的规则。 必须将第一个规则应用于从用户接收的数据值;后面的规则将应用于通过应用上一个规则所生成的数据值。

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

架构: BDCMetadata

<Interpretation></Interpretation>

如下章节中介绍了属性、子元素和父元素。

属性

子元素

Element 说明
Interpretation 中的 ConvertType 元素(BDCMetadata 架构)
一个 ConvertType 元素,它指定从一个数据类型到另一个数据类型的转换。
Interpretation 中的 NormalizeDateTime 元素(BDCMetadata 架构)
一个 NormalizeDateTime 元素,它指定从外部系统获得的值的日期和时间表示形式到另一种表示形式的转换。
NormalizeString
一个 NormalizeString 元素,它指定从外部系统获得的值的字符串表示形式到另一种表示形式的转换。

父元素

元素 说明
TypeDescriptor 元素(BDCMetadata 架构)
TypeDescriptor 元素。

LobSystem 元素

表示外部数据源。

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

架构: BDCMetadata

<LobSystem Type = "String" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </LobSystem>

如下章节中介绍了属性、子元素和父元素。

属性

属性 说明
类型
LobSystem 的类型。
必需。
下表列出了该属性可能的值。

说明

数据库

表示的外部数据源为数据库。

DotNetAssembly

表示的外部数据源为 .NET Framework 类的集合。

Wcf

表示的外部数据源为 WCF 服务端点。

WebService

表示的外部数据源为 Web 服务。 已弃用,改用 Wcf。

自定义

表示的外部数据源实现了自定义连接器来管理连接和数据传输。

Name
LobSystem 名称。
必需。
属性类型: String
DefaultDisplayName
LobSystem 的默认显示名称。
可选。
属性类型: String
IsCached
指定是否经常使用 LobSystem。 如果经常使用,Business Data Connectivity (BDC) Service 将会缓存 LobSystem
可选。
默认值: true
属性类型: Boolean

子元素

Element 说明
MetadataObject 中的 LocalizedDisplayNames 元素(BDCMetadata 架构)
LobSystem 的本地化名称。
MetadataObject 中的 Properties 元素(BDCMetadata 架构)
指定 LobSystem 的属性。
AccessControlList 元素(BDCMetadata 架构)
指定 LobSystem 的访问控制列表 (ACL)。
LobSystem 中的 Proxy 元素(BDCMetadata 架构)
如果此元素不存在,则指定与生成的代理相同的用户提供的代理。
LobSystem 中的 LobSystemInstances 元素(BDCMetadata 架构)
为此外部系统指定外部系统实例。
LobSystem 中的 Entities 元素(BDCMetadata 架构)
在此外部系统中指定外部内容类型。

父元素

元素 说明
Model 中的 LobSystems 元素(BDCMetadata 架构)
在此模型中指定外部系统列表。

LobSystemInstance 元素

指定外部系统实例。

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

架构: BDCMetadata

<LobSystemInstance Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </LobSystemInstance>

如下章节中介绍了属性、子元素和父元素。

属性

属性 说明
名称
必需。
外部系统实例的名称。
属性类型: String
DefaultDisplayName
可选。
外部系统实例的默认显示名称。
属性类型: String
IsCached
可选。
指定是否经常使用此外部系统实例。 如果设置为 true,Business Data Connectivity (BDC) 服务 将缓存外部系统实例。
默认值: true
属性类型: Boolean

子元素

Element 说明
MetadataObject 中的 LocalizedDisplayNames 元素(BDCMetadata 架构)
此外部系统实例的本地化名称。
MetadataObject 中的 Properties 元素(BDCMetadata 架构)
此外部系统实例的属性。

父元素

元素 说明
LobSystem 中的 LobSystemInstances 元素(BDCMetadata 架构)
外部系统实例的列表。

LobSystemInstances 元素

指定外部系统实例的列表。

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

架构: BDCMetadata

<LobSystemInstances></LobSystemInstances>

如下章节中介绍了属性、子元素和父元素。

属性

子元素

Element 说明
LobSystemInstances 中的 LobSystemInstance 元素(BDCMetadata 架构)
外部系统实例。

父元素

元素 说明
LobSystems 中的 LobSystem 元素(BDCMetadata 架构)
外部系统。

LobSystems 元素

指定模型的 LobSystem 元素的列表。

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

架构: BDCMetadata

<LobSystems></LobSystems>

如下章节中介绍了属性、子元素和父元素。

属性

子元素

Element 说明
LobSystems 中的 LobSystem 元素(BDCMetadata 架构)
指定外部系统的 LobSystem

父元素

元素 说明
Model 元素(BDCMetadata 架构)
应用程序定义(BDC 模型)。

LocalizedDisplayName 元素

指定本地化名称。

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

架构: BDCMetadata

<LocalizedDisplayName LCID = "Integer"> </LocalizedDisplayName>

如下章节中介绍了属性、子元素和父元素。

属性

属性 说明
LCID
必需。
语言代码标识符 (LCID)。
属性类型: Integer

子元素

父元素

元素 说明
MetadataObject 中的 LocalizedDisplayNames 元素(BDCMetadata 架构)
包含此 LocalizedDisplayNamesLocalizedDisplayName 元素。

LocalizedDisplayNames 元素

指定 MetadataObject 的本地化名称的列表。

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

架构: BDCMetadata

<LocalizedDisplayNames></LocalizedDisplayNames>

如下章节中介绍了属性、子元素和父元素。

属性

子元素

Element 说明
LocalizedDisplayNames 中的 LocalizedDisplayName 元素(BDCMetadata 架构)
本地化名称。

父元素

元素 说明
Model 元素(BDCMetadata 架构)
LobSystems 中的 LobSystem 元素(BDCMetadata 架构)
LobSystemInstances 中的 LobSystemInstance 元素(BDCMetadata 架构)
Entities 中的 Entity 元素(BDCMetadata 架构)
Identifiers 中的 Identifier 元素(BDCMetadata 架构)
Methods 中的 Method 元素(BDCMetadata 架构)
FilterDescriptors 中的 FilterDescriptor 元素(BDCMetadata 架构)
Parameters 中的 Parameter 元素(BDCMetadata 架构)
TypeDescriptor 元素(BDCMetadata 架构)
MethodInstances 中的 Association 元素(BDCMetadata 架构)
MethodInstances 中的 MethodInstance 元素(BDCMetadata 架构)
AssociationGroups 中的 AssociationGroup 元素(BDCMetadata 架构)
Actions 中的 Action 元素(BDCMetadata 架构)
ActionParameters 中的 ActionParameter 元素(BDCMetadata 架构)

MetadataObject 元素

命名空间:

架构:


如下章节中介绍了属性、子元素和父元素。

属性

子元素

父元素

Method 元素

指定外部内容类型的方法。

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

架构: BDCMetadata

<Method IsStatic = "Boolean" LobName = "String" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </Method>

如下章节中介绍了属性、子元素和父元素。

属性

属性 说明
IsStatic
可选。
指定执行此方法时是否需要一个外部项 ( EntityInstance) 来充当执行上下文。 如果设置为 true,则此方法表示一个静态方法,它不需要特定的 EntityInstance 来提供执行上下文。 如果设置为 false,则此方法表示一个实例方法,它需要一个 EntityInstance 来提供执行上下文。
默认值: true
属性类型: Boolean
LobName
可选。
外部系统中定义的由此方法表示的操作的名称。
属性类型: String
名称
必需。
此方法的名称。
属性类型: String
DefaultDisplayName
可选。
方法的默认显示名称。
属性类型: String
IsCached
可选。
指定是否频繁使用此方法。 如果设置为 true,则 Business Data Connectivity (BDC) 服务 将此方法缓存到内存中。
默认值: true
属性类型: Boolean

子元素

Element 说明
MetadataObject 中的 LocalizedDisplayNames 元素(BDCMetadata 架构)
此方法的本地化显示名称。
MetadataObject 中的 Properties 元素(BDCMetadata 架构)
此方法的属性。
AccessControlList 元素(BDCMetadata 架构)
此方法的访问控制列表 (ACL)。
Method 中的 FilterDescriptors 元素(BDCMetadata 架构)
此方法的筛选器描述符。
Method 中的 Parameters 元素(BDCMetadata 架构)
此方法的参数。 一个方法不能有多个返回参数。
Method 中的 MethodInstances 元素(BDCMetadata 架构)
此方法的方法实例。

父元素

元素 说明
Entity 中的 Methods 元素(BDCMetadata 架构)
外部内容类型的方法列表。

MethodInstance 元素

指定 MethodInstance

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

架构:BDCMetadata

BDC 模型中的以下两种情况会导致运行时 出现 InvalidOperationException

  • 两个 SpecificFinder 方法实例,它们返回相同的字段集。

  • 两个 SpecificFinder 方法实例,它们具有相同数量的字段并与另一个方法实例(如 Finder)共享相同数量的字段。

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

如下章节中介绍了属性、子元素和父元素。

属性

属性 说明
Type
必需。
指定 MethodInstance 的类型。
下表列出了该属性可能的值。

说明

Finder

一种 MethodInstance 类型,可调用它以返回包含特定 Entity 的零个或多个 EntityInstances 的集合。 Finder 输入由包含 FinderMethod 中包含的 FilterDescriptors 定义。

SpecificFinder

一种 MethodInstance 类型,可调用它以返回特定 Entity(给定其 EntityInstanceId)的特定 EntityInstanceSpecificFinder 输入由与 Entity 关联的 Identifiers 定义和排序。

GenericInvoker

一种 MethodInstance 类型,可调用它以便在外部系统中执行特定任务。 GenericInvoker 输入和输出因 Method 而异。

IdEnumerator

一种 MethodInstance 类型,可调用它以返回表示特定 EntityEntityInstances 的标识的 Field 值。 IdEnumerator 输入是由 FilterDescriptors 定义的,后者包含在包含用于获取 ID 列表的 IdEnumerator 的方法中,这些 ID 是可搜索的每个实体的唯一键。 此方法实例在 SharePoint Server 中启用了外部数据搜索。

ChangedIdEnumerator

一种 MethodInstance 类型,可调用它以检索经指定时间后在外部系统中修改过的 EntityInstancesEntityInstanceIds

DeletedIdEnumerator

一种 MethodInstance 类型,可调用它以检索经指定时间后从外部系统中删除的 EntityInstancesEntityInstanceIds

Scalar

一个 MethodInstance,它返回可在外部系统中调用的单一值。 例如,可使用标量方法实例从外部系统获取到目前为止实现的总销售额。 Entities 具有零个或多个标量方法实例。

AccessChecker

一种 MethodInstance 类型,可调用它以检索调用安全主体拥有的针对每个 EntityInstances 集合(由指定的 EntityInstanceIds 标识)的权限。

Creator

一种 MethodInstance 类型,可调用它以创建 EntityInstance。 创建 EntityInstance 所需的字段集合称为"生成器视图"。

Deleter

一种 MethodInstance 类型,可调用它以删除具有指定的 EntityInstanceIdEntityInstance

Updater

一种 MethodInstance 类型,可调用它以更新由指定的 EntityInstanceId 标识的 EntityInstance。 更新 EntityInstance 所需的字段集合称为"更新程序视图"。 更改其值前应先传递这些值的字段的集合称为"预更新程序视图"。

StreamAccessor

一种 MethodInstance 类型,可调用它以检索采用字节数据流形式的 EntityInstance 的字段。

BinarySecurityDescriptorAccessor

一种 MethodInstance 类型,可调用它以从外部系统检索字节序列。 特定于系统的字节序列描述一组安全主体以及每个安全主体拥有的针对 EntityInstance(由指定的 EntityInstanceId 标识)的关联权限。

BulkSpecificFinder

一种 MethodInstance 类型,可调用它以返回 Entity 的一组特定的 EntityInstances(给定一组相应的 EntityInstanceIds)。

BulkIdEnumerator

一种 MethodInstance 类型,可调用它以检索有关对应于给定标识的外部项的最少信息。 此方法实例可用于优化缓存数据的同步。 此方法应仅返回对应于给定 Identities 的外部项的标识和版本信息,调用的应用程序可将这些标识与本地版本进行比较以确定是否有任何项发生了更改,如果有,则请求更改的外部项以更新缓存数据。

Default
可选。
指定 MethodInstance 是否是在包含外部内容类型 (Entity) 中共用类型的所有 MethodInstance 的默认值。
默认值: false
属性类型:Boolean
ReturnParameterName
可选。
Parameter(它包含 MethodInstanceReturnTypeDescriptor)的名称。 ParameterDirection 属性必须是具有 OutInOutReturn 值的 ParameterDirection 属性。
必须为所有类型的 MethodInstancesGenericInvokerCreatorDeleterUpdater 除外)指定此属性。
属性类型:String
ReturnTypeDescriptorLevel
可选。
此属性已被弃用。 请改用 ReturnTypeDescriptorPath
属性类型:Integer
ReturnTypeDescriptorPath
可选。
关联的 TypeDescriptor 的点线路径。
属性类型: String
名称
必需。
指定 MethodInstance 名称。
属性类型: String
DefaultDisplayName
可选。
指定 MethodInstance 的默认显示名称。
属性类型: String
IsCached
可选。
指定是否经常使用 MethodInstance
默认值: true
属性类型: Boolean

子元素

Element 说明
MetadataObject 中的 LocalizedDisplayNames 元素(BDCMetadata 架构)
MethodInstance 的本地化显示名称。
MetadataObject 中的 Properties 元素(BDCMetadata 架构)
MethodInstance 的属性。
AccessControlList 元素(BDCMetadata 架构)
MethodInstance 访问控制列表 (ACL)。

父元素

元素 说明
Method 中的 MethodInstances 元素(BDCMetadata 架构)
包含此 MethodInstancesMethodInstance 元素。

MethodInstances 元素

指定某个方法的关联和方法实例的列表。

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

架构: BDCMetadata

<MethodInstances></MethodInstances>

如下章节中介绍了属性、子元素和父元素。

属性

子元素

Element 说明
MethodInstances 中的 Association 元素(BDCMetadata 架构)
一个关联。
MethodInstances 中的 MethodInstance 元素(BDCMetadata 架构)
一个方法实例。

父元素

元素 说明
Methods 中的 Method 元素(BDCMetadata 架构)
此方法实例所属的方法。

Methods 元素

指定外部内容类型的方法的列表。

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

架构: BDCMetadata

<Methods></Methods>

如下章节中介绍了属性、子元素和父元素。

属性

子元素

Element 说明
Methods 中的 Method 元素(BDCMetadata 架构)
指定方法。

父元素

元素 说明
Entities 中的 Entity 元素(BDCMetadata 架构)
此方法列表所属的外部内容类型。

Model 元素

指定表示应用程序定义的根元素。 模型定义由外部应用程序包含的外部内容类型。

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

架构: BDCMetadata

<Model Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </Model>

如下章节中介绍了属性、子元素和父元素。

属性

属性 说明
名称
Model 的名称。
必需。
属性类型: String
DefaultDisplayName
Model 的默认显示名称。
可选。
属性类型: String
IsCached
指定是否频繁使用 Model。 如果设置为 true,则 Business Data Connectivity (BDC) 服务 缓存 Model
可选。
默认值: true
属性类型: Boolean

子元素

Element 说明
MetadataObject 中的 LocalizedDisplayNames 元素(BDCMetadata 架构)
Model 的本地化名称。
MetadataObject 中的 Properties 元素(BDCMetadata 架构)
Model 的属性。
AccessControlList 元素(BDCMetadata 架构)
Model 的访问控制列表 (ACL)。
Model 中的 LobSystems 元素(BDCMetadata 架构)
包含在此 Model 内部的 LobSystems

父元素

NormalizeDateTime 元素

指定用于将日期和时间值的表示形式转换为另一种表示形式的规则。 例如,此规则可指定将以协调世界时 (UTC) 表示的值转换为本地时区。

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

架构: BDCMetadata

<NormalizeDateTime LobDateTimeMode = "String"> </NormalizeDateTime>

如下章节中介绍了属性、子元素和父元素。

属性

属性 说明
LobDateTimeMode
必需。
指定要应用的转换。
下表列出了该属性可能的值。

说明

UTC

从外部系统收到的值为 UTC(协调世界时)。 如果收到的值为 Local,则它将转换为 UTC。 BDC 将 UTC 发送给外部系统。

Local

从外部系统收到的值为 Local。 如果从外部系统收到的值为 Local,则它将转换为 UTC。 BDC 将 Local 发送给外部系统。

Unspecified

外部系统发送的值具有 Unspecified 种类。 BDC 通过将该种类覆盖为 UTC 来假定值采用 UTC。 BDC 将 UTC 值作为 Unspecified 种类发送给外部系统。

子元素

父元素

元素 说明
TypeDescriptor 中的 Interpretation 元素(BDCMetadata 架构)
一个 Interpretation 元素,指定要应用于存储在 TypeDescriptor 所表示的数据结构中的数据的规则。

NormalizeString 元素

指定方法的参数。

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

架构: BDCMetadata


如下章节中介绍了属性、子元素和父元素。

属性

子元素

父元素

Parameter 元素

指定方法的参数。

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

架构: BDCMetadata

<Parameter Direction = "String" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </Parameter>

如下章节中介绍了属性、子元素和父元素。

属性

属性 说明
方向
必需。
参数的方向。
下表列出了该属性可能的值。

说明

所表示的 Parameter 为输入参数。

Out

所表示的参数为输出参数。

InOut

所表示的参数为输入和输出参数。 在 C# 中,这些对应于“ref”。

Return

表示的参数为返回参数。

Name
必需。
参数的名称。
属性类型: String
DefaultDisplayName
可选。
参数的默认显示名称。
属性类型: String
IsCached
可选。
指定是否经常使用 Parameter
默认值: true
属性类型: Boolean

子元素

Element 说明
MetadataObject 中的 LocalizedDisplayNames 元素(BDCMetadata 架构)
参数的本地化名称。
MetadataObject 中的 Properties 元素(BDCMetadata 架构)
参数的属性。
TypeDescriptor
参数的根类型描述符。

父元素

元素 说明
Method 中的 Parameters 元素(BDCMetadata 架构)
包含此参数的 Parameters 元素。

Parameters 元素

指定某个方法的参数的列表。

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

架构: BDCMetadata

<Parameters></Parameters>

如下章节中介绍了属性、子元素和父元素。

属性

子元素

Element 说明
Parameters 中的 Parameter 元素(BDCMetadata 架构)
一个参数。

父元素

元素 说明
Methods 中的 Method 元素(BDCMetadata 架构)
这些参数所属的方法。

Properties 元素

指定元数据对象的属性列表。

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

架构: BDCMetadata

<Properties></Properties>

如下章节中介绍了属性、子元素和父元素。

属性

子元素

Element 说明
Properties 中的 Property 元素(BDCMetadata 架构)
指定一个属性。

父元素

元素 说明
Model 元素(BDCMetadata 架构)
LobSystems 中的 LobSystem 元素(BDCMetadata 架构)
LobSystemInstances 中的 LobSystemInstance 元素(BDCMetadata 架构)
Entities 中的 Entity 元素(BDCMetadata 架构)
Identifiers 中的 Identifier 元素(BDCMetadata 架构)
Methods 中的 Method 元素(BDCMetadata 架构)
FilterDescriptors 中的 FilterDescriptor 元素(BDCMetadata 架构)
Parameters 中的 Parameter 元素(BDCMetadata 架构)
TypeDescriptor
TypeDescriptor 元素(BDCMetadata 架构)
MethodInstances 中的 Association 元素(BDCMetadata 架构)
MethodInstances 中的 MethodInstance 元素(BDCMetadata 架构)
AssociationGroups 中的 AssociationGroup 元素(BDCMetadata 架构)
Actions 中的 Action 元素(BDCMetadata 架构)
ActionParameters 中的 ActionParameter 元素(BDCMetadata 架构)

Property 元素

指定元数据对象的属性的名称和类型。

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

架构: BDCMetadata

<Property Name = "String" Type = "String"> </Property>

如下章节中介绍了属性、子元素和父元素。

属性

属性 说明
名称
必需。
指定该属性的名称。
属性类型: String
Type
必需。
指定该属性的数据类型。
属性类型: String

子元素

父元素

元素 说明
MetadataObject 中的 Properties 元素(BDCMetadata 架构)
包含此属性的 Properties 元素。

Proxy 元素

如果此元素不存在,则指定与生成的代理相同的用户提供的代理。 这用于通过消除代理生成开销来提高性能。 若要指定连接到外部系统的自定义业务逻辑,必须使用 .NET 连接程序集类型外部系统。

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

架构: BDCMetadata

<Proxy></Proxy>

如下章节中介绍了属性、子元素和父元素。

属性

子元素

父元素

元素 说明
LobSystems 中的 LobSystem 元素(BDCMetadata 架构)
此代理应用于的 LobSystem 元素。

Right 元素

指定访问控制条目 (ACE) 的单个访问权限。

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

架构: BDCMetadata

<Right BdcRight = "String"> </Right>

如下章节中介绍了属性、子元素和父元素。

属性

属性 说明
BdcRight
必需。
拥有权限的安全主体可用的权限。
下表列出了该属性可能的值。

说明

无权限。

Execute

表示的安全主体具有调用 MethodInstance 的权限。

Edit

表示的安全主体具有更改元数据对象的属性或它与其他元数据对象的关系的权限。

SetPermissions

表示的安全主体具有更改元数据对象的一组权限的权限。

SelectableInClients

表示的安全主体具有选择此权限引用的元数据对象的权限。 如果用户没有此权限,则该元数据对象无法选择。

子元素

父元素

元素 说明
AccessControlList 中的 AccessControlEntry 元素(BDCMetadata 架构)
包含此权限的 AccessControlEntry 元素。

SourceEntity 元素

指定 Association 的源外部内容类型。

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

架构: BDCMetadata

<SourceEntity Namespace = "String" Name = "String"> </SourceEntity>

如下章节中介绍了属性、子元素和父元素。

属性

属性 说明
命名空间
必需。
作为包含此元素的 Association 源的外部内容类型的命名空间。
属性类型:String
名称
必需。
作为包含此元素的 Association 源的外部内容类型的名称。
属性类型: String

子元素

父元素

元素 说明
MethodInstances 中的 Association 元素(BDCMetadata 架构)
包含此元素的 Association

TypeDescriptor 元素

指定 TypeDescriptor

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

架构: BDCMetadata

<TypeDescriptor TypeName = "String" LobName = "String" IdentifierEntityNamespace = "String" IdentifierEntityName = "String" IdentifierName = "String" ForeignIdentifierAssociationName = "String" ForeignIdentifierAssociationEntityName = "String" ForeignIdentifierAssociationEntityNamespace = "String" AssociatedFilter = "String" IsCollection = "Boolean" ReadOnly = "Boolean" CreatorField = "Boolean" UpdaterField = "Boolean" PreUpdaterField = "Boolean" Significant = "Boolean" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </TypeDescriptor>

如下章节中介绍了属性、子元素和父元素。

属性

属性 说明
TypeName
必需。
TypeDescriptor 表示的数据结构的数据类型的标识符。
属性类型: String
LobName
可选。
TypeDescriptor 表示的数据结构。 此属性的默认值是 TypeDescriptor 的名称。 例如,名为"CN1A"的业务线 (LOB) 系统数据结构可以由 Name 属性等于"Customer Name"的 TypeDescriptor 表示(如果此 TypeDescriptorLobName 属性等于"CN1A")。
属性类型: String
IdentifierEntityNamespace
可选。
包含 TypeDescriptor 引用的标识符的外部内容类型的命名空间。 如果 TypeDescriptor 没有引用 Identifier,则此属性肯定不存在。 当此属性存在时, IdentifierEntityNameIdentifierName 属性也必须存在。 此属性的默认值是包含方法(其所含参数包含 TypeDescriptor)的外部内容类型的命名空间。
属性类型: String
IdentifierEntityName
可选。
Entity(包含 TypeDescriptor 引用的 Identifier)的名称。 如果 TypeDescriptor 没有引用 Identifier,则此属性肯定不存在。 当此属性存在时, IdentifierEntityNamespaceIdentifierName 属性也必须存在。 此属性的默认值是包含 Method(其所含 Parameter 包含 TypeDescriptor)的 Entity 的名称。
属性类型: String
IdentifierName
可选。
TypeDescriptor 引用的 Identifier 的名称。 如果 TypeDescriptor 没有引用 Identifier,则此属性肯定不存在。
属性类型: String
ForeignIdentifierAssociationName
可选。
TypeDescriptor 引用的 Association 的名称。 如果 TypeDescriptor 没有引用 Association,则此属性肯定不存在。 当此属性存在时, IdentifierName 属性也必须存在。 当此 TypeDescriptor 引用的 IdentifierAssociation 相关且 Identifier 包含在 Association 的源 Entity 中时,必须指定 ForeignIdentifierAssociationName 属性。
属性类型: String
ForeignIdentifierAssociationEntityName
可选。
Entity(包含 TypeDescriptor 引用的 Association)的名称。 如果 TypeDescriptor 没有引用 Association,则此属性肯定不存在。 当此属性存在时, ForeignIdentifierAssociationEntityNamespaceForeignIdentifierAssociationName 属性也必须存在。 此属性的默认值是包含 Method(其所含 Parameter 包含 TypeDescriptor)的 Entity 的名称。
属性类型: String
ForeignIdentifierAssociationEntityNamespace
可选。
Entity(包含 TypeDescriptor 引用的 Association)的命名空间。 如果 TypeDescriptor 没有引用 Association,则此属性肯定不存在。 当此属性存在时, ForeignIdentifierAssociationEntityNameForeignIdentifierAssociationName 属性也必须存在。 此属性的默认值是包含 Method(其所含 Parameter 包含 TypeDescriptor)的 Entity 的命名空间。
属性类型: String
AssociatedFilter
可选。
TypeDescriptor 关联的 FilterDescriptor 的名称。 如果 TypeDescriptor 没有与 FilterDescriptor 关联,则此属性肯定不存在。
属性类型: String
IsCollection
可选。
指定 TypeDescriptor 是表示单个数据结构还是数据结构集合。
默认值: false
属性类型: Boolean
ReadOnly
可选。
指定是否可以修改由 TypeDescriptor 表示的数据结构所存储的数据。 如果包含 TypeDescriptorParameterDirection 属性值为"In",则无法指定此属性。
默认值: false
属性类型: Boolean
CreatorField
可选。
指定 TypeDescriptor 是否表示类型为 CreatorMethodInstances 的字段,该方法实例包含在 Method(其所含 Parameter 包含 TypeDescriptor)中。
默认值: false
属性类型: Boolean
UpdaterField
可选。
指定 TypeDescriptor 是否表示类型为 UpdaterMethodInstances 的字段,该方法实例包含在 Method(其所含 Parameter 包含 TypeDescriptor)中。 在指定此属性时,不能指定 PreUpdaterField 属性。
默认值: false
属性类型: Boolean
PreUpdaterField
可选。
指定由 TypeDescriptor 表示的数据结构是否存储从外部系统接收的类型为 UpdaterMethodInstances 的字段的最新数据值。 在指定此属性时,不能指定 UpdaterField 属性。
默认值: false
属性类型: Boolean
Significant
可选。
指定在计算哈希代码或比较存储在数据结构中的值时是否包括此 TypeDescriptor 表示的数据结构存储的值。 例如,在确定记录是否已修改时,会考虑表示客户姓氏的 TypeDescriptor ,因此它很重要,而表示上次修改客户记录的日期的 TypeDescriptor 通常不考虑在内,以确定记录是否已修改,因此并不重要。
默认值: true
属性类型: Boolean
名称
必需。
TypeDescriptor 的名称。
属性类型: String
注意:TypeDescriptor 名称不得包含正斜杠(“/”)、句点(“.”)或左方括号(“[”)特殊字符。
DefaultDisplayName
可选。
TypeDescriptor 的显示名称。
属性类型: String
IsCached
可选。
指定是否频繁使用 TypeDescriptor
默认值: true
属性类型: Boolean

子元素

Element 说明
MetadataObject 中的 LocalizedDisplayNames 元素(BDCMetadata 架构)
TypeDescriptor 的本地化名称。
MetadataObject 中的 Properties 元素(BDCMetadata 架构)
TypeDescriptor 的属性。
TypeDescriptor 的类型是 System.String 时, Properties 元素可以包含类型为 System.Int32Property,其 Name 属性设置为 SizeProperty 的值指定由此 TypeDescriptor 描述的数据结构的值的最大预期字符串长度。
TypeDescriptor 中的 Interpretation 元素(BDCMetadata 架构)
针对 TypeDescriptor 表示的数据结构所存储的数据的规则
TypeDescriptor 中的 DefaultValues 元素(BDCMetadata 架构)
TypeDescriptor 的默认值。
TypeDescriptor 中的 TypeDescriptors 元素(BDCMetadata 架构)
TypeDescriptor 的子 TypeDescriptors

父元素

元素 说明
TypeDescriptor 中的 TypeDescriptors 元素(BDCMetadata 架构)

TypeDescriptors 元素

指定父 TypeDescriptor 的 TypeDescriptors 列表。

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

架构: BDCMetadata

<TypeDescriptors></TypeDescriptors>

如下章节中介绍了属性、子元素和父元素。

属性

子元素

Element 说明
TypeDescriptor 元素(BDCMetadata 架构)
一个 TypeDescriptor

父元素

元素 说明
TypeDescriptor 元素(BDCMetadata 架构)
TypeDescriptor

另请参阅