Compartilhar via


GroupBy

O elemento GroupBy especifica um agrupamento arbitrário para consultas FindItem.

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

GroupByType

Atributos e elementos

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Atributos

Atributo Descrição
Order
Determina a ordem dos grupos na matriz de itens agrupadas que é retornada na resposta. Esse atributo é do tipo SortDirectionType.

Valores de atributo de ordem

Valor Descrição
Crescente
Os grupos são ordenados em ordem crescente.
Decrescente
Os grupos são ordenados em ordem decrescente.

Elementos filho

Elemento Descrição
FieldURI
Identifica propriedades referenciadas com frequência pelo URI.
IndexedFieldURI
Identifica membros individuais de um dicionário.
ExtendedFieldURI
Identifica propriedades MAPI estendidas para obter, definir ou criar.
AggregateOn
Representa o campo usado para determinar a ordem dos grupos em uma resposta.

Elementos pai

Elemento Descrição
FindItem
Define uma solicitação para encontrar itens em uma caixa de correio.

A seguir está a expressão XPath para este elemento: /FindItem

Comentários

A resposta FindItem conterá uma coleção de grupos. Cada grupo conterá todos os itens que tinham valores correspondentes para a propriedade GroupBy . A propriedade que determina o agrupamento é identificada no elemento FieldURI, IndexedFieldURI ou ExtendedFieldURI .

O esquema que descreve esse elemento está localizado no diretório virtual do EWS do computador que está executando Microsoft Exchange Server 2007 que tem a função de servidor do Client Access instalada.

Elemento de informações

Elemento Exemplo
Namespace
http://schemas.microsoft.com/exchange/services/2006/messages
Nome do esquema
Esquema de mensagens
Arquivo de validação
Messages.xsd
Pode ser vazio
False

Confira também