Operación GetAttachment

  • Artículo

La operación GetAttachment se usa para recuperar los datos adjuntos existentes en los elementos del almacén de Exchange.

Ejemplo de solicitud GetAttachment

Descripción

En el ejemplo siguiente de la solicitud GetAttachment se muestra cómo obtener datos adjuntos.

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="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <GetAttachment xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
    xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
      <AttachmentShape/>
      <AttachmentIds>
        <t:AttachmentId Id="AAAtAEFkbWluaX..."/>
      </AttachmentIds>
    </GetAttachment>
  </soap:Body>
</soap:Envelope>

Comentarios

El elemento AttachmentShape permite especificar qué información de datos adjuntos se debe devolver. Un elemento AttachmentShape vacío es válido y representará los datos adjuntos sin contenido MIME para los datos adjuntos de elementos, con un tipo de cuerpo de texto y sin ninguna propiedad adicional.

La colección AttachmentIds permite especificar uno o varios identificadores de datos adjuntos que se van a devolver. Tenga en cuenta que son de tipo RequestAttachmentIdType, por lo que cualquier AttachmentIds que reciba de CreateAttachment debe quitar los atributos RootItemId y RootItemChangeKey antes de pasarlos a GetAttachment.

Nota:

El identificador de datos adjuntos y la clave de cambio se han acortado para conservar la legibilidad.

Elementos Request

En la solicitud se usan los siguientes elementos:

Ejemplo de respuesta de GetAttachment

Descripción

En el ejemplo siguiente se muestra una respuesta correcta a una solicitud GetAttachment. En este ejemplo se devuelve un archivo adjunto.

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="662" MinorBuildNumber="0" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"/>
  </soap:Header>
  <soap:Body>
    <GetAttachmentResponse 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:GetAttachmentResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:Attachments>
            <t:FileAttachment>
              <t:AttachmentId Id="AAAtAEFkbWluaX..."/>
              <t:Name>SomeFile</t:Name>
              <t:Content>AQIDBAU=</t:Content>
            </t:FileAttachment>
          </m:Attachments>
        </m:GetAttachmentResponseMessage>
      </m:ResponseMessages>
    </GetAttachmentResponse>
  </soap:Body>
</soap:Envelope>

Comentarios

Los mensajes de respuesta para GetAttachment siempre contendrán los datos adjuntos completos; es decir, todas las propiedades siempre se incluirán. Para los datos adjuntos de archivos, esas propiedades son Name (AttachmentType), ContentType, ContentId, ContentLocation y Content. Para los datos adjuntos de elementos, esas propiedades son Name (AttachmentType), ContentType, ContentId, ContentLocation y todas las propiedades del elemento, como si la forma AllProperties se hubiera usado en una llamada a GetItem. El elemento AttachmentShape , si está presente, permitirá a una aplicación de consumidor solicitar propiedades extendidas adicionales para los datos adjuntos de elementos.

Elementos de respuesta correctos

Los siguientes elementos se usan en la respuesta:

Vea también

Operación CreateAttachment

Operación DeleteAttachment