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

  • Artikel

Letzte Änderung: Freitag, 16. April 2010

Gilt für: SharePoint Server 2010

Mit einem Vergleichsfilter werden nur die Instanzen zurückgegeben, die die Bedingung erfüllen. Dies wird in SQL mit der WHERE-Klausel unterstützt. In der Regel definieren Sie einen Vergleichsfilter für eine SpecificFinder-Methode oder eine Finder-Methodeninstanz.

In diesem Thema werden wir der Finder-Methodeninstanz des externen Inhaltstyps Contact den Vergleichsfilter StateFilter hinzufügen.

Voraussetzungen

  • Installation von Microsoft SQL Server 2005 oder höher auf dem Server mit SharePoint Server

  • Installation der AdventureWorks 2008-Datenbank auf dem Server mit SharePoint Server

  • Der externe Inhaltstyp Contact wurde basierend auf der AdventureWorks-Datenbank erstellt. Weitere Informationen finden Sie unter Gewusst wie: Erstellen externer Inhaltstypen.

Hinzufügen eines Filters zu einer Methodeninstanz mithilfe von SharePoint Designer

  1. Starten Sie Microsoft SharePoint Designer 2010, und öffnen Sie die SharePoint-Website, in der der externe Inhaltstyp enthalten ist.

  2. Klicken Sie in SharePoint Designer 2010 im linken Navigationsbereich auf Externe Inhaltstypen. Dadurch werden alle externen Inhaltstypen angezeigt, die im Business Data Connectivity-Dienst (BDC)-Metadatenspeicher der Dienstanwendung dieser Website definiert sind. Wählen Sie den externen Inhaltstyp Contact aus.

  3. Klicken Sie auf den Finder-Vorgang Contact, um einen Filter hinzuzufügen. Dadurch wird der Parameterkonfigurations-Assistent angezeigt.

  4. Klicken Sie auf Filterparameter. Klicken Sie im Filterparameter-Assistenten auf Neuer Parameter.

  5. Wählen Sie Status als Filterfeld aus. Klicken Sie auf Filterparameter.

  6. Klicken Sie im Dialogfeld Filterparameter auf Neuer Filter, und geben Sie dann StateFilter als Namen für den neuen Filter an.

  7. Wählen Sie anschließend Vergleich als Filtertyp aus. Wählen Sie Status als Filterfeld aus. Klicken Sie auf OK, um das Dialogfeld Filterparameter zu schließen.

  8. Geben Sie für den Filterparameter den Standardwert "Washington" ein. Klicken Sie auf OK und anschließend auf Speichern, um den externen Inhaltstyp zu speichern.

Beachten Sie, dass die Endbenutzer nun ihre eigenen benutzerdefinierten Filterwerte für StateFilter eingeben können, um gefilterte Instanzen z. B. in einer externen Liste anzuzeigen.

Tipps und Warnungen

  • Wenn Sie eine externe Liste verwenden, die in Microsoft Outlook oder Microsoft SharePoint Workspace offline gefiltert wurde, werden nur die aktuell in der Liste verfügbaren Instanzen auf dem Client bereitgestellt. Angenommen, Sie begrenzen die Liste, um nur Kunden aus New Jersey anzuzeigen, und klicken dann auf Verbindung mit Outlook herstellen. In diesem Fall werden nur Kunden aus New Jersey in Outlook bereitgestellt.

Bewährte Methoden

  • Sie sollten Benutzerfilter für Ihre SpecificFinder-Methode und Finder-Methode definieren, um die vom Back-End zurückgegebenen Instanzen zu begrenzen. Ein Begrenzungsfilter wird empfohlen.

  • Definieren Sie für Eingabeparameter Systemfilter. Definieren Sie für Rückgabeparameter Benutzerfilter.

  • Definieren Sie Standardwerte für die Filter. Andernfalls werden vom Back-End keine Instanzen zurückgegeben.

  • Definieren Sie entweder einen Begrenzungsfilter oder einen Seitenfilter für Methoden, mit denen mehrere Instanzen zurückgegeben werden.