ExternalAudience
The ExternalAudience element sets or contains a value that determines to whom external Out of Office (OOF) messages are sent.
<ExternalAudience>None or Known or All</ExternalAudience>
ExternalAudience
Attributes and elements
The following sections describe attributes, child elements, and parent elements.
Attributes
None.
Child elements
None.
Parent elements
| Element | Description |
|---|---|
| UserOofSettings |
Specifies the 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 |
Text value
A text value is required for this element. The following table lists the possible values for this element.
| Value | Description |
|---|---|
| None |
E-mail senders outside the mailbox user's organization who send messages to the user will not receive an external OOF message response. |
| Known |
E-mail senders outside the mailbox user's organization who send messages to the user will only receive an external OOF message response if the sender is in the user's Exchange store contact list. |
| All |
E-mail senders outside the mailbox user's organization who send messages to the user will receive an external OOF message response. |
Remarks
This element shares the same type as the AllowExternalOof element.
The schema that describes this element is located in the EWS virtual directory of the computer that is running MicrosoftExchange 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 external audience to All, sets the duration of OOF to 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="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<SetUserOofSettingsRequest xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<Mailbox xmlns="http://schemas.microsoft.com/exchange/services/2006/types">
<Name>David Alexander</Name>
<Address>someone@example.com</Address>
<RoutingType>SMTP</RoutingType>
</Mailbox>
<UserOofSettings xmlns="http://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
| Element | Type |
|---|---|
| Namespace |
http://schemas.microsoft.com/exchange/services/2006/types |
| Schema Name |
Types schema |
| Validation File |
Types.xsd |
| Can be Empty |
False |