Compartilhar via

Operação GetUserOofSettings

  • Artigo

A operação GetUserOofSettings obtém as configurações e as mensagens de OOF (usuário de caixa de correio).

Cabeçalhos SOAP

A operação GetUserOofSettings pode usar os cabeçalhos SOAP listados e descritos na tabela a seguir.

Header Elemento Descrição
Representação
 ExchangeImpersonation
Identifica o usuário que o aplicativo cliente está representando.
Serverversion
 ServerVersionInfo
Identifica a versão do servidor que respondeu à solicitação.

Usando a operação GetUserOofSettings

A operação GetUserOofSettings fornece acesso às configurações do OOF de um usuário. Um usuário é identificado pelo endereço de email do usuário. Se a mensagem OOF for nula e o OOF estiver habilitado, nenhuma mensagem OOF será enviada.

Importante

Se as mensagens OOF forem definidas pelo MicrosoftOfficeOutlook, essa operação retornará as mensagens OOF no formato HTML.

Exemplo de solicitação GetUserOofSettings

Descrição

O exemplo a seguir mostra uma solicitação GetUserOofSettings que obtém informações de OOF de um único usuário.

Código

<?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/">
  <soap:Body>
    <GetUserOofSettingsRequest xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <Mailbox xmlns ="http://schemas.microsoft.com/exchange/services/2006/types">
        <Address>User1@example.com</Address>
      </Mailbox>
    </GetUserOofSettingsRequest>
  </soap:Body>
</soap:Envelope>

Elementos de solicitação

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

Exemplo de resposta GetUserOofSettings bem-sucedido

Descrição

O exemplo a seguir mostra um estado OOF desabilitado com as mensagens OOF.

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="685" MinorBuildNumber="8" 
                         xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <GetUserOofSettingsResponse xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseMessage ResponseClass="Success">
        <ResponseCode>NoError</ResponseCode>
      </ResponseMessage>
      <OofSettings xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
        <OofState>Disabled</OofState>
        <ExternalAudience>All</ExternalAudience>
        <Duration>
          <StartTime>2006-11-03T23:00:00</StartTime>
          <EndTime>2006-11-04T23:00:00</EndTime>
        </Duration>
        <InternalReply>
          <Message>I am out of office. This is my internal reply.</Message>
        </InternalReply>
        <ExternalReply>
          <Message>I am out of office. This is my external reply.</Message>
        </ExternalReply>
      </OofSettings>
      <AllowExternalOof>All</AllowExternalOof>
    </GetUserOofSettingsResponse>
  </soap:Body>
</soap:Envelope>

Elementos de resposta GetUserOofSettings bem-sucedidos

Os seguintes elementos são usados na resposta:

Exemplo de resposta de erro GetUserOofSettings

Descrição

O exemplo a seguir mostra uma resposta de erro causada por uma tentativa de acessar as informações do OOF de outro usuário.

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="685" MinorBuildNumber="8" 
                         xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <soap:Fault>
      <faultcode>soap:Client</faultcode>
      <faultstring>Microsoft.Exchange.Data.Storage.AccessDeniedException: User is not mailbox owner. User = S-1-5-21-3642464542-282065186-3871681729-1155, MailboxGuid = S-1-5-21-3642464542-282065186-3871681729-1156 ---> User is not mailbox owner. </faultstring>
      <faultactor>https://CAS01.example.com/EWS/Exchange.asmx</faultactor>
      <detail>
        <ErrorCode xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">-2146233088</ErrorCode>
      </detail>
    </soap:Fault>
  </soap:Body>
</soap:Envelope>

Confira também