Compartilhar via

Operação SendItem

  • Artigo

A operação SendItem é usada para enviar mensagens de email localizadas no repositório exchange.

Exemplo de solicitação sendItem (mensagem de email)

Descrição

O exemplo a seguir mostra como enviar uma mensagem de email.

Código

<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

O identificador de item foi encurtado para preservar a legibilidade.

Elementos de solicitação

Os seguintes elementos são usados na solicitação:

Resposta de SendItem bem-sucedida (mensagem de email)

Descrição

O exemplo a seguir mostra uma resposta sendItem bem-sucedida.

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

Elementos de resposta bem-sucedidos

Os seguintes elementos são usados na resposta:

Comments

Um delegado que tenta enviar uma mensagem de email localizada na pasta Rascunhos da entidade com a opção SendAndSaveCopy definida para salvar uma cópia na pasta diferenciada Itens Enviados não moverá silenciosamente uma cópia do item enviado para a pasta diferenciada Itens Enviados. O item permanecerá na pasta Rascunhos da entidade. A solução alternativa para esse problema é especificar a caixa de correio da entidade de correio no elemento DistinguishedFolderId .

Um cenário adicional a ser considerado é quando um delegado cria uma mensagem de email e a salva na pasta Rascunhos da caixa de correio do delegado. Se o delegado tentar enviar o item e salvar uma cópia para a pasta diferenciada Itens Enviados da entidade, a mensagem será enviada corretamente, a mensagem de rascunho permanecerá na pasta Rascunhos do delegado, a mensagem enviada não será exibida na pasta Itens Enviados do delegado ou da entidade principal e a resposta será um sucesso.

Exemplo de solicitação de SendItem inválido (Mensagem de Email)

Descrição

O exemplo de código a seguir mostra um exemplo de uma solicitação com um identificador inválido.

Código

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

Resposta de erro sendItem (mensagem de email)

Descrição

O exemplo a seguir mostra uma resposta de erro a uma solicitação SendItem que contém um identificador inválido.

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

Elementos de resposta de erro

Os seguintes elementos são usados na resposta de erro:

Confira também

Operação SendItem

Senditemtype