Freigeben über

Entwerfen eines Business Data Connectivity-Modells

  • Artikel

Sie können ein Modell für den Business Data Connectivity-Dienst (BDC) entwickeln, indem Sie einer Modelldatei Entitäten und Methoden hinzufügen. Eine Entität beschreibt eine Sammlung von Datenfeldern. Beispielsweise kann eine Entität eine Tabelle in einer Datenbank darstellen. Eine Methode führt eine Aufgabe aus, z. B. das Hinzufügen, Löschen oder Aktualisieren von Daten, die durch die Entitäten dargestellt werden. Weitere Informationen finden Sie unter Integrieren von Geschäftsdaten in SharePoint.

Hinzufügen von Entitäten

Sie können eine Entität hinzufügen, indem Sie eine Entität aus der Visual Studio-Toolbox in den BDC-Designer ziehen oder kopieren. Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen einer Entität zu einem Modell.

Definieren Sie die Felder der Entität in einer Klasse. Beispielsweise können Sie einer Customer-Klasse ein Feld mit dem Namen Address hinzufügen. Sie können dem Projekt entweder eine neue Klasse hinzufügen oder eine vorhandene Klasse verwenden, die mit anderen Tools wie dem O/R-Designer (Objektrelationaler Designer) erstellt wurde. Der Name der Entität und der Name der Klasse, die die Entität darstellt, müssen nicht übereinstimmen. Sie verknüpfen die Klasse mit der Entität, wenn Sie die Methoden in Ihrem Modell definieren.

Hinzufügen von Methoden

Der BDC-Dienst ruft Methoden in Ihrem Modell auf, wenn Benutzer*innen Informationen in einer Liste oder einem Webpart, das auf Ihrem Modell basiert, anzeigen, hinzufügen, aktualisieren oder löschen. Sie müssen dem Modell für jede Aufgabe, die Benutzer*innen ausführen können, eine Methode hinzufügen. Erstellen Sie Methoden, indem Sie einen der fünf grundlegenden Methodentypen im Fenster BDC-Methodendetails auswählen. In der folgenden Tabelle werden die fünf grundlegenden Methoden eines BDC-Modells beschrieben.

Methode BESCHREIBUNG
Finder Gibt eine Sammlung von Entitätsinstanzen zurück. Wird aufgerufen, wenn Benutzer*innen die Liste oder das Webpart öffnen. Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen einer Finder-Methode.
Spezifischer Finder Gibt eine bestimmte Entitätsinstanz zurück. Wird aufgerufen, wenn Benutzer*innen die Details eines bestimmten Elements in einer Liste anzeigen. Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen einer bestimmten Finder-Methode.
Creator Fügt der Datenquelle einer Entität neue Daten hinzu. Wird aufgerufen, wenn Benutzer*innen die Schaltfläche Neues Element im Menüband einer Liste auswählen, die auf dem Modell basiert. Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen einer Creator-Methode.
Updater Ändert die Daten in einer Liste. Wird aufgerufen, wenn Benutzer*innen Informationen in einer Liste aktualisieren. Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen einer Updater-Methode.
Deleter Entfernt Daten. Wird aufgerufen, wenn Benutzer*innen ein Element aus der Liste löschen. Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen einer Deleter-Methode.

Definieren von Methodenparametern

Wenn Sie eine Methode erstellen, fügt Visual Studio die Eingabe- und Ausgabeparameter hinzu, die für den Methodentyp geeignet sind. Diese Parameter sind nur Platzhalter. In den meisten Fällen müssen Sie die Parameter so ändern, dass sie den richtigen Datentyp übergeben oder zurückgeben. Beispielsweise gibt eine Finder-Methode standardmäßig eine Zeichenfolge zurück. In den meisten Fällen möchten Sie den Rückgabeparameter der Finder-Methode so ändern, dass eine Sammlung von Entitäten zurückgegeben wird. Sie können dies erreichen, indem Sie den Typdeskriptor des Parameters ändern. Ein Typdeskriptor ist eine Sammlung von Attributen, die den Datentyp eines Parameters beschreibt. Weitere Informationen finden Sie unter Vorgehensweise: Definieren des Typdeskriptors eines Parameters.

Mit Visual Studio können Sie Typdeskriptoren zwischen Parametern im Modell kopieren. Sie können beispielsweise einen Typdeskriptor mit dem Namen CustomerTD für den Rückgabeparameter der GetCustomer-Methode definieren. Sie können den CustomerTD-Typdeskriptor im BDC-Explorer kopieren und diesen Typdeskriptor dann in den Eingabeparameter der CreateCustomer-Methode einfügen. Dies verhindert, dass Sie denselben Typdeskriptor mehrmals definieren müssen.

Methodeninstanzen

Wenn Sie eine Methode erstellen, fügt Visual Studio eine Standardmethodeninstanz hinzu. Eine Methodeninstanz ist ein Verweis auf eine Methode sowie die Standardwerte für die Parameter. Eine einzelne Methode kann mehrere Methodeninstanzen aufweisen. Jede Instanz ist eine Kombination aus der Methodensignatur und einer Reihe von Standardwerten. Weitere Informationen finden Sie unter Vorgehensweise: Definieren des Typdeskriptors eines Parameters.

Wenn Sie das Projekt ausführen, werden Methodeninstanzen in einer Dropdownliste oberhalb der SharePoint-Liste angezeigt. Benutzer*innen können Methodeninstanzen auswählen, um die Daten anzuzeigen.

Wenn Sie der Methodeninstanz Standardwerte hinzuzufügen möchten, müssen Sie den XML-Code des Modells direkt ändern. Weitere Informationen finden Sie unter DefaultValue.

Hinzufügen von Filterdeskriptoren

Consumer des Modells möchten möglicherweise Instanzen einer Entität abrufen, die einigen Kriterien entsprechen. Zum Aktivieren dieser Funktionalität können Sie einer Methode einen Filterdeskriptor hinzufügen. Filterdeskriptoren ermöglichen Modellconsumern das Filtern von Methodenresultsets, indem Werte an Methoden übergeben werden, bevor sie ausgeführt werden. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen von Filterparametern zu Vorgängen zum Begrenzen von Instanzen aus dem externen System.

SharePoint bietet mehrere Features, mit denen Benutzer*innen Filterwerte bereitstellen können. Beispielsweise stellen Geschäftsdatenwebparts ein Filtertextfeld bereit. Benutzer*innen können die Daten in einer Liste einschränken, indem sie einen Wert in das Textfeld eingeben. Weitere Informationen zum Hinzufügen eines Filterdeskriptors zu einer Methode finden Sie unter Vorgehensweise: Hinzufügen eines Filterdeskriptors zu einer Finder-Methode.

Filterdeskriptoreigenschaften

Sie müssen den Wert der Eigenschaften Zugeordneter Typdeskriptor, Name und Typ eines Filterdeskriptors festlegen. Alle anderen Eigenschaften sind optional.

Die Eigenschaft Zugeordneter Typdeskriptor setzt den Filterdeskriptor mit einem Eingabeparameter in Beziehung. Wenn Benutzer*innen einen Filterwert bereitstellen, übergibt der BDC-Dienst diesen Wert mithilfe des Eingabeparameters an die Methode.

Die Type-Eigenschaft beschreibt das Filtermuster, das Sie verwenden möchten. In SharePoint wirkt sich das von Ihnen ausgewählte Filtermuster auf den Text aus, der auf der Benutzeroberfläche angezeigt wird. Bei einem Vergleichsfiltermuster wird beispielsweise der Text ist gleich als Steuerelement über einem Geschäftsdatenwebpart angezeigt. Weitere Informationen zu den einzelnen Filtermustern finden Sie unter Vom Business Data Connectivity-Dienst unterstützte Filtertypen.

Weitere Informationen zu den Eigenschaften eines Filterdeskriptors finden Sie unter FilterDescriptor.

Angeben von Standardwerten

In einigen Fällen stellen Benutzer*innen möglicherweise keinen Filterwert bereit. Sie können einen Standardwert angeben, indem Sie der Methodeninstanz einen Standardwert hinzufügen oder den Standardwert im Code Ihrer Methode festlegen. Weitere Informationen zum Hinzufügen eines Standardwerts zur Methodeninstanz finden Sie unter MethodInstance. Ein Beispiel für das Festlegen des Standardwerts eines Eingabeparameters im Code ihrer Methode finden Sie unter Vorgehensweise: Hinzufügen eines Filterdeskriptors zu einer Finder-Methode.

Überprüfen des Modells

Sie können Ihr Modell während der Entwicklung überprüfen. Visual Studio identifiziert Probleme, die verhindern können, dass sich Ihr Modell wie erwartet verhält. Diese Probleme werden in der Fehlerliste von Visual Studio angezeigt.

Sie können ein Modell überprüfen, indem Sie das Kontextmenü für den BDC-Designer öffnen und dann Überprüfen auswählen. Wenn das Modell Fehler enthält, werden diese in der Fehlerliste angezeigt. Sie können den Cursor schnell zu dem Code bewegen, der einen Fehler enthält, indem Sie in der Liste auf den Fehler doppelklicken. Alternativ können Sie die Tasten F8 oder UMSCHALT+F8 wiederholt drücken, um die Fehler in der Liste vorwärts oder rückwärts zu durchlaufen.

Validierungsfehler können auftreten, wenn die Regeln des Modells in irgendeiner Weise verletzt werden. Wenn beispielsweise die IsCollection-Eigenschaft eines Typdeskriptors auf true festgelegt ist, aber keine untergeordneten Typdeskriptoren vorhanden sind, wird ein Validierungsfehler angezeigt. Möglicherweise müssen Sie auf die Regeln eines BDC-Modells zurückgreifen, um einige Fehler zu verstehen, die in der Fehlerliste von Visual Studio angezeigt werden. Weitere Informationen zu den Regeln eines BDC-Modells finden Sie unter BDCMetadata-Schema.

Debuggen der Projektmappe, die das Projekt enthält

Sie können Ihren Code so debuggen, wie Sie beliebigen Code in Visual Studio debuggen würden. Legen Sie zum Debuggen des Codes Haltepunkte an beliebigen Stellen im Code fest, und starten Sie dann den Debugger. Visual Studio öffnet die SharePoint-Website. Erstellen Sie in SharePoint eine Liste oder ein Webpart, das Ihre Geschäftsdaten verwendet. Anschließend können Sie Ihren Code Schritt für Schritt durchgehen. Weitere Informationen zum Debuggen von SharePoint-Projekten finden Sie unter Problembehandlung von SharePoint-Lösungen.

Sie können auch Code in benutzerdefinierten Assemblys debuggen, die Sie dem Projekt hinzufügen. Zum Debuggen von Code in einer benutzerdefinierten Assembly müssen Sie aber die Assembly dem Lösungspaket hinzufügen. Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen und Entfernen zusätzlicher Assemblys.

Weitere Informationen zum Hinzufügen einer benutzerdefinierten Assembly zu Ihrem Projekt finden Sie unter Vorgehensweise: Einschließen einer benutzerdefinierten Assembly in ein BDC-Feature.

Konfigurieren der BDC-Sicherheit

Möglicherweise müssen Sie Ihre Sicherheitseinstellungen in SharePoint ändern, bevor Sie Ihre Lösung debuggen können. Öffnen Sie zum Ändern dieser Einstellungen die Business Data Connectivity-Dienstanwendung auf der Website der SharePoint 2010-Zentraladministration. Fügen Sie im Dialogfeld Metadatenspeicherberechtigungen festlegen Ihr Benutzerkonto hinzu, und wählen Sie dann eine der folgenden Optionen aus:

Aufgabe Option
Modelle für den BDC-Dienst bereitstellen Bearbeiten
Listen und Webparts mithilfe externer Inhaltstypen (Entitäten) in Ihrem Modell erstellen In Clients auswählbar
Entitätsdaten erstellen, lesen, aktualisieren und löschen Execute

Weitere Informationen zu diesen Einstellungen finden Sie unter Business Data Connectivity-Dienstverwaltung.

Sie können auch Sicherheitsberechtigungen für einzelne Modelle oder externe Inhaltstypen festlegen. Weitere Informationen zum Festlegen der Sicherheitsberechtigungen eines Modells finden Sie unter BDC-Modellverwaltung. Weitere Informationen zum Festlegen der Sicherheitsberechtigungen eines externen Inhaltstyps finden Sie unter Verwalten externer Inhaltstypen.

Hinweis

Verwenden Sie diese Einstellungen, um eine Lösung auf Ihrem lokalen SharePoint-Server zu debuggen. Weitere Informationen zum Konfigurieren von BDC-bezogenen Sicherheitseinstellungen auf einem SharePoint-Produktionsserver finden Sie unter Business Connectivity Services-Sicherheit (Übersicht).

Widerrufen von Modellen, die beschädigt werden

Wenn Sie den Debugger zum ersten Mal starten, stellt Visual Studio das gesamte Modell in SharePoint bereit. Danach aktualisiert Visual Studio das Modell in SharePoint jedes Mal mit allen Änderungen, die Sie zwischen Bereitstellungen vornehmen.

Es kann Situationen geben, in denen Sie möchten, dass Visual Studio das Modell vollständig aus SharePoint zurückzieht. Beispielsweise kann ein Modell beschädigt werden. Wenn Sie Ihr Modell noch mal in SharePoint bereitstellen möchten, legen Sie die Eigenschaft Inkrementelles Update des Modells auf False fest, und starten Sie dann den Debugger. Die Eigenschaft Inkrementelles Update wird im Fenster Eigenschaften angezeigt, wenn Sie den Knoten auswählen, der das Modell im BDC-Explorer darstellt. Standardmäßig lautet der Name des Modells BdcModel1.

Ändern der Bezeichnernamen von Entitäten im Modell

Wenn Sie den Namen eines Bezeichners ändern, nachdem Sie das Modell bereitgestellt haben, erhalten Sie möglicherweise einen Bereitstellungsfehler. Sie können diesen Fehler nicht beheben, indem Sie die Eigenschaft Inkrementelles Update des Modells auf False festlegen. Sie müssen das Modell manuell zurückziehen und dann die Lösung noch mal bereitstellen. Weitere Informationen finden Sie unter Problembehandlung bei SharePoint-Lösungen. Sie können diesen Fehler vermeiden, indem Sie die Eigenschaft Inkrementelles Update auf False festlegen, bevor Sie das Modell erstmalig bereitstellen.

Suchen der Dokumentation für BDC-Modellelemente

Visual Studio fügt dem Modell für jede Entität, Methode oder jedes andere Element, das Sie erstellen, ein XML-Element hinzu. Elementattribute werden als Eigenschaften im Fenster Eigenschaften angezeigt. Informationen zu den Elementen und Attributen, die Visual Studio beim Entwerfen des Modells generiert, finden Sie unter BDCMetadata-Schema.

Titel BESCHREIBUNG
Übersicht über BDC-Modelldesigntools Beschreibt die Tools, mit denen Sie ein Modell für das BDC visuell entwerfen können.
Vorgehensweise: Hinzufügen einer Entität zu einem Modell Zeigt, wie Sie dem Modell externe Inhaltstypen oder Entitäten hinzufügen.
Vorgehensweise: Hinzufügen einer Finder-Methode Zeigt, wie Sie eine Methode hinzufügen, mit der Benutzer*innen eine Liste von Entitäten in einer Liste oder einem Webpart anzeigen können.
Vorgehensweise: Hinzufügen einer bestimmten Finder-Methode Zeigt, wie Sie eine Methode hinzufügen, mit der Benutzer*innen die Details einer bestimmten Entität anzeigen können.
Vorgehensweise: Hinzufügen einer Creator-Methode Zeigt, wie Sie eine Methode hinzufügen, mit der Benutzer*innen Datensätze direkt aus einer Liste oder einem Webpart zu einer Datenquelle hinzufügen können.
Vorgehensweise: Hinzufügen einer Deleter-Methode Zeigt, wie Sie eine Methode hinzufügen, mit der Benutzer*innen Daten aus einer Datenquelle mithilfe von Optionen in der Benutzeroberfläche einer Liste oder eines Webparts entfernen können.
Vorgehensweise: Hinzufügen einer Updater-Methode Zeigt, wie Sie eine Methode hinzufügen, mit der Benutzer*innen Datensätze in einer Datenquelle direkt aus einer Liste oder einem Webpart ändern können.
Vorgehensweise: Hinzufügen eines Parameters zu einer Methode Zeigt, wie Sie das Fenster „Methodendetails“ in Visual Studio verwenden, um einer Methode Eingabe- und Rückgabeparameter hinzuzufügen.
Vorgehensweise: Definieren des Typdeskriptors eines Parameters Zeigt, wie Sie Parameterdatentypen im Modell definieren.
Gewusst wie: Definieren einer Methodeninstanz Zeigt, wie Sie eine Instanz einer Methode erstellen, die vom BDC ausgeführt wird.
Vorgehensweise: Hinzufügen eines Filterdeskriptors zu einer Finder-Methode Zeigt, wie Sie Benutzerinnen und Benutzern das Einschränken der Anzahl von Instanzen ermöglichen, die von einer Finder-Methode zurückgegeben werden.
Erstellen einer Assoziation zwischen Entitäten Beschreibt, wie Sie Beziehungen zwischen Entitäten im Modell definieren können. Geschäftsdatenwebparts, externe Listen und benutzerdefinierte Anwendungen können diese Datenbeziehungen in einer Benutzeroberfläche anzeigen.
Vorgehensweise: Erstellen einer Zuordnung zwischen Entitäten Zeigt, wie Beziehungen zwischen Entitäten im Modell definiert werden.
Exemplarische Vorgehensweise: Erstellen einer externen Liste in SharePoint mithilfe von Geschäftsdaten Enthält Schritt-für-Schritt-Anweisungen, die Ihnen zeigen, wie Sie ein Modell erstellen und testen, das Kontakte in einer externen SharePoint-Liste anzeigt.
Integrieren von Geschäftsdaten in SharePoint Bietet eine Übersicht über das Erstellen und Entwerfen von Modellen für den BDC-Dienst.