Operación GetConversationItems
Busque información sobre la operación GetConversationItems .
La operación GetConversationItems obtiene uno o varios conjuntos de elementos organizados en los nodos de una conversación.
Esta operación se introdujo en Exchange Server 2013.
Uso de la operación GetConversationItems
Puede usar la operación GetConversationItems para obtener elementos en las conversaciones para los buzones de correo principal y de archivo.
Encabezados SOAP de la operación GetConversationItems
La operación GetConversationItems puede usar los encabezados SOAP que aparecen en la tabla siguiente.
| Nombre de encabezado | Elemento | Descripción |
|---|---|---|
| Suplantación |
ExchangeImpersonation |
Identifica al usuario al que suplanta la aplicación cliente. Este encabezado es aplicable a una solicitud. |
| RequestVersion |
RequestServerVersion |
Identifica la versión del esquema de la solicitud de operación. El valor mínimo para este elemento es Exchange2013. Este encabezado es aplicable a una solicitud. |
| ServerVersion |
ServerVersionInfo |
Identifica la versión del servidor que respondió a la solicitud. Este encabezado se aplica a una respuesta. |
Ejemplo de solicitud de operación GetConversationItems: Obtener elementos en una sola conversación
En el ejemplo siguiente de una solicitud de operación GetConversationItems se muestra cómo obtener todos los elementos de conversación en una sola conversación, con la excepción de los elementos ubicados en las carpetas Elementos eliminados y Borradores. Cada elemento devuelto en la respuesta contendrá un identificador de elemento, un asunto y la hora en que se recibió el elemento en el buzón.
Nota:
Todos los identificadores de elemento y las claves de cambio de este artículo se han acortado para conservar la legibilidad.
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
<t:RequestServerVersion Version="Exchange2013" />
</soap:Header>
<soap:Body>
<m:GetConversationItems>
<m:ItemShape>
<t:BaseShape>IdOnly</t:BaseShape>
<t:AdditionalProperties>
<t:FieldURI FieldURI="item:Subject" />
<t:FieldURI FieldURI="item:DateTimeReceived" />
</t:AdditionalProperties>
</m:ItemShape>
<m:FoldersToIgnore>
<t:DistinguishedFolderId Id="deleteditems" />
<t:DistinguishedFolderId Id="drafts" />
</m:FoldersToIgnore>
<m:SortOrder>TreeOrderDescending</m:SortOrder>
<m:Conversations>
<t:Conversation>
<t:ConversationId Id="AAQkADEzOTExYjJkakJCs=" />
</t:Conversation>
</m:Conversations>
</m:GetConversationItems>
</soap:Body>
</soap:Envelope>
En este ejemplo de una solicitud GetConversationItems no se incluyen las siguientes opciones:
El elemento MaxItemsToReturn , que establece el número máximo de elementos que se devolverán en la respuesta.
El elemento MailboxScope , que establece el ámbito del buzón indicando si la operación GetConversationItems se va a realizar en el buzón principal, el buzón de archivo o ambos buzones.
Elemento SyncState (base64Binary), que establece el estado de sincronización para obtener solo elementos de conversación nuevos o actualizados en la conversación. Este elemento se establece para cada conversación.
El cuerpo SOAP de la solicitud contiene los siguientes elementos:
Respuesta correcta de la operación GetConversationItems
En el ejemplo siguiente se muestra una respuesta correcta a una solicitud de operación GetConversationItems para obtener elementos en una sola conversación.
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="15"
MinorVersion="0"
MajorBuildNumber="545"
MinorBuildNumber="11"
Version="Exchange2013"
xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" />
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<m:GetConversationItemsResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<m:ResponseMessages>
<m:GetConversationItemsResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Conversation>
<t:ConversationId Id="AAQkADEzOTExYjJkakJCs=" />
<t:SyncState>AQIAAABNVkUwAgIAAABhHqHUAwIAAABNVkUxBAIAAABhHqHfBAIAAABhHqHV</t:SyncState>
<t:ConversationNodes>
<t:ConversationNode>
<t:InternetMessageId>6a4838fa804045e09d40c1a39b9ea916@contoso.com</t:InternetMessageId>
<t:ParentInternetMessageId>15a56698d503438fbdaa18186d5b81b7@contoso.com</t:ParentInternetMessageId>
<t:Items>
<t:Message>
<t:ItemId Id="AAMkADEzOTQrAABhHqHfAAA=" ChangeKey="CQAAABYAAACYAABhPpaq" />
<t:Subject>RE: Daily issue scrub</t:Subject>
<t:DateTimeReceived>2012-10-30T18:42:27Z</t:DateTimeReceived>
</t:Message>
</t:Items>
</t:ConversationNode>
<t:ConversationNode>
<t:InternetMessageId>2695d2b837954d68846b0c30491f5af1@contoso.com</t:InternetMessageId>
<t:ParentInternetMessageId>15a56698d503438fbdaa18186d5b81b7@contoso.com</t:ParentInternetMessageId>
<t:Items>
<t:Message>
<t:ItemId Id="AAMkADEzOTExYjJkLTYxZDAt" ChangeKey="CQAAABQrAABhPpaP" />
<t:Subject>RE: Daily issue scrub</t:Subject>
<t:DateTimeReceived>2012-10-30T17:38:26Z</t:DateTimeReceived>
</t:Message>
</t:Items>
</t:ConversationNode>
<t:ConversationNode>
<t:InternetMessageId>15a56698d503438fbdaa18186d5b81b7@contoso.com</t:InternetMessageId>
<t:ParentInternetMessageId>d3113e59c89c4288ae13100d033f8dbc@contoso.com</t:ParentInternetMessageId>
<t:Items>
<t:Message>
<t:ItemId Id="AAMkADEzOTFNVkUxAAA=" ChangeKey="CQAAABY4QrAABhPvYK" />
<t:Subject>RE: Daily issue scrub</t:Subject>
<t:DateTimeReceived>2012-10-30T17:37:00Z</t:DateTimeReceived>
</t:Message>
</t:Items>
</t:ConversationNode>
<t:ConversationNode>
<t:InternetMessageId>d3113e59c89c4288ae13100d033f8dbc@contoso.com</t:InternetMessageId>
<t:ParentInternetMessageId>189b712056c2430dbce334b40496ad00@contoso.com</t:ParentInternetMessageId>
<t:Items>
<t:Message>
<t:ItemId Id="AAMkm4QrAABhHqHUAAA=" ChangeKey="CQAAABQrAABhPpaN" />
<t:Subject>RE: Daily issue scrub</t:Subject>
<t:DateTimeReceived>2012-10-30T17:37:05Z</t:DateTimeReceived>
</t:Message>
</t:Items>
</t:ConversationNode>
<t:ConversationNode>
<t:InternetMessageId>189b712056c2430dbce334b40496ad00@contoso.com</t:InternetMessageId>
<t:Items>
<t:Message>
<t:ItemId Id="AAMkArAABNVkUwAAA=" ChangeKey="CQAAABm4QrAABhPvYJ" />
<t:Subject>Daily issue scrub</t:Subject>
<t:DateTimeReceived>2012-10-30T17:36:00Z</t:DateTimeReceived>
</t:Message>
</t:Items>
</t:ConversationNode>
</t:ConversationNodes>
</m:Conversation>
</m:GetConversationItemsResponseMessage>
</m:ResponseMessages>
</m:GetConversationItemsResponse>
</s:Body>
</s:Envelope>
Se recomienda guardar SyncState para las solicitudes de operación GetConversationItems posteriores.
El cuerpo soap de respuesta contiene los siguientes elementos:
Respuesta de error de la operación GetConversationItems
En el ejemplo siguiente se muestra una respuesta de error a una solicitud de operación GetConversationItems para obtener elementos en una conversación que ya no existe en el buzón de correo o para la que todos los elementos de conversación se encuentran en carpetas que se omiten.
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="15" MinorVersion="0" MajorBuildNumber="556" MinorBuildNumber="8" Version="Exchange2013" xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types" xmlns="https://schemas.microsoft.com/exchange/services/2006/types" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<m:GetConversationItemsResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<m:ResponseMessages>
<m:GetConversationItemsResponseMessage ResponseClass="Error">
<m:MessageText>The specified object was not found in the store.</m:MessageText>
<m:ResponseCode>ErrorItemNotFound</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
</m:GetConversationItemsResponseMessage>
</m:ResponseMessages>
</m:GetConversationItemsResponse>
</s:Body>
</s:Envelope>
Vea también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de