GroupByGroupBy

GroupBy要素は、FindItem クエリの任意のグループ化を指定します。The GroupBy element specifies an arbitrary grouping for FindItem queries.

<GroupBy Order="">
   <FieldURI/>
   <AggregateOn/>
</GroupBy>
<GroupBy Order="">
   <ExtendededFieldURI/>
   <AggregateOn/>
</GroupBy>
<GroupBy Order="">
   <IndexedFieldURI/>
   <AggregateOn/>
</GroupBy>

GroupByTypeGroupByType

属性と要素Attributes and elements

以下のセクションで、属性、子要素、親要素について説明します。The following sections describe attributes, child elements, and parent elements.

属性Attributes

属性Attribute 説明Description
OrderOrder
応答で返されるグループ化されたアイテムの配列内のグループの順序を指定します。Determines the order of the groups in the grouped item array that is returned in the response. この属性の型は Sortdirection 型です。This attribute is of type SortDirectionType.

Order 属性の値Order attribute values

Value 説明Description
Ascending/昇順Ascending
グループは昇順で並べ替えられます。The groups are ordered in ascending order.
Descending/降順Descending
グループは、降順で順序付けられます。The groups are ordered in descending order.

子要素Child elements

ElementElement 説明Description
FieldURIFieldURI
URI で頻繁に参照されるプロパティを識別します。Identifies frequently referenced properties by URI.
IndexedFieldURIIndexedFieldURI
辞書の個々のメンバーを識別します。Identifies individual members of a dictionary.
ExtendedFieldURIExtendedFieldURI
取得、設定、または作成する拡張 MAPI プロパティを識別します。Identifies extended MAPI properties to get, set, or create.
AggregateOnAggregateOn
応答内のグループの順序を決定するために使用されるフィールドを表します。Represents the field that is used to determine the order of groups in a response.

親要素Parent elements

要素Element 説明Description
FindItemFindItem
メールボックス内のアイテムを検索するための要求を定義します。Defines a request to find items in a mailbox.

この要素の XPath 式を次に示します。/FindItemThe following is the XPath expression to this element: /FindItem

注釈Remarks

FindItem 応答には、グループのコレクションが含まれています。The FindItem response will contain a collection of groups. 各グループには、 GroupByプロパティに一致する値を持つすべてのアイテムが含まれます。Each group will contain all items that had matching values for the GroupBy property. グループ化を決定するプロパティは、 FieldURIIndexedFieldURI、またはExtendedFieldURI要素で識別されます。The property that determines the grouping is identified in the FieldURI, IndexedFieldURI, or ExtendedFieldURI element.

この要素を記述するスキーマは、Microsoft Exchange Server 2007 を実行しているコンピューターの EWS 仮想ディレクトリにあり、クライアントアクセスサーバーの役割がインストールされています。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

NamespaceNamespace
https://schemas.microsoft.com/exchange/services/2006/messages
スキーマ名Schema Name
メッセージスキーマMessages schema
検証ファイルValidation File
メッセージ .xsdMessages.xsd
空に設定可能Can be Empty
正しくないFalse

関連項目See also