FreeBusyViewType

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

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

See also

GetUserAvailability operation

GetUserAvailabilityResponse

Getting User Availability