UpdateItem (Contact)
Last modified: March 16, 2009
Applies to: Exchange Server 2007 | Exchange Server 2010
In this article
UpdateItem (Contact) Request Example
Successful UpdateItem (Contact) Response
Invalid UpdateItem (Contact) Request Example
UpdateItem (Contact) Error Response
The UpdateItem operation is used to update contact item properties in the Exchange store.
UpdateItem (Contact) Request Example
Description
The following code example shows how to update the e-mail address of a contact.
Code
<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>
<UpdateItem xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
ConflictResolution="AlwaysOverwrite">
<ItemChanges>
<t:ItemChange>
<t:ItemId Id="AAAtAA=" ChangeKey="EQAAABYi" />
<t:Updates>
<t:SetItemField>
<t:IndexedFieldURI FieldURI="contacts:EmailAddress" FieldIndex="EmailAddress1"/>
<t:Contact>
<t:EmailAddresses>
<t:Entry Key="EmailAddress1">changedemail@example.com</t:Entry>
</t:EmailAddresses>
</t:Contact>
</t:SetItemField>
</t:Updates>
</t:ItemChange>
</ItemChanges>
</UpdateItem>
</soap:Body>
</soap:Envelope>
Comments
The item identifier has been shortened to preserve readability.
Request Elements
The following elements are used in the request:
Successful UpdateItem (Contact) Response
Description
The following code example shows a successful UpdateItem response.
Code
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="602" MinorBuildNumber="0"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<UpdateItemResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseMessages>
<m:UpdateItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Items>
<t:Contact>
<t:ItemId Id="AAAtAE=" ChangeKey="EQAAABYx" />
</t:Contact>
</m:Items>
</m:UpdateItemResponseMessage>
</m:ResponseMessages>
</UpdateItemResponse>
</soap:Body>
</soap:Envelope>
Comments
The item identifier has been shortened to preserve readability.
Successful Response Elements
The following elements are used in the response:
Invalid UpdateItem (Contact) Request Example
Description
The following code example shows an invalid request.
Code
<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>
<UpdateItem xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
ConflictResolution="AlwaysOverwrite">
<ItemChanges>
<t:ItemChange>
<t:ItemId Id="AAAtAEF=" ChangeKey="EQAAABYi" />
<t:Updates>
<t:SetItemField>
<t:IndexedFieldURI FieldURI="contacts:EmailAddress" FieldIndex="EmailAddress4"/>
<t:Contact>
<t:EmailAddresses>
<t:Entry Key="EmailAddress4">changedemail2@example.com</t:Entry>
</t:EmailAddresses>
</t:Contact>
</t:SetItemField>
</t:Updates>
</t:ItemChange>
</ItemChanges>
</UpdateItem>
</soap:Body>
</soap:Envelope>
Comments
The item identifier has been shortened to preserve readability.
UpdateItem (Contact) Error Response
Description
The following code example shows an error response to an UpdateItem (Contact) request.
Code
<soap:Envelope xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
<t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="602" MinorBuildNumber="0"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<soap:Fault>
<soap:faultcode>Client</soap:faultcode>
<soap:faultstring>The request failed schema validation.</soap:faultstring>
<detail>
<e:ResponseCode xmlns:e="https://schemas.microsoft.com/exchange/services/2006/errors">ErrorSchemaValidation</e:ResponseCode>
<e:Message xmlns:e="https://schemas.microsoft.com/exchange/services/2006/errors">The 'Key' attribute is invalid - The value 'EmailAddress4' is invalid according to its data type 'https://schemas.microsoft.com/exchange/services/2006/types:EmailAddressKeyType' - The Enumeration constraint failed.</e:Message>
<e:Line xmlns:e="https://schemas.microsoft.com/exchange/services/2006/errors">17</e:Line>
<e:Position xmlns:e="https://schemas.microsoft.com/exchange/services/2006/errors">19</e:Position>
</detail>
</soap:Fault>
</soap:Body>
</soap:Envelope>
Comments
Some elements that are used in the SOAP body of an error response that is caused by a schema validation error are not defined in the messages or types schemas. The detail element contains information about the error. The ResponseCode element contains the error code. The Message element contains an explanation for the error, if one is available. The Line element describes the line number where the schema validation error occurred. The Position element describes the position from the leftmost character of the XML document.