FreeBusyViewType
Last modified: September 14, 2011
Applies to: Exchange Server 2007 | Exchange Server 2010
The FreeBusyViewType element represents the type of free/busy information returned in the response.
GetUserAvailabilityResponse
FreeBusyResponseArray
FreeBusyResponse
FreeBusyView
FreeBusyViewType
<FreeBusyViewType>None or MergedOnly or FreeBusy or FreeBusyMerged or Detailed or DetailedMerged</FreeBusyViewType>
FreeBusyViewType
Attributes and Elements
The following sections describe attributes, child elements, and parent elements.
Attributes
None.
Child Elements
None.
Parent Elements
Element |
Description |
|---|---|
Contains availability information for a specific user. The following is the XPath expression to this element: /GetUserAvailabilityResponse/FreeBusyResponseArray/FreeBusyResponse/FreeBusyView |
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 availability 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. If Detailed is specified for a distribution list, the free/busy information for the members of the list is merged, and MergedOnly is returned. |
DetailedMerged |
Represents all the properties in Detailed with a stream of merged free/busy availability information. If only merged free/busy information is available, for example if the mailbox exists on a computer running Exchange 2003, MergedOnly will be returned. Otherwise, FreeBusyMerged or DetailedMerged will be returned. |
Remarks
This element is required if the FreeBusyView element is used. The type of free/busy information returned is designated in the RequestedView 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.
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.
FreeBusyViewType |
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 |
|
Detailed |
Out of Office Message (if requested) |
|
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