RequestedView

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
FreeBusyViewOptions
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

Element Example
Namespace
https://schemas.microsoft.com/exchange/services/2006/types
Schema Name
Types schema
Validation File
Types.xsd
Can be Empty
False

See also

GetUserAvailability operation

Getting User Availability