Web Service Response Shapes in Exchange 2010

Last modified: September 14, 2010

Applies to: Exchange Server 2007 | Exchange Server 2010

The Exchange data store provides a flexible storage solution for a number of items. This flexibility enables you to store different items, such as contacts and calendar entries, in the same folder; however, it can make it difficult to manage the data that is returned from a call to an Exchange Web Service (EWS) operation.

To make it easier to manage the data that is returned by an EWS operation, EWS uses response shapes, which are predefined collections of properties that provide the most common properties for a store item. The set of properties that is returned is determined by the item type and the folder that contains the item. This means that the GetItem Operation will return one set of properties when it returns a Calendar item, and another set of properties when it returns a Contact item. The GetFolder Operation does the same, returning one set of properties for a Calendar folder, and another set of properties for a Contacts folder.

There are three predefined response shapes, as described in the following table.

Response shape	Description
ID only	Returns only the identifier of the item or folder.
Default	Returns a predefined set of properties that are the default for the item or folder.
All properties	Returns all properties that are used by the Exchange server for the item or folder.

Default Response Shape

The default response shape includes default properties for folders and for items.

Default Folder Properties

The following table lists the default properties that are returned for each folder by the FindFolder Operation and the GetFolder Operation.

Property	Inbox	Calendar	Contacts	Deleted items	Drafts	Notes	Other folders	Outbox
Display name	X	X	X	X	X	X	X	X
Folder ID	X	X	X	X	X	X	X	X
Subfolder count	X	X	X	X	X	X	X	X
Total count	X		X	X	X	X	X	X
Unread count	X			X	X		X	X

Default Item Properties

The following table lists the default properties that are returned for each item type by the FindItem Operation and the GetItem Operation.

Property	Calendar item	Contact item	Message item	Task item
Body			X(1)
CalendarItemType		x
CompanyName		x
CompleteName		x
DateTimeCreated			x
DateTimeSent			x
DueDate				x(2)
EmailAddresses		x
End	x
FileAs		x
From			x
HasAttachments	x	x	x	x
ImAddresses		x
IsAssociated	x		x
IsDeliveryReceiptRequested			x
ItemId	x	x	x	x
JobTitle		x
LegacyFreeBusyStatus	x
Location	x
Organizer	x
PercentComplete				x
PhoneNumbers		x
PhysicalAddresses		x
ResponseObjects	x(1)		x(1)
Sensitity			x
Size			x
StartDate				x(2)
Status				x
Subject	x		x	x

Notes:

1. Included in the response from the GetItem Operation. Not included in the response from the FindItem Operation.

2. Only included in the response if the field contains data. Not included in the response if the field is blank.

All Properties Response Shape

The following table lists the properties that are returned by the FindItem Operation and the GetItem Operation for the all properties response shape.

Property	Calendar item	Contact item	Message item	Task item
ActualWork				x
AppointmentSequenceNumber	x
AppointmentState	x
BillingInformation				x
Body	x(1)	x(1)	x(1)	x(1)
BusinessHomePage		x
CalendarItemType	x
ChangeCount				x
CompleteName		x
ConversationId	x	x	x	x
ConversationIndex			x
ConversationTopic			x
Culture	x	x	x	x
DateTimeCreated	x	x	x	x
DateTimeReceived	x	x	x	x
DateTimeSent	x	x	x	x
DateTimeStamp	x
Department		x
DisplayCc	x	x	x	x
DisplayName		x
DisplayTo	x	x	x	x
Duration	x
EffectiveRights	x	x	x	x
EmailAddresses		x
End	x
FileAs		x
FileAsMapping		x
From			x
GivenName		x
HasAttachments	x	x	x	x
ImAddresses		x
Importance	x	x	x	x
InternetMessageId			x
IsAllDayEvent	x
IsAssociated	x	x	x	x
IsCancelled	x
IsComplete				x
IsDeliveryReceiptRequested			x
IsDraft	x	x	x	x
IsFromMe	x	x	x	x
IsMeeting	x
IsRead			x
IsReadReceiptRequested			x
IsRecurring	x			x
IsResend	x	x	x	x
IsResponseRequested	x
IsSubmitted	x	x	x	x
IsUnmodified	x	x	x	x
ItemClass	x	x	x	x
ItemId	x	x	x	x
JobTitle		x
LastModifiedName	x	x	x	x
LastModifiedTime	x	x	x	x
LegacyFreeBusyStatus	x
Location	x
Manager		x
MeetingRequestWasSent	x
MiddleName		x
Mileage				x
MyResponseType	x
OfficeLocation		x
Organizer	x
Owner	x
ParentFolderId	x	x	x	x
PercentComplete				x
PhoneNumbers		x
PhysicalAddresses		x
PostalAddressIndex		x
ReceivedBy			x
ReceivedRepresenting			x
ReminderDueBy	x			x
ReminderIsSet	x			x
ReminderMinutesBeforeStart	x			x
ResponseObjects	x(1)		x(1)
Sender			x
Sensitivity	x		x	x
Size	x	x	x	x
Start	x			x
Status				x
Subject	x	x	x	x
Surname		x
TimeZone	x
TotalWork				x
UID	x
WebClientEditFormQueryString	x	x		x
WebClientReadFormQueryString	x	x	x	x

Notes:

1. Included in the response from the GetItem Operation. Not included in the response from the FindItem Operation.

See Also

Other Resources

FindItem Operation

GetItem Operation

FindFolder Operation

GetFolder Operation