Operación GetUserOofSettings

  • Artículo

La operación GetUserOofSettings obtiene la configuración y los mensajes fuera de office (OOF) de un usuario de buzón.

Encabezados SOAP

La operación GetUserOofSettings puede usar los encabezados SOAP enumerados y descritos en la tabla siguiente.

Header Elemento Descripción
Suplantación
 ExchangeImpersonation
Identifica al usuario al que suplanta la aplicación cliente.
ServerVersion
 ServerVersionInfo
Identifica la versión del servidor que respondió a la solicitud.

Uso de la operación GetUserOofSettings

La operación GetUserOofSettings proporciona acceso a la configuración de OOF de un usuario. La dirección de correo electrónico del usuario identifica a un usuario. Si el mensaje OOF es null y OOF está habilitado, no se envía ningún mensaje OOF.

Importante

Si MicrosoftOfficeOutlook establece los mensajes OOF, esta operación devolverá los mensajes OOF en formato HTML.

Ejemplo de solicitud GetUserOofSettings

Descripción

En el ejemplo siguiente se muestra una solicitud GetUserOofSettings que obtiene la información de OOF de un solo usuario.

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

Elementos Request

En la solicitud se usan los siguientes elementos:

Ejemplo de respuesta correcta de GetUserOofSettings

Descripción

En el ejemplo siguiente se muestra un estado OOF deshabilitado con los mensajes de 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="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <GetUserOofSettingsResponse xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <ResponseMessage ResponseClass="Success">
        <ResponseCode>NoError</ResponseCode>
      </ResponseMessage>
      <OofSettings xmlns="https://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 respuesta GetUserOofSettings correctos

Los siguientes elementos se usan en la respuesta:

Ejemplo de respuesta de error getUserOofSettings

Descripción

En el ejemplo siguiente se muestra una respuesta de error causada por un intento de acceder a la información de OOF de otro usuario.

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="https://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="https://schemas.microsoft.com/exchange/services/2006/messages">-2146233088</ErrorCode>
      </detail>
    </soap:Fault>
  </soap:Body>
</soap:Envelope>

Vea también