Freigeben über


"FilterDescriptor"-Element in "FilterDescriptors" ("BDCMetadata"-Schema)

Letzte Änderung: Montag, 29. März 2010

Gilt für: SharePoint Server 2010

Gibt einen Filterdeskriptor einer Methode an.

Namespace: https://schemas.microsoft.com/windows/2007/BusinessDataCatalog

Schema: BDCMetadata

<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.

Standardwert: true

Attributtyp: Boolean

Untergeordnete Elemente

Element

Beschreibung

LocalizedDisplayNames-Element in "MetadataObject" (BDCMetadata-Schema)

Die lokalisierten Anzeigenamen dieses Filterdeskriptors.

Properties-Element in MetadataObject (BDCMetadata-Schema)

Die Eigenschaften dieses Filterdeskriptors.

Übergeordnete Elemente

Element

Beschreibung

FilterDescriptors-Element in Method (BDCMetadata-Schema)

Eine Liste der Filterdeskriptoren einer Methode.