<FilterDescriptor Type = "String" FilterField = "String" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </FilterDescriptor>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.
Attribute
Attribut
Beschreibung
Typ
Erforderlich.
Der Typ des Filterdeskriptors.
In der folgenden Tabelle werden die möglichen Werte für dieses Attribut aufgeführt.
Wert
Beschreibung
Limit
Wird beim Durchführen einer Abfrage in einem externen System verwendet, wenn der Attributwert als Höchstwert für die Anzahl der externen Elemente (EntityInstances), die beim Aufruf der Methode, zu der das Attribut gehört, zurückgegeben werden, interpretiert werden kann.
PageNumber
Wildcard
Wird beim Durchführen einer Abfrage in einem externen System verwendet. Der Wert stellt ein Muster aus regulären Zeichen und Platzhalterzeichen dar, das mit dem Wert eines bestimmten Felds der Gruppe der EntityInstances abgeglichen wird. Vom externen System werden nur die EntityInstances zurückgegeben, deren Feldwerte mit dem angegebenen Muster übereinstimmen.
UserContext
Wird beim Durchführen einer Abfrage in einem externen System verwendet. Der Wert kann von jeder Clientanwendung automatisch auf die Identität des Benutzers festgelegt werden, der das externe System aufruft. Anhand dieses Werts kann das externe System die Autorisierung durchführen und anschließend die zurückgegebenen Ergebnisse filtern.
UserCulture
Username
Password
LastId
SsoTicket
UserProfile
Wird beim Durchführen einer Abfrage in einem externen System verwendet. Der Wert kann durch Analysieren des Profils des aktuellen Benutzers abgerufen werden. Anhand dieses Werts kann das externe System die zurückgegebenen Ergebnisse filtern.
Comparison
Wird beim Durchführen einer Abfrage in einem externen System verwendet. Ein externes System kann einen ComparisonFilter-Wert mit dem Wert eines bestimmten Felds einer Gruppe von EntityInstances vergleichen und nur die EntityInstances zurückgeben, bei denen das Feld den Vergleichstest besteht.
Timestamp
Input
Wird beim Aufrufen eines Vorgangs in einem externen System verwendet. Der Wert eines InputFilter-Typs kann von einem externen System als zusätzliches Argument für den Vorgang verwendet werden.
Output
Wird beim Aufrufen eines Vorgangs in einem externen System verwendet. Zusätzliche Ergebnisse eines Vorgangs, die von ReturnTypeDescriptor nicht erfasst werden können, lassen sich als ein Wert des InputOutputFilter-Typs abrufen.
InputOutput
Wird beim Aufrufen eines Vorgangs in einem externen System verwendet. Der Wert eines InputOutputFilter-Typs kann von einem externen System als zusätzliches Argument für den Vorgang verwendet werden, und zusätzliche Ergebnisse eines Vorgangs, die von ReturnTypeDescriptor nicht erfasst werden können, lassen sich als ein Wert des InputOutputFilter-Typs abrufen.
Batching
BatchingTermination
ActivityId
ActivityId wird beim Aufrufen eines Vorgangs im externen System verwendet. Der Wert ist eine GUID, die den aktuellen Vorgangskontext darstellt. Ist kein solcher Wert vorhanden, generiert dieser Filter eine Zufalls-GUID. In SharePoint Foundation 2010 wird für diesen Filter die CorrelationID verwendet.
FilterField
Optional.
Attributtyp: String
Name
Erforderlich.
Der Name des Filterdeskriptors.
Attributtyp: String
DefaultDisplayName
Optional.
Der standardmäßige Anzeigename des Filterdeskriptors.
Attributtyp: String
IsCached
Optional.
Gibt an, ob dieser Filter häufig verwendet wird. Ist der Wert true, wird dieser Filterdeskriptor von Business Data Connectivity-Dienst (BDC) im Arbeitsspeicher zwischengespeichert.