MergedFreeBusy

Topic Last Modified: 2006-11-29

The MergedFreeBusy element contains the merged free/busy stream of data.

Schema Hierarchy

GetUserAvailabilityResponse
  FreeBusyResponseArray
    FreeBusyResponse
      FreeBusyView
        MergedFreeBusy

Syntax

<MergedFreeBusy>...</MergedFreeBusy>

Type

string

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 provided by the server if the value for the FreeBusyViewType element is one of the following:

  • DetailedMerged
  • FreeBusyMerged
  • MergedOnly

The text value is a stream of free/busy information.

Remarks

The stream of data provided by this element is defined by the MergedFreeBusyIntervalInMinutes and TimeWindow elements. The TimeWindow element defines the time span queried for availability. The MergedFreeBusyIntervalInMinutes element defines how the time from the TimeWindow element is broken into intervals returned in the MergedFreeBusy element. Each number in the MergedFreeBusy stream represents a single interval defined by the MergedFreeBusyIntervalInMinutes element. The following table lists the possible values for an individual interval.

Digit Availability

0

Free

1

Tentative

2

Busy

3

Out of Office (OOF)

4

No data

For example, a request for free/busy data includes a TimeWindow element that represents four hours and a MergedFreeBusyIntervalInMinutes element that represents 60 minutes. If the requested user's calendar is OOF for the first 60 minutes, busy for the following 90 minutes, and unscheduled for the final 90 minutes in the time window, the MergedFreeBusy stream will be 3220. If an interval contains more than one availability classification, the highest number is used to classify that interval.

The level of detail provided by this element depends on the permissions granted to the requestor.

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.

Element Information

Namespace

https://schemas.microsoft.com/exchange/services/2006/types

Schema Name

Types schema

Validation File

Types.xsd

Can be Empty

False