BaseShape
Last modified: March 16, 2009
Applies to: Exchange Server 2007 | Exchange Server 2010
The BaseShape element identifies the set of properties to return in an item or folder response.
<BaseShape>IdOnly or Default or AllProperties</BaseShape>
DefaultShapeNamesType
Attributes and Elements
The following sections describe attributes, child elements, and parent elements.
Attributes
None.
Child Elements
None
Parent Elements
Element |
Description |
|---|---|
Identifies the folder properties to include in the GetFolder, FindFolder, or SyncFolderHierarchy response. The following are the XPath expressions to this element:
|
|
Identifies the item properties and content to include in a GetItem, FindItem, or SyncFolderItems response. The following are the XPath expressions to this element:
|
Text Value
A text value is required. The following table lists the possible text values.
Text values for the BaseShape element
Value |
Description |
|---|---|
IdOnly |
Returns only the item or folder ID. |
Default |
Returns a set of properties that are defined as the default for the item or folder. |
AllProperties |
Returns all the properties used by the Exchange Business Logic layer to construct a folder. |
The following table lists the default properties that are returned for a FindFolder request. All subfolders of a given folder are returned in order by name.
Default properties
Folder |
Default Properties |
|---|---|
Inbox |
FolderId, display name, unread count, total count, subfolder count |
Contacts |
FolderId, display name, total count, subfolder count |
Calendar |
FolderId, display name, subfolder count |
Drafts |
FolderId, display name, unread count, total count, subfolder count |
Deleted items |
FolderId, display name, unread count, total count, subfolder count |
Other folders |
FolderId, display name, unread count, total count, subfolder count |
Outbox |
FolderId, display name, unread count, total count, subfolder count |
Tasks |
FolderId, display name, past due count, total count, subfolder count |
Notes |
FolderId, display name, total count, subfolder count |
Remarks
To return properties in addition to those identified by the BaseShape element, use the AdditionalProperties element.
Example
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<FindFolder Traversal="Shallow" xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
<FolderShape>
<t:BaseShape>Default</t:BaseShape>
</FolderShape>
<ParentFolderIds>
<t:DistinguishedFolderId Id="inbox"/>
</ParentFolderIds>
</FindFolder>
</soap:Body>
</soap:Envelope>
Element Information
Namespace |
https://schemas.microsoft.com/exchange/services/2006/types |
Schema Name |
Types schema |
Validation File |
Types.xsd |
Can be Empty |
False |