Home Library Learn Downloads Support Community
Sign in | United States - English | |
1 out of 1 rated this helpful - Rate this topic

Web Service Response Shapes

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.

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

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

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.

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.
Did you find this helpful?
(1500 characters remaining)