Implementieren einer Suche

Letzte Änderung: Montag, 19. April 2010

Gilt für: SharePoint Server 2010

Inhalt dieses Artikels
Beschreibung
Syntax
Hinweise
Beispiele

Beschreibung

Eine Finder-Methode ist eine spezielle Methodeninstanz, von der mehrere Entitätsinstanzen zurückgegeben werden. Dieser Stereotyp wird zum Lesen einer Liste von Elementen mit einem Filterkriterium verwendet. Für ein Geschäftsobjekt mit dem Namen Kunde beispielsweise kann diese Methode verwendet werden, um eine Liste der Kunden abzurufen, deren Auftragsmenge in einem bestimmten Bereich liegt.

Externe Inhaltstypen können eine oder mehrere Finder-Methoden haben, mit denen mehrere Instanzen zurückgegeben werden. Wenn Sie keine Finder-Methoden definieren, kann der externe Inhaltstyp nicht für die Präsentationsfeatures von Business-Konnektivitätsdienste (Business Connectivity Services), beispielsweise externe Listen und Listenwebparts für Geschäftsdaten, verwendet werden.

Syntax

Nachfolgend sehen Sie die typische Methodensignatur für eine Finder-Methode:

public static EntityDataType[] GetEntities ()

Hinweise

Für die Verwendung als Finder sollte die entsprechende Methode folgende Bedingungen erfüllen:

• Das Filterkriterium sollte als Eingabeparameter zur Begrenzung der Anzahl der zurückgegebenen Elemente akzeptiert werden (insbesondere, wenn zahlreiche Elemente zurückgegeben werden).

• Es sollten Auflistungen von Elementen eines externen Inhaltstyps zurückgegeben werden.

• Der Bezeichner des Elements sollte als Teil der für das jeweilige Element zurückgegebenen Ansicht zurückgegeben werden.

• Umfassende Filter sollten unterstützt werden (Details zu den zu unterstützenden Filtern finden Sie im Abschnitt zur Filterunterstützung in Business-Konnektivitätsdienste (Business Connectivity Services)).

• Es wird empfohlen, dass von der Finder-Methode bei Rückgabe zahlreicher Elemente Auslagerung oder Batchverarbeitung unterstützt wird.

• Die für die einzelnen Elemente von dieser Methode zurückgegebene "Ansicht" muss gleich oder eine Teilmenge der Ansicht für die bestimmte Finder-Methode sein. Der Grund ist, dass Erstellungs- und Updatevorgänge von der bestimmten Suchansicht abhängen. Wenn von der Suche mehrere Felder zurückgegeben werden, können die zusätzlichen Felder nicht aktualisiert werden. Wenn von einer Finder-Methode nur eine Teilmenge der Daten zurückgegeben wird, wird ein SpecificFinder-Aufruf ausgeführt, um die restlichen Daten zurückzugeben. Dadurch soll sichergestellt werden, dass die zwischengespeicherten Elemente vollständig sind. Daher werden für die bestimmte Suche und die Suche identische Ansichten empfohlen. Wenn der Aufruf der bestimmten Suche und die Suchmethode identische Ansichten haben, werden Aufrufe an das externe System von Business-Konnektivitätsdienste (Business Connectivity Services) optimiert.

In SharePoint 2010 kann ein externer Inhaltstyp mehrere Suchmethoden mit unterschiedlichen Ansichten haben. Mehrere Suchmethoden sind beispielsweise in folgenden Szenarien hilfreich:

1. Rollenbasierte Ansichten: Eine Finder-Methode kann verwendet werden, um Kollegen und dem globalen Adressbuch eine eingeschränkte Ansicht anzuzeigen, während eine andere Suchmethode verwendet werden kann, um dem Mitarbeiter oder dem Vorgesetzten des Mitarbeiters eine andere detaillierte Ansicht anzuzeigen.

2. **Cacheoptimierung:**Business-Konnektivitätsdienste (Business Connectivity Services) bietet umfangreiche Unterstützung für die Offlineverwendung von Geschäftsdaten auf Microsoft Office-Clients wie Outlook und SharePoint Workspace. Administratoren können die Offlineverwendung für detaillierte Ansichten deaktivieren, um die Cachenutzung auf der Clientseite zu optimieren. Auf diese Weise verfügen Benutzer über eine eingeschränkte Offlineansicht und können, wenn sie online sind, auf die detaillierte Ansicht zugreifen.

Hinweis
Wenn mehrere bestimmte Suchmethoden mit unterschiedlichen Ansichten eines Geschäftsobjekts vorhanden sind, sollte für jede bestimmte Suchmethode mindestens eine Finder-Methode vorhanden sein.

Beispiele

Codeausschnitt: Implementieren von "Finder"

Siehe auch

Konzepte

XML Snippet: Modellieren einer Finder-Methode

Codeausschnitt: Ausführen einer Finder-Methodeninstanz eines externen Inhaltstyps