Opération GetAttachment

  • Article

L’opération GetAttachment est utilisée pour récupérer des pièces jointes existantes sur des éléments dans le magasin Exchange.

Exemple de requête GetAttachment

Description

L’exemple suivant de demande GetAttachment montre comment obtenir une pièce jointe.

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="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>

Comments

L’élément AttachmentShape vous permet de spécifier les informations de pièce jointe à retourner. Un élément AttachmentShape vide est valide et affiche vos pièces jointes sans contenu MIME pour les pièces jointes d’élément, avec un type de corps de texte et sans propriétés supplémentaires.

La collection AttachmentIds vous permet de spécifier un ou plusieurs identificateurs de pièce jointe à retourner. Notez qu’il s’agit de type RequestAttachmentIdType. Par conséquent, tous les AttachmentIds que vous recevez de CreateAttachment doivent avoir les attributs RootItemId et RootItemChangeKey supprimés avant de les passer à GetAttachment.

Remarque

L’identificateur de pièce jointe et la clé de modification ont été raccourcis pour préserver la lisibilité.

Éléments de requête

Les éléments suivants sont utilisés dans la demande :

Exemple de réponse GetAttachment

Description

L’exemple suivant montre une réponse réussie à une demande GetAttachment. Cet exemple retourne une pièce jointe.

Code

<?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>

Comments

Les messages de réponse pour GetAttachment contiennent toujours la pièce jointe complète ; autrement dit, toutes les propriétés seront toujours incluses. Pour les pièces jointes, ces propriétés sont Name (AttachmentType),ContentType, ContentId, ContentLocation et Content. Pour les pièces jointes d’élément, ces propriétés sont Name (AttachmentType),ContentType, ContentId, ContentLocation et toutes les propriétés de l’élément, comme si la forme AllProperties avait été utilisée dans un appel GetItem. L’élément AttachmentShape, s’il est présent, permet à une application consommateur de demander des propriétés étendues supplémentaires pour les pièces jointes d’éléments.

Éléments de réponse réussis

Les éléments suivants sont utilisés dans la réponse :

Voir aussi

Opération CreateAttachment

Opération DeleteAttachment