AdditionalProperties
The AdditionalProperties element identifies additional properties for use in GetItem, UpdateItem, CreateItem, FindItem, or FindFolder requests.
<AdditionalProperties>
<ExtendedFieldURI/>
<FieldURI/>
<IndexedFieldURI/>
</AdditionalProperties>
NonEmptyArrayOfPathsToElementType
Attributes and elements
The following sections describe attributes, child elements, and parent elements.
Attributes
None.
Child elements
Element | Description |
---|---|
ExtendedFieldURI |
Identifies extended MAPI properties to get, set, or create. |
FieldURI |
Identifies frequently referenced properties by URI. |
IndexedFieldURI |
Identifies frequently referenced dictionary properties by URI. |
Parent elements
Element | Description |
---|---|
FolderShape |
Identifies the folder properties to include in a GetFolder, FindFolder, or SyncFolderHierarchy response. The following are the XPath expressions to this element: /FindFolder/FolderShape /GetFolder/FolderShape /SyncFolderHierarchy/FolderShape |
ItemShape |
Identifies the item properties and content to include in a GetItem, FindItem, or SyncFolderItems response. The following are the XPath expressions to this element: /GetItem/ItemShape /FindItem/ItemShape /SyncFolderItems/ItemShape |
AttachmentShape |
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 |
Remarks
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.
Example
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>
Element information
Element | Example |
---|---|
Namespace |
http://schemas.microsoft.com/exchange/services/2006/types |
Schema Name |
Types schema |
Validation File |
Types.xsd |
Can be Empty |
False |