Entity Element in Entities (BDCMetadata Schema)

Applies to: SharePoint Server 2010

Specifies an external content type.

Namespace: https://schemas.microsoft.com/windows/2007/BusinessDataCatalog

Schema: BDCMetadata

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

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute	Description
Namespace	Required. The namespace that this external content type belongs to. Attribute type: String Note The namespace should not contain the special character "*".
Version	Required. The version number of this external content type. Attribute type: String Warning When the BDC model changes, you must increase the version number of the external content type. If the structure of an external content type changes, you should increase the major number. Examples of structural changes include adding a field to a SpecificFinder or changing an identifier field. If the change does not affect the structure of the external content type, for example, when adding a creator method, changing connection information, or when changing names of LobSystems and type descriptors, you should change the build number and revision number.
EstimatedInstanceCount	Optional. The estimated number of external items contained by the external system. Default value: 10000 Attribute type: Integer
DefaultOperationMode	Optional. Specifies the default behavior when interacting with the external system while creating, deleting, updating, or reading external items. Default value: Default The following table lists the possible values for this attribute. Value Description Online Bypass the cached external items for all operations and interact with the external system directly. Cached Perform Create, Read, Update, and Delete operations directly against the cached external items. For Read operations, if the requested external items are available in the cache, use the external items in the cache. Otherwise, bypass the cache to obtain the external items from the external system, and put it in the cache for later use. Offline Perform Create, Read, Update, and Delete operations against only the cached external items. Default Use the System default behavior. This uses Cached mode if the environment supports caching external items.
Name	Required. The name of the external content type. Attribute type: String Note The name of an external content type should not contain the asterisk special character "*".
DefaultDisplayName	Optional. The default display name of the external content type. Attribute type: String
IsCached	Optional. Specifies whether this external content type will be frequently used. If set to true, Business Data Connectivity (BDC) service will cache this external content type in memory. Default value: true Attribute type: Boolean

Child Elements

Element	Description
LocalizedDisplayNames Element in MetadataObject (BDCMetadata Schema)	The localized display names of this external content type.
Properties Element in MetadataObject (BDCMetadata Schema)	The properties of this external content type.
AccessControlList Element (BDCMetadata Schema)	The access control list (ACL) of this external content type.
Identifiers Element in Entity (BDCMetadata Schema)	The identifiers of the external content type.
Methods Element in Entity (BDCMetadata Schema)	The methods of the external content type.
AssociationGroups Element in Entity (BDCMetadata Schema)	The association groups of the external content type.
Actions Element in Entity (BDCMetadata Schema)	The actions of the external content type.

Parent Elements

Element	Description
Entities Element in LobSystem (BDCMetadata Schema)	The list of external content types in this external system.

See Also

Concepts

What Are External Content Types?