Operación SendItem

  • Artículo

La operación SendItem se usa para enviar mensajes de correo electrónico que se encuentran en el almacén de Exchange.

Ejemplo de solicitud SendItem (mensaje de correo electrónico)

Descripción

En el ejemplo siguiente se muestra cómo enviar un mensaje de correo electrónico.

Código

<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>
    <SendItem xmlns="http://schemas.microsoft.com/exchange/services/2006/messages" 
              SaveItemToFolder="true">
      <ItemIds>
        <t:ItemId Id="AAAtAEF=" ChangeKey="CQAAABY+T" />
      </ItemIds>
    </SendItem>
  </soap:Body>
</soap:Envelope>

Comentarios

El identificador de elemento se ha acortado para conservar la legibilidad.

Elementos Request

En la solicitud se usan los siguientes elementos:

Respuesta correcta de SendItem (mensaje de correo electrónico)

Descripción

En el ejemplo siguiente se muestra una respuesta SendItem correcta.

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="602" MinorBuildNumber="0" 
                         xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <SendItemResponse 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:SendItemResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
        </m:SendItemResponseMessage>
      </m:ResponseMessages>
    </SendItemResponse>
  </soap:Body>
</soap:Envelope>

Elementos de respuesta correctos

Los siguientes elementos se usan en la respuesta:

Comentarios

Un delegado que intenta enviar un mensaje de correo electrónico que se encuentra en la carpeta Borradores de la entidad de seguridad con la opción SendAndSaveCopy establecida para guardar una copia en la carpeta distinguida Elementos enviados no podrá mover silenciosamente una copia del elemento enviado a la carpeta distinguida Elementos enviados. El elemento permanecerá en la carpeta Borradores de la entidad de seguridad. La solución alternativa para este problema es especificar el buzón de la entidad de seguridad en el elemento DistinguishedFolderId .

Un escenario adicional que se debe tener en cuenta es cuando un delegado crea un mensaje de correo electrónico y lo guarda en la carpeta Borradores del buzón del delegado. Si el delegado intenta enviar el elemento y guardar una copia en la carpeta distinguida Elementos enviados de la entidad de seguridad, el mensaje se envía correctamente, el borrador permanece en la carpeta Borradores del delegado, el mensaje enviado no aparece en la carpeta Elementos enviados del delegado o de la entidad de seguridad y la respuesta es correcta.

Ejemplo de solicitud SendItem (mensaje de correo electrónico) no válido

Descripción

En el ejemplo de código siguiente se muestra un ejemplo de una solicitud con un identificador no válido.

Código

<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>
    <SendItem xmlns="http://schemas.microsoft.com/exchange/services/2006/messages" 
              SaveItemToFolder="true">
      <ItemIds>
        <t:ItemId Id="%BadItemId%" ChangeKey="CQAAABYAAA" />
      </ItemIds>
    </SendItem>
  </soap:Body>
</soap:Envelope>

Respuesta de error de SendItem (mensaje de correo electrónico)

Descripción

En el ejemplo siguiente se muestra una respuesta de error a una solicitud SendItem que contiene un identificador no válido.

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="602" MinorBuildNumber="0" 
                         xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <SendItemResponse 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:SendItemResponseMessage ResponseClass="Error">
          <m:MessageText>Id is malformed.</m:MessageText>
          <m:ResponseCode>ErrorInvalidIdMalformed</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
        </m:SendItemResponseMessage>
      </m:ResponseMessages>
    </SendItemResponse>
  </soap:Body>
</soap:Envelope>

Elementos de respuesta de error

Los siguientes elementos se usan en la respuesta de error:

Vea también

Operación SendItem

SendItemType