Opération SendItem

  • Article

L’opération SendItem est utilisée pour envoyer des messages électroniques situés dans le magasin Exchange.

Exemple de requête SendItem (message électronique)

Description

L’exemple suivant montre comment envoyer un message électronique.

Code

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

Comments

Identificateur de l'élément a été raccourcie afin de préserver la lisibilité.

Éléments de requête

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

Réponse SendItem (message électronique) réussie

Description

L’exemple suivant montre une réponse SendItem réussie.

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

Éléments de réponse réussis

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

Comments

Un délégué qui tente d’envoyer un message électronique qui se trouve dans le dossier Brouillons du principal avec l’option SendAndSaveCopy définie pour enregistrer une copie dans le dossier unique Éléments envoyés ne parvient pas à déplacer en mode silencieux une copie de l’élément envoyé vers le dossier unique Éléments envoyés. L’élément reste dans le dossier Brouillons du principal. La solution de contournement pour ce problème consiste à spécifier la boîte aux lettres du principal dans l’élément DistinguishedFolderId .

Un autre scénario à prendre en compte est le cas où un délégué crée un message électronique et l’enregistre dans le dossier Brouillons de la boîte aux lettres du délégué. Si le délégué tente d’envoyer l’élément et d’enregistrer une copie dans le dossier Éléments envoyés du principal, le message est envoyé correctement, le brouillon de message reste dans le dossier Brouillons du délégué, le message envoyé n’apparaît pas dans le dossier Éléments envoyés du délégué ou du principal, et la réponse est un succès.

Exemple de requête SendItem (message électronique) non valide

Description

L’exemple de code suivant montre un exemple de requête avec un identificateur non valide.

Code

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

Réponse d’erreur SendItem (message électronique)

Description

L’exemple suivant montre une réponse d’erreur à une requête SendItem qui contient un identificateur non valide.

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="602" MinorBuildNumber="0" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <SendItemResponse 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: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>

Éléments de réponse d’erreur

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

Voir aussi

Opération SendItem

SendItemType