Operación GetItem (mensaje de correo electrónico)
La operación GetItem permite al usuario acceder a información sobre los mensajes de correo electrónico.
Uso de la operación GetItem para mensajes
La solicitud GetItem debe tener la siguiente información:
Elemento ItemId para identificar la información de elemento que se va a devolver.
Elemento ItemShape para identificar las propiedades de elemento que se van a devolver.
Ejemplo de solicitud GetItem
Descripción
En el ejemplo siguiente de una solicitud GetItem se muestra cómo acceder a información sobre los mensajes de correo electrónico.
Código
<?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">
<soap:Body>
<GetItem
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<ItemShape>
<t:BaseShape>Default</t:BaseShape>
<t:IncludeMimeContent>true</t:IncludeMimeContent>
</ItemShape>
<ItemIds>
<t:ItemId Id="AAAlAF" ChangeKey="CQAAAB" />
</ItemIds>
</GetItem>
</soap:Body>
</soap:Envelope>
Elementos Request
En la solicitud se usan los siguientes elementos:
Ejemplo de respuesta correcta de GetItem (mensaje de correo electrónico)
Descripción
En el ejemplo siguiente se muestra una respuesta correcta a la solicitud GetItem.
Código
<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:soap="http://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="685" MinorBuildNumber="8"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<GetItemResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseMessages>
<m:GetItemResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:Items>
<t:Message>
<t:MimeContent CharacterSet="UTF-8">UmVjZWl</t:MimeContent>
<t:ItemId Id="AAAlAFVz" ChangeKey="CQAAAB" />
<t:Subject />
<t:Sensitivity>Normal</t:Sensitivity>
<t:Body BodyType="HTML">
<html dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta content="MSHTML 6.00.3790.2759" name="GENERATOR">
<style title="owaParaStyle">P { MARGIN-TOP: 0px; MARGIN-BOTTOM: 0px } </style>
</head>
<body ocsi="x">
<div dir="ltr">
<font face="Tahoma" color="#000000" size="2"></font>&nbsp;
</div>
</body>
</html>
</t:Body>
<t:Size>881</t:Size>
<t:DateTimeSent>2006-10-28T01:37:06Z</t:DateTimeSent>
<t:DateTimeCreated>2006-10-28T01:37:06Z</t:DateTimeCreated>
<t:ResponseObjects>
<t:ReplyToItem />
<t:ReplyAllToItem />
<t:ForwardItem />
</t:ResponseObjects>
<t:HasAttachments>false</t:HasAttachments>
<t:ToRecipients>
<t:Mailbox>
<t:Name>User1</t:Name>
<t:EmailAddress>User1@example.com</t:EmailAddress>
<t:RoutingType>SMTP</t:RoutingType>
</t:Mailbox>
</t:ToRecipients>
<t:IsReadReceiptRequested>false</t:IsReadReceiptRequested>
<t:IsDeliveryReceiptRequested>false</t:IsDeliveryReceiptRequested>
<t:From>
<t:Mailbox>
<t:Name>User2</t:Name>
<t:EmailAddress>User2@example.com</t:EmailAddress>
<t:RoutingType>SMTP</t:RoutingType>
</t:Mailbox>
</t:From>
<t:IsRead>false</t:IsRead>
</t:Message>
</m:Items>
</m:GetItemResponseMessage>
</m:ResponseMessages>
</GetItemResponse>
</soap:Body>
</soap:Envelope>
Comentarios
Los identificadores de contenido, carpeta y elemento MIME se han acortado para conservar la legibilidad.
Elementos de respuesta correctos
Los siguientes elementos se usan en la respuesta:
Ejemplo de respuesta de error de GetItem (mensaje de correo electrónico)
Descripción
En el ejemplo siguiente se muestra una respuesta de error a una solicitud GetItem. El error se produjo por un intento de obtener una propiedad adicional no válida.
Código
<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:soap="http://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="685" MinorBuildNumber="8"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<GetItemResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseMessages>
<m:GetItemResponseMessage ResponseClass="Error">
<m:MessageText>Property is not valid for this object type.</m:MessageText>
<m:ResponseCode>ErrorInvalidPropertyRequest</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
<m:MessageXml>
<t:FieldURI FieldURI="meeting:AssociatedCalendarItemId" />
</m:MessageXml>
<m:Items />
</m:GetItemResponseMessage>
</m:ResponseMessages>
</GetItemResponse>
</soap:Body>
</soap:Envelope>
Elementos de respuesta de error
Los siguientes elementos se usan en la respuesta de error: