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