Gewusst wie: Hinzufügen von Filterparametern zu Vorgängen zum Begrenzen von Instanzen aus dem externen System

Letzte Änderung: Donnerstag, 24. September 2009

Gilt für: SharePoint Server 2010

Die Endbenutzer möchten möglicherweise die Instanzen eines externen Inhaltstyps abrufen, die bestimmten Kriterien entsprechen, beispielsweise in einer externen Liste. Angenommen, ein Benutzer möchte nur die Kunden, die in "New Jersey" leben, oder die Bestellungen eines bestimmten Kunden anzeigen. Dazu kann der Designer des externen Inhaltstyps Filter für die erforderlichen Vorgänge hinzufügen. Beim obigen Beispiel eines Filters für den Bundesstaat kann der Designer den Filterparameter Comparison Type erstellen und anschließend das State-Feld der Finder-Methode mit diesem neu gekennzeichneten Filter kennzeichnen. Viele derartige Filter können einer einzigen Methode (API) zugeordnet werden. Die Benutzer wählen dann zur Laufzeit den gewünschten Filter aus und geben einen Wert dafür an. BDC übergibt dann den Wert dieses Filters an die Back-End-Methode und fügt ihn genau an dem vom Back-End erwarteten Speicherort ein. Dadurch werden dann nur die vom Benutzer gewünschten Zeilen zurückgegeben.

Filter sind die grundlegende Methode, mit der Benutzereingaben (oder Systemeingaben) vom Business Data Connectivity-Dienst (BDC) erfasst und für den Back-End-API-Aufruf bereitgestellt werden. Filter beschreiben, wo ein Filterwert in einer komplexen Abfolge von Parametern eingefügt werden soll. Zu diesem Zweck werden die Eingabe- oder Rückgabeparameter einer Methodendefinition "gekennzeichnet", um anzugeben, wo ein Wert eingefügt werden soll. Beachten Sie unbedingt, dass die Filterfunktionalität vom Back-End bereitgestellt werden muss. Die Filter stellen nur einen Mechanismus dar, um dies für den Endbenutzer sichtbar zu machen.

Branchensysteme stellen verschiedene Filtermechanismen bereit. BDC verwendet allgemeine Muster, um Benutzern unabhängig von der Datenquelle dieselbe Filtersemantik bereitzustellen. BDC unterstützt mehrere Filter und Filtermuster. Weitere Informationen finden Sie unter Vom Business Data Connectivity-Dienst unterstützte Filtertypen

Mit Benutzerfiltern wie z. B. Comparison wird deklariert, welche Eingaben Benutzer überschreiben können, und mit Systemfiltern wie z. B. UserContext und UserProfile kann BDC Werte wie z. B. Benutzertoken auf sichere Weise festlegen.

Wichtig
Wenn ein Metadatenautor fehlerhafte Metadaten erstellt, die einen Benutzernamen als durch den Benutzer steuerbaren Filter verwenden und vertrauliche persönliche Daten zurückgeben, kann ein Benutzer möglicherweise die Daten eines anderen Benutzers einsehen. Um dies zu vermeiden, übergeben Sie den Benutzernamen mithilfe von UserContextFilter an den Methodenaufruf.

Clients führen eine Abfrage für das Metadatenrepository aus, um zu bestimmen, welche Filter vom System unterstützt werden, und ihre Benutzeroberflächen entsprechend zu rendern.

Siehe auch

Aufgaben

Gewusst wie: Hinzufügen eines Vergleichsfilters zu einer Methodeninstanz, die Daten zurückgibt