AdditionalProperties

Topic Last Modified: 2008-09-08

The AdditionalProperties element identifies additional properties for use in GetItem, UpdateItem, CreateItem, FindItem, or FindFolder requests.

Syntax

<AdditionalProperties>
   <ExtendedFieldURI/>
   <FieldURI/>
   <IndexedFieldURI/>
</AdditionalProperties>

Type

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 Microsoft Exchange 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="https://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <GetItem xmlns="https://schemas.microsoft.com/exchange/services/2006/messages" 
                  xmlns:t="https://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

Namespace	https://schemas.microsoft.com/exchange/services/2006/types
Schema Name	Types schema
Validation File	Types.xsd
Can be Empty	False