• Article

Duration (UserOofSettings)

Topic Last Modified: 2006-11-29

The Duration element specifies the duration that the Out of Office (OOF) status is enabled if the OofState element is set to Scheduled.

Syntax

<Duration>
   <StartTime>...</StartTime>
   <EndTime>...</EndTime>
</Duration>

Type

Duration

Attributes and Elements

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

Attributes

None.

Child Elements

Element Description

StartTime

Represents the start of the time span set with an OOF status. This element is required.

EndTime

Represents the end of the time span set with an OOF status. This element is required.

Parent Elements

Element Description

UserOofSettings

Specifies the Out of Office (OOF) settings.

The following is the XPath expression to this element:

/SetUserOofSettingsRequest/UserOofSettings

OofSettings

Contains the OOF settings.

The following is the XPath expression to this element:

/GetUserOofSettingsResponse/OofSettings

Remarks

The Duration type is also the type for the DetailedSuggestionsWindow and TimeWindow elements.

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, the internal and external OOF messages, and sets the duration of OOF for 10 days.

<?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>
        <SetByLegacyClient>false</SetByLegacyClient>
      </UserOofSettings>
    </SetUserOofSettingsRequest>
  </soap:Body>
</soap:Envelope>

Element Information

Namespace

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

Schema Name

Types schema

Validation File

Types.xsd

Can be Empty

False