Freigeben über


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

Gilt für: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online-| SharePoint Server 2013

Gibt einen Filterdeskriptor einer Methode an.

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

Schema: BDCMetadata

<FilterDescriptor Type = "String" FilterField = "String" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </FilterDescriptor>

Elemente und Attribute

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

Attribute

Attribut

Beschreibung

**Typ**

Erforderlich.

Der Typ des Filterdeskriptors.

Die folgende Tabelle listet die möglichen Werte für dieses Attribut auf.

Wert

Beschreibung

Grenze

Wird beim Abfragen eines externen Systems verwendet, und dessen Wert als Grenzwert für die Anzahl externer Elemente (**EntityInstances**) interpretiert werden kann, die zurückgegeben werden, wenn die Methode aufgerufen wird, zu der es gehört.

PageNumber

Platzhalter

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

Benutzername

Kennwort

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 es können nur die **EntityInstances** zurückgegeben werden, in denen die Feldwerte den Vergleichstest bestehen.

Zeitstempel

Input

Wird beim Aufrufen eines Vorgangs in einem externen System verwendet. Ein externes System kann den Wert eines **InputFilter** als zusätzliche Argumente für den Vorgang verwenden.

Ausgabe

Wird beim Aufrufen eines Vorgangs in einem externen System verwendet. Zusätzliche Ergebnisse eines Vorgangs, die nicht von **ReturnTypeDescriptor** erfasst werden können, können als Wert von **InputOutputFilter** abgerufen werden.

InputOutput

Wird beim Aufrufen eines Vorgangs in einem externen System verwendet. Ein externes System kann den Wert eines **InputOutputFilter** als zusätzliche Argumente für den Vorgang verwenden, und zusätzliche Ergebnisse eines Vorgangs, die nicht von **ReturnTypeDescriptor** erfasst werden können, können als Wert von **InputOutputFilter** abgerufen werden.

Batchverarbeitung

BatchingTermination

ActivityId

**ActivityId** wird beim Aufrufen eines Vorgangs auf dem 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 verwendet dieser Filter **CorrelationID**.

**FilterField**

Optional.

Attributtyp: **String**

**Namen**

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. Bei Festlegung auf **true** speichert der BDC-Dienst (Business Data Connectivity) diesen Filterdeskriptor im Arbeitsspeicher zwischen.

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.