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