GroupBy
Last modified: July 27, 2009
Applies to: Exchange Server 2007 | Exchange Server 2010
The GroupBy element specifies an arbitrary grouping for FindItem queries.
<GroupBy Order="">
<FieldURI/>
<AggregateOn/>
</GroupBy>
<GroupBy Order="">
<IndexedFieldURI/>
<AggregateOn/>
</GroupBy>
<GroupBy Order="">
<ExtendededFieldURI/>
<AggregateOn/>
</GroupBy>
GroupByType
Attributes and Elements
The following sections describe attributes, child elements, and parent elements.
Attributes
Attribute |
Description |
---|---|
Order |
|
Order Attribute Values
Value |
Description |
---|---|
Ascending |
The groups are ordered in ascending order. |
Descending |
The groups are ordered in descending order. |
Child Elements
Element |
Description |
---|---|
Identifies frequently referenced properties by URI. |
|
Identifies individual members of a dictionary. |
|
Identifies extended MAPI properties to get, set, or create. |
|
Represents the field that is used to determine the order of groups in a response. |
Parent Elements
Element |
Description |
---|---|
Defines a request to find items in a mailbox. The following is the XPath expression to this element: /FindItem |
Remarks
The FindItem response will contain a collection of groups. Each group will contain all items that had matching values for the GroupBy property. The property that determines the grouping is identified in the FieldURI, IndexedFieldURI, or ExtendedFieldURI 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.
Element Information
Namespace |
https://schemas.microsoft.com/exchange/services/2006/messages |
Schema Name |
Messages schema |
Validation File |
Messages.xsd |
Can be Empty |
False |
See Also