FindItem

Artikel
03/29/2023

Das FindItem-Element definiert eine Anforderung zum Suchen von Elementen in einem Postfach.

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

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

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

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

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

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

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

FindItemType

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.

Attribute

Attribut	Beschreibung
Traversal	Definiert, ob die Suche Elemente in Ordnern oder den Ordnerabbildern findet. Dieses Attribut ist erforderlich.

Traversal-Attributwerte

Wert	Beschreibung
Flachen	Gibt nur die Identitäten von Elementen im Ordner zurück.
SoftDeleted	Gibt nur die Identitäten von Elementen zurück, die sich im Dumpster eines Ordners befinden. Beachten Sie, dass ein vorläufig gelöschter Durchlauf in Kombination mit einer Sucheinschränkung dazu führt, dass null Elemente zurückgegeben werden, auch wenn Elemente vorhanden sind, die den Suchkriterien entsprechen.
Zugeordneten	Gibt nur die Identitäten der zugeordneten Elemente im Ordner zurück.

Untergeordnete Elemente

Element	Beschreibung
ItemShape	Identifiziert die Elementeigenschaften und den Inhalt, die in eine FindItem-Vorgangsantwort eingeschlossen werden sollen.
IndexedPageItemView	Beschreibt, wie ausgelagerte Elementinformationen für eine FindItem-Anforderung zurückgegeben werden. Dieses Element ist optional.
FractionalPageItemView	Beschreibt, wo die ausgelagerte Ansicht beginnt und wie viele Elemente in einer FindItem-Anforderung maximal zurückgegeben werden. Der Seitenansichtsoffset vom Anfang der Gruppe gefundener Elemente wird durch einen Bruch beschrieben. Dieses Element ist optional.
CalendarView	Stellt Zeitlimits bereit, um eine Suche nach Kalenderelementen zu definieren. Dieses Element ist optional.
ContactsView	Definiert eine Suche nach Kontaktelementen basierend auf alphabetischen Anzeigenamen. Dieses Element ist optional.
GroupBy	Gibt beliebige Gruppierungen für FindItem-Abfragen an. Dieses Element ist optional.
DistinguishedGroupBy	Stellt Standardgruppierungen für FindItem-Abfragen bereit. Dieses Element ist optional.
Restriction	Definiert die Einschränkung oder Abfrage, die zum Filtern von Elementen oder Ordnern in FindItem/ FindFolder - und Suchordnervorgängen verwendet wird. Dieses Element ist optional.
SortOrder	Definiert, wie Elemente in einer FindItem-Anforderung sortiert werden. Dieses Element ist optional.
ParentFolderIds	Identifiziert Ordner, die nach den FindItem- und FindFolder-Vorgängen gesucht werden sollen.
QueryString (QueryStringType)	Enthält eine Postfachabfragezeichenfolge, die auf der erweiterten Abfragesyntax (Advanced Query Syntax, AQS) basiert.

Übergeordnete Elemente

Keine.

HinwBemerkungeneise

Nur eines der Elemente IndexedPageItemView, FractionalPageItemView, CalendarView oder ContactsView kann in eine FindItem-Anforderung eingeschlossen werden. Nur eines der GroupBy - oder DistinguishedGroupBy-Elemente kann in eine FindItem-Anforderung eingeschlossen werden.

Das Schema, das dieses Element beschreibt, befindet sich im virtuellen IIS-Verzeichnis, das Exchange-Webdienste hostet.

Informationen zu Elementen

Element	Beispiel
Namespace	https://schemas.microsoft.com/exchange/services/2006/messages
Name des Schemas	Nachrichtenschema
Überprüfungsdatei	Messages.xsd
Leer kann sein	False