FindConversation operation
The FindConversation operation enumerates a list of conversations in a folder.
FindConversation request example
Description
The following example of a FindConversation request shows how to form a request to find the first conversation in the Inbox folder.
Code
<?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"
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
<soap:Header>
<t:RequestServerVersion Version="Exchange2010_SP1" />
</soap:Header>
<soap:Body>
<m:FindConversation>
<m:IndexedPageItemView BasePoint="Beginning" MaxEntriesReturned="1" Offset="0"/>
<m:ParentFolderId>
<t:DistinguishedFolderId Id ="inbox"/>
</m:ParentFolderId>
</m:FindConversation>
</soap:Body>
</soap:Envelope>
Request elements
The following elements are used in the request:
Successful FindConversation response example
Description
The following example shows a successful response to a FindConversation request.
Code
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="14"
MinorVersion="1"
MajorBuildNumber="91"
MinorBuildNumber="0"
Version="Exchange2010_SP1"
xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"/>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<FindConversationResponse ResponseClass="Success"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<ResponseCode>NoError</ResponseCode>
<Conversations>
<t:Conversation xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<t:ConversationId Id="AAQkADRlZDhjZDVlLzYtNDcyZi1i32hHpdc="/>
<t:ConversationTopic>Have you heard about EWS?</t:ConversationTopic>
<t:UniqueRecipients>
<t:String>User1First User1Last</t:String>
</t:UniqueRecipients>
<t:GlobalUniqueRecipients>
<t:String>User2First User2Last</t:String>
<t:String>User1First User1Last</t:String>
</t:GlobalUniqueRecipients>
<t:UniqueSenders>
<t:String>User2First User2Last</t:String>
</t:UniqueSenders>
<t:GlobalUniqueSenders>
<t:String>User1First User1Last</t:String>
<t:String>User2First User2Last</t:String>
</t:GlobalUniqueSenders>
<t:LastDeliveryTime>2010-02-09T02:20:49Z</t:LastDeliveryTime>
<t:GlobalLastDeliveryTime>2010-02-09T02:21:01Z</t:GlobalLastDeliveryTime>
<t:HasAttachments>false</t:HasAttachments>
<t:GlobalHasAttachments>false</t:GlobalHasAttachments>
<t:MessageCount>2</t:MessageCount>
<t:GlobalMessageCount>5</t:GlobalMessageCount>
<t:UnreadCount>0</t:UnreadCount>
<t:Size>6474</t:Size>
<t:GlobalSize>14497</t:GlobalSize>
<t:ItemClasses>
<t:ItemClass>IPM.Note</t:ItemClass>
</t:ItemClasses>
<t:GlobalItemClasses>
<t:ItemClass>IPM.Note</t:ItemClass>
</t:GlobalItemClasses>
<t:Importance>Normal</t:Importance>
<t:GlobalImportance>Normal</t:GlobalImportance>
<t:ItemIds>
<t:ItemId Id="AAMkADRlZDhjZDVlLTU3qaTQvcFtnmUZQY2FuFP93qPtAAAADXWyAAA=" ChangeKey="CQAAAA=="/>
<t:ItemId Id="AAMkADRlZDhjZDVFtnmUZQY2vcFtnmUZQY2FuFP93qPtAAAADXWxAAA=" ChangeKey="CQAAAA=="/>
</t:ItemIds>
<t:GlobalItemIds>
<t:ItemId Id="AAMkADRlZDhCQvcFtnmADU5PAACQvcFtnmUZQsdfFPPtAAAADad4AAA=" ChangeKey="CQAAAA=="/>
<t:ItemId Id="AAqaTXQvcFtnmUZQAADU5NAACQvcFmUZQY2FuFP93qPtAAAADXWyAAA=" ChangeKey="CQAAAA=="/>
<t:ItemId Id="AAMkFtnmUZQY2FuFP93qPtAAAADU5vcFtY2FuFP93qPtAAAADad3AAA=" ChangeKey="CQAAAA=="/>
<t:ItemId Id="AAMkLTU3YzQvcFtnmUZQY2FuFP93qPtnmU2FuFP93qPtAAAADXWxAAA=" ChangeKey="CQAAAA=="/>
<t:ItemId Id="AAMkADlLTU3YzYtNDAAAAAB1aGnYmUZQY2FPAmUZQY2FuqPtAAd2AAA=" ChangeKey="CQAAAA=="/>
</t:GlobalItemIds>
</t:Conversation>
</Conversations>
</FindConversationResponse>
</s:Body>
</s:Envelope>
Comment
The item and conversation identifiers in the example have been shortened to preserve readability.
Successful response elements
The following elements are used in the response:
FindConversation Error response example
Description
The following example shows an error response to the FindConversation request that was caused by a schema validation error.
Code
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<s:Fault>
<faultcode xmlns:a="http://schemas.microsoft.com/exchange/services/2006/types">a:ErrorSchemaValidation</faultcode>
<faultstring xml:lang="en-US">The request failed schema validation: The 'Id' attribute is invalid - The value 'inbox1' is invalid according to its datatype 'http://schemas.microsoft.com/exchange/services/2006/types:DistinguishedFolderIdNameType' - The Enumeration constraint failed.</faultstring>
<detail>
<e:ResponseCode xmlns:e="http://schemas.microsoft.com/exchange/services/2006/errors">ErrorSchemaValidation</e:ResponseCode>
<e:Message xmlns:e="http://schemas.microsoft.com/exchange/services/2006/errors">The request failed schema validation.</e:Message>
<t:MessageXml xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<t:LineNumber>14</t:LineNumber>
<t:LinePosition>34</t:LinePosition>
<t:Violation>The 'Id' attribute is invalid - The value 'inbox1' is invalid according to its datatype 'http://schemas.microsoft.com/exchange/services/2006/types:DistinguishedFolderIdNameType' - The Enumeration constraint failed.</t:Violation>
</t:MessageXml>
</detail>
</s:Fault>
</s:Body>
</s:Envelope>
Error response elements
The following elements are used in the error response:
faultcode
faultstring
detail
Message
LineNumber
LinePosition
Violation