RequestedView
Last modified: March 16, 2009
Applies to: Exchange Server 2007 | Exchange Server 2010
The RequestedView element defines the type of calendar information that a client requests.
GetUserAvailabilityRequest
FreeBusyViewOptions
RequestedView
<RequestedView>None or MergedOnly or FreeBusy or FreeBusyMerged or Detailed or DetailedMerged</RequestedView>
FreeBusyViewType
Attributes and Elements
The following sections describe attributes, child elements, and parent elements.
Attributes
None.
Child Elements
None.
Parent Elements
Element |
Description |
|---|---|
Specifies the type of free/busy information returned in the response. The following is the XPath to this element: /GetUserAvailabilityRequest/FreeBusyViewOptions |
Text Value
A text value is required. The following table lists the possible values for this element.
Value |
Description |
|---|---|
None |
This value is not valid for requests. This value is valid for responses. |
MergedOnly |
Represents an aggregated free/busy stream. In cross-forest scenarios in which the target user in one forest does not have an Availability service configured, the Availability service of the requestor retrieves the target user’s free/busy information from the free/busy public folder. Because public folders only store free/busy information in merged form, MergedOnly is the only available information. |
FreeBusy |
Represents the legacy status information: free, busy, tentative, and OOF. This also includes the start/end times of the appointments. This view is richer than the legacy free/busy view because individual meeting start and end times are provided instead of an aggregated free/busy stream. |
FreeBusyMerged |
Represents all the properties in FreeBusy with a stream of merged free/busy information. |
Detailed |
Represents the legacy status information: free, busy, tentative, and OOF; the start/end times of the appointments; and various properties of the appointment such as subject, location, and importance. This requested view will return the maximum amount of information for which the requesting user is privileged. If merged free/busy information only is available, as with requesting information for users in a Microsoft Exchange Server 2003 forest, MergedOnly will be returned. Otherwise, FreeBusy or Detailed will be returned. |
DetailedMerged |
Represents all the properties in Detailed with a stream of merged free/busy information. If merged free/busy information only is available, MergedOnly will be returned. Otherwise, FreeBusyMerged or DetailedMerged will be returned. |
Remarks
The value set by this element is returned with the FreeBusyViewType element in the response.
The following table shows what is returned for the different view types and the corresponding MAPI property. Each view type builds upon the former view type.
Free/Busy View Type |
Properties |
MAPI Calendar Property |
|---|---|---|
MergedOnly |
MergedFreeBusyStream |
|
FreeBusy |
Classical status |
PropTag (0x80860003) |
FreeBusy |
Working hours |
|
FreeBusy |
Start time |
PR_START_DATE |
FreeBusy |
End time |
PR_END_DATE |
FreeBusyMerged |
Classical status |
PropTag (0x80860003) |
FreeBusyMerged |
Working hours |
|
FreeBusyMerged |
Start time |
PR_START_DATE |
FreeBusyMerged |
End time |
PR_END_DATE |
FreeBusyMerged |
MergedFreeBusyStream |
|
Detailed |
Classical status |
PropTag (0x80860003) |
Detailed |
Working hours |
|
Detailed |
Start time |
PR_START_DATE |
Detailed |
End time |
PR_END_DATE |
Detailed |
Subject |
PR_SUBJECT |
Detailed |
Location |
PR_LOCATION |
Detailed |
Entry-Id(unless private) |
|
Detailed |
Private Flag |
|
Detailed |
IsMeeting |
|
Detailed |
IsRecurring |
|
Detailed |
IsException |
|
Detailed |
IsReminderSet |
|
DetailedMerged |
Classical status |
PropTag (0x80860003) |
DetailedMerged |
Working hours |
|
DetailedMerged |
Start time |
PR_START_DATE |
DetailedMerged |
End time |
PR_END_DATE |
DetailedMerged |
Subject |
PR_SUBJECT |
DetailedMerged |
Location |
PR_LOCATION |
DetailedMerged |
Entry-Id(unless private) |
|
DetailedMerged |
Private Flag |
|
DetailedMerged |
MergedFreeBusyStream |
|
DetailedMerged |
IsMeeting |
|
DetailedMerged |
IsRecurring |
|
DetailedMerged |
IsException |
|
DetailedMerged |
IsReminderSet |
Element Information
Namespace |
https://schemas.microsoft.com/exchange/services/2006/types |
Schema Name |
Types schema |
Validation File |
Types.xsd |
Can be Empty |
False |
See Also