FreeBusyViewType

Topic Last Modified: 2006-11-29

The FreeBusyViewType element represents the type of free/busy information returned in the response.

Schema Hierarchy

GetUserAvailabilityResponse
  FreeBusyResponseArray
    FreeBusyResponse
      FreeBusyView
        FreeBusyViewType

Syntax

<FreeBusyViewType>None or MergedOnly or FreeBusy or FreeBusyMerged or Detailed or DetailedMerged</FreeBusyViewType>

Type

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.

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 Microsoft Exchange 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