• Article

UserOofSettings

Topic Last Modified: 2006-11-29

The UserOofSettings element specifies the Out of Office (OOF) settings.

Syntax

<UserOofSettings>
   <OofState>...</OofState>
   <ExternalAudience>...</ExternalAudience>
   <Duration>...</Duration>
   <InternalReply>...</InternalReply>
   <ExternalReply>...</ExternalReply>
</UserOofSettings>

Type

UserOofSettings

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

None.

Child Elements

Element Description

OofState

Sets the user's OOF state.

ExternalAudience

Sets or contains a value that determines to whom external OOF messages are sent.

Duration (UserOofSettings)

Specifies the duration for which the OOF status is enabled if the OofState element is set to Scheduled. If the OofState element is set to Enabled or Disabled, the value of this element is ignored.

InternalReply

Contains the OOF response sent to other users in the user's domain or trusted domains.

ExternalReply

Contains the OOF response sent to addresses outside the recipient's domain or trusted domains.

Parent Elements

Element Description

SetUserOofSettingsRequest

Contains the arguments used to set a mailbox user's OOF settings and messages.

The following is the XPath expression to this element:

/SetUserOofSettingsRequest

Remarks

The schema that describes this element is located in the EWS virtual directory of the computer that is running Microsoft Exchange Server 2007 that has the Client Access server role installed.

Example

The following example of a SetUserOofSettings request sets the OoFState to Enabled, sets the duration of OOF for 10 days, and sets the internal and external OOF messages.

<?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="https://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <SetUserOofSettingsRequest xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <Mailbox xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
        <Name>David Alexander</Name>
        <Address>someone@example.com</Address>
        <RoutingType>SMTP</RoutingType>
      </Mailbox>
      <UserOofSettings xmlns="https://schemas.microsoft.com/exchange/services/2006/types">
        <OofState>Enabled</OofState>
        <ExternalAudience>All</ExternalAudience>
        <Duration>
          <StartTime>2005-10-05T00:00:00</StartTime>
          <EndTime>2005-10-25T00: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>
      </UserOofSettings>
    </SetUserOofSettingsRequest>
  </soap:Body>
</soap:Envelope>

Element Information

Namespace

https://schemas.microsoft.com/exchange/services/2006/messages

Schema Name

messages schema

Validation File

Messages.xsd

Can be Empty

False

See Also

Reference

SetUserOofSettings Operation