Implementieren eines SpecificFinders

Letzte Änderung: Dienstag, 20. April 2010

Gilt für: SharePoint Server 2010

Inhalt dieses Artikels
Beschreibung
Syntax
Hinweise
Beispiele

Beschreibung

Von einem SpecificFinder wird genau ein externes Element zurückgegeben. Dieser Stereotyp wird verwendet, um ein Element anhand des Bezeichners zu lesen. Bei einem Customer-Geschäftsobjekt beispielsweise kann dieser Stereotyp verwendet werden, um detaillierte Kundeninformationen für eine bestimmte Kunden-ID abzurufen.

Externe Inhaltstypen sollten über mindestens eine SpecificFinder-Methodeninstanz verfügen, von der anhand eines Bezeichners eine einzige Instanz zurückgegeben wird. Wenn Sie keine SpecificFinder-Methodeninstanz für einen externen Inhaltstyp definieren, können keine Aktionen für den externen Inhaltstyp ausgeführt werden, der externe Inhaltstyp kann nicht durchsucht oder indiziert werden und nicht in einem der Business-Konnektivitätsdienste (Business Connectivity Services)-Präsentationsfeatures verwendet werden (außer mit dem Listen-Webpart für externe verknüpfte Daten).

Syntax

Nachfolgend sehen Sie die typische Methodensignatur für SpecificFinder:

EntityDataType GetEntityById(IdType1 id1, ...)

Hinweise

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

• Alle Bezeichner eines externen Inhaltstyps werden als Eingabe akzeptiert.

• Die zurückgegebene Struktur enthält einen Satz von Feldern (eine Ansicht in Business-Konnektivitätsdienste (Business Connectivity Services); siehe Definition in diesem Thema).

Für die Verwendung als SpecificFinder muss die entsprechende Methode folgende Bedingungen erfüllen:

• Es muss ein einziges externes Element eines einzigen externen Inhaltstyps zurückgegeben werden.

• Die zurückgegebenen Felder müssen alle externen Elementbezeichner enthalten.

Hinweis

Normalerweise wird beim Lesevorgang das externe System abgefragt, um Daten abzurufen. Stellen Sie sicher, dass Sie Nullwerte in der SpecificFinder-Methode richtig behandeln. Wahrscheinlich enthalten einige Felder im externen System Nullwerte (beispielsweise hobbies oder address). Die ordnungsgemäße Behandlung von Fehlern und Ausnahmen ist unerlässlich. Überprüfen Sie daher den Code auf Nullwerte und leere Zeichenfolgen, und korrigieren Sie diese. Ziehen Sie außerdem die Verwendung der NormalizeString-Interpretation für Typdeskriptoren in Betracht.

Lösen Sie die in Tabelle 1 gezeigten Ausnahmen für die genannten Bedingungen in einer .NET-Verbindungsassembly aus.

Tabelle 1. Ausnahmen

Hinweis
In einem Webdienst sollte vom SpecificFinder ein Nullwert zurückgegeben werden, wenn das Element nicht gefunden wurde.

Eine Ansicht ist eine Sammlung von Feldern, die jeweils einen Namen, einen Typ und optional lokalisierte Feldnamen haben. Es handelt sich um eine schematische Definition – im Gegensatz zu Ansichten in SQL-Datenbanken , die die schematische Definition und die zurückgegebenen Daten als Teil der Abfrage enthalten.

Wenn beispielsweise Employee ein externer Inhaltstyp ist, kann eine Ansicht von Employee die folgenden Felder enthalten:

• ID

• Name

• Adresse

• Kennzeichen

Es ist möglich, für ein Geschäftsobjekt von Business-Konnektivitätsdienste (Business Connectivity Services) mehrere Ansichten zu verwenden. Eine andere Ansicht von Employee kann beispielsweise die folgenden Felder enthalten:

• ID

• Name

• Adresse

• Kennzeichen

• Jahreseinkommen

• Startdatum

• Dienstalter

• Notfallkontakt

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

• Rollenbasierte Ansichten: Für eine bestimmte EmployeeId kann eine bestimmte Suchmethode verwendet werden, um Kollegen eine eingeschränkte Ansicht anzuzeigen, während eine andere bestimmte Suchmethode verwendet werden kann, um dem Mitarbeiter oder dem Vorgesetzten des Mitarbeiters eine andere detaillierte Ansicht anzuzeigen.

• **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 Cacheleistung 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 Suchmethode vorhanden sein.

Hinweis
Nachfolgend finden Sie einige zusätzliche Hinweise zu BDC und externen Listen. Von BDC werden schreibgeschützte Felder unterstützt. Von externen Listen werden komplexe Typen nicht unterstützt. Die für externe Listen erstellten Standardformulare müssen für die Verwendung mit komplexen Typen durch Microsoft InfoPath 2010-Formulare ersetzt werden.

Beispiele

Codeausschnitt: Implementieren von "SpecificFinder"

Siehe auch

Konzepte

XML-Codeausschnitt: Modellieren einer SpecificFinder-Methode