Article
08/21/2009

FindItem

Topic Last Modified: 2009-07-27

The FindItem element defines a request to find items in a mailbox.

Syntax

<FindItem Traversal="">
   <ItemShape/>
   <IndexedPageItemView/>
   <GroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <FractionalPageItemView/>
   <GroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <CalendarView/>
   <GroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <ContactsView/>
   <GroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <IndexedPageItemView/>
   <DistinguishedGroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <FractionalPageItemView/>r
   <DistinguishedGroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <CalendarView/>
   <DistinguishedGroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
</FindItem>

<FindItem Traversal="">
   <ItemShape/>
   <ContactsView/>
      <DistinguishedGroupBy/>
   <Restriction/>
   <SortOrder/>
   <ParentFolderIds/>
</FindItem>

Type

FindItemType

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute	Description
Traversal	Defines whether the search finds items in folders or the folders' dumpsters. This attribute is required.

Traversal Attribute Values

Value	Description
Shallow	Returns only the identities of items in the folder.
SoftDeleted	Returns only the identities of items that are in a folder's dumpster.

Child Elements

Element	Description
ItemShape	Identifies the item properties and content to include in a FindItem response.
IndexedPageItemView	Describes how paged item information is returned for a FindItem request. This element is optional.
FractionalPageItemView	Describes where the paged view starts and the maximum number of items returned in a FindItem request. The paged view offset from the beginning of the set of found items is described by a fraction. This element is optional.
CalendarView	Provides time span limits to define a search for calendar items. This element is optional.
ContactsView	Defines a search for contact items based on alphabetical display names. This element is optional.
GroupBy	Specifies arbitrary groupings for FindItem queries. This element is optional.
DistinguishedGroupBy	Provides standard groupings for FindItem queries. This element is optional.
Restriction	Defines the restriction or query that is used to filter items or folders in FindItem/FindFolder and search folder operations. This element is optional.
SortOrder	Defines how items are sorted in a FindItem request. This element is optional.
ParentFolderIds	Identifies folders to search for the FindItem and FindFolder operations.

Parent Elements

None.

Remarks

Only one of the IndexedPageItemView, FractionalPageItemView, CalendarView, or ContactsView elements can be included in a FindItem request. Only one of the GroupBy or DistinguishedGroupBy elements can be included in a FindItem request.

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

Share via