AdditionalProperties
Last modified: October 13, 2012
Applies to: Exchange Online | Exchange Server 2007 | Exchange Server 2010 | Exchange Server 2013 | Office 365
The AdditionalProperties element identifies additional properties for use in GetItem, UpdateItem, CreateItem, FindItem, or FindFolder requests.
<AdditionalProperties> <ExtendedFieldURI/> <FieldURI/> <IndexedFieldURI/> </AdditionalProperties>
NonEmptyArrayOfPathsToElementType
The following sections describe attributes, child elements, and parent elements.
Attributes
None.
Child elements
|
Element |
Description |
|---|---|
|
Identifies extended MAPI properties to get, set, or create. |
|
|
Identifies frequently referenced properties by URI. |
|
|
Identifies frequently referenced dictionary properties by URI. |
Parent elements
|
Element |
Description |
|---|---|
|
Identifies the folder properties to include in a 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:
|
|
|
Identifies additional extended item properties to return in a response to a GetItem request. The following is the XPath expression to this element: /GetAttachment/AttachmentShape |
Not all the child elements can be used with GetItem, UpdateItem, CreateItem, FindItem, or FindFolder requests. The property must be applicable to the folder or item that is accessed. Use extended properties to access other properties. If the property does not exist for a given item, no corresponding element will be emitted into the resulting XML.
The schema that describes this element is located in the EWS virtual directory of the computer that is running MicrosoftExchange Server 2007 that has the Client Access server role installed.
This element is optional.
The following request example shows how to get an item subject by using the AdditionalProperties element.
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<GetItem xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<ItemShape>
<t:BaseShape>IdOnly</t:BaseShape>
<t:AdditionalProperties>
<t:FieldURI FieldURI="item:Subject"/>
</t:AdditionalProperties>
</ItemShape>
<ItemIds>
<t:ItemId Id="ASkAS="/>
</ItemIds>
</GetItem>
</soap:Body>
</soap:Envelope>