Opération SendItemSendItem operation

L’opération SendItem est utilisée pour envoyer des messages électroniques situés dans la Banque d’Exchange.The SendItem operation is used to send e-mail messages that are located in the Exchange store.

Exemple de requête SendItem (message électronique)SendItem (E-mail Message) request example

DescriptionDescription

L’exemple suivant montre comment envoyer un message électronique.The following example shows how to send an e-mail message.

CodeCode

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

CommentairesComments

Identificateur de l'élément a été raccourcie afin de préserver la lisibilité.The item identifier has been shortened to preserve readability.

Demander des élémentsRequest elements

Les éléments suivants sont utilisés dans la demande :The following elements are used in the request:

Réponse SendItem (message électronique)Successful SendItem (E-mail Message) Response

DescriptionDescription

L’exemple suivant montre une réponse SendItem réussie.The following example shows a successful SendItem response.

CodeCode

<?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éussisSuccessful response elements

Les éléments suivants sont utilisés dans la réponse :The following elements are used in the response:

CommentairesComments

Un délégué qui tente d’envoyer un message électronique qui se trouve dans le dossier Brouillons de l’entité avec l’option Méthodesendandsavecopy définie sur enregistrer une copie dans le dossier unique éléments envoyés ne parviendra pas à déplacer une copie de l’élément envoyé vers le dossier unique éléments envoyés.A delegate who tries to send an e-mail message that is located in the principal's Drafts folder with the SendAndSaveCopy option set to save a copy in the Sent Items distinguished folder will silently fail to move a copy of the sent item to the Sent Items distinguished folder. L’élément reste dans le dossier Brouillons de l’entité de sécurité.The item will remain in the principal's Drafts folder. Pour contourner ce problème, spécifiez la boîte aux lettres de l’entité dans l’élément DistinguishedFolderId .The workaround for this issue is to specify the principal's mailbox in the DistinguishedFolderId element.

Un autre scénario à prendre en considération est lorsqu’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é.An additional scenario to consider is when a delegate creates an e-mail message and saves it to the Drafts folder of the delegate's mailbox. Si le délégué tente d’envoyer l’élément et d’enregistrer une copie dans le dossier unique éléments envoyés du principal, le message est envoyé correctement, le brouillon du 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 une réussite.If the delegate tries to send the item and save a copy to the principal's Sent Items distinguished folder, the message is sent correctly, the draft message remains in the delegate's Drafts folder, the sent message does not appear in either the delegate's or principal's Sent Items folder, and the response is a success.

Exemple de requête SendItem (message électronique) non valideInvalid SendItem (E-mail Message) request example

DescriptionDescription

L’exemple de code suivant montre un exemple de requête avec un identificateur non valide.The following code sample shows an example of a request with an invalid identifier.

CodeCode

<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)SendItem (E-mail Message) error response

DescriptionDescription

L’exemple suivant montre une réponse d’erreur à une requête SendItem qui contient un identificateur non valide.The following example shows an error response to a SendItem request that contains an invalid identifier.

CodeCode

<?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’erreurError response elements

Les éléments suivants sont utilisés dans la réponse d'erreur :The following elements are used in the error response:

Voir aussiSee also

Opération SendItemSendItem operation

SendItemTypeSendItemType