Поделиться через

Операция SendItem

  • Статья

Операция SendItem используется для отправки сообщений электронной почты, находящихся в хранилище Exchange.

Пример запроса SendItem (сообщение электронной почты)

Описание

В следующем примере показано, как отправить сообщение электронной почты.

Код

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

Comments

Идентификатор элемента сокращен для сохранения удобочитаемости.

Элементы запроса

В запросе используются следующие элементы:

Успешный ответ SendItem (сообщение электронной почты)

Описание

В следующем примере показан успешный ответ SendItem.

Код

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

Элементы успешного отклика

В ответе используются следующие элементы:

Comments

Делегат, который пытается отправить сообщение электронной почты, которое находится в папке Черновики субъекта с параметром SendAndSaveCopy, установленным для сохранения копии в различающейся папке Отправленные элементы, автоматически не сможет переместить копию отправленного элемента в различающуюся папку Отправленные. Элемент останется в папке Черновики субъекта. Решение этой проблемы заключается в указании почтового ящика субъекта в элементе DistinguishedFolderId .

Дополнительный сценарий, который следует учитывать, — когда делегат создает сообщение электронной почты и сохраняет его в папке Черновики почтового ящика делегата. Если делегат пытается отправить элемент и сохранить копию в различающейся папке отправленных элементов субъекта, сообщение отправляется правильно, черновик сообщения остается в папке "Черновики" делегата, отправленное сообщение не отображается ни в папке отправленных элементов делегата, ни в папке "Отправленные", а ответ успешно выполнен.

Пример запроса Invalid SendItem (e-mail Message)

Описание

В следующем примере кода показан пример запроса с недопустимым идентификатором.

Код

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

Ответ об ошибке SendItem (сообщение электронной почты)

Описание

В следующем примере показан ответ на ошибку на запрос SendItem, содержащий недопустимый идентификатор.

Код

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

Элементы ответа на ошибку

В ответе на ошибку используются следующие элементы:

См. также

SendItem Operation

SendItemType