Freigeben über

Entwerfen eines Geschäftsdatenkonnektivitätsmodells

Sie können ein Modell für den Business Data Connectivity (BDC)-Dienst 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. 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 How to: Add an entity to a model.

Definieren Sie die Felder der Entität in einer Klasse. Sie können z. B. ein Feld mit dem Namen Address einer Customer Klasse hinzufügen. Sie können dem Projekt entweder eine neue Klasse hinzufügen oder eine vorhandene Klasse verwenden, die mit anderen Tools wie dem Objektrelational-Designer (O/R Designer) erstellt wurde. Der Name der Entität und der Name der Klasse, die die Entität darstellt, müssen nicht übereinstimmen. Sie beziehen die Klasse auf die 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 Informationen in einer Liste oder einem Webpart anzeigen, hinzufügen, aktualisieren oder löschen, die auf Ihrem Modell basieren. Sie müssen dem Modell für jede Aufgabe, die der Benutzer ausführen kann, eine Methode hinzufügen. Erstellen Sie Methoden, indem Sie einen der fünf grundlegenden Methodentypen aus dem Fenster "Details der BDC-Methode " auswählen. In der folgenden Tabelle werden die fünf grundlegenden Methoden eines BDC-Modells beschrieben.

Methode Description
Finder Gibt eine Auflistung von Entitätsinstanzen zurück. Wird aufgerufen, wenn der Benutzer die Liste oder das Webpart öffnet. Weitere Informationen finden Sie unter So fügen Sie eine Finder-Methode hinzu.
Spezifische Suchfunktion Gibt eine bestimmte Entitätsinstanz zurück. Wird aufgerufen, wenn ein Benutzer die Details eines bestimmten Elements in einer Liste anzeigt. Weitere Informationen finden Sie unter So fügen Sie eine spezifische Finder-Methode hinzu.
Schöpfer Fügt der Datenquelle einer Entität neue Daten hinzu. Wird aufgerufen, wenn Benutzer die Schaltfläche " Neues Element " im Menüband einer Liste auswählen, die auf dem Modell basiert. Weitere Informationen finden Sie unter Wie man eine Erstellermethode hinzufügt.
Aktualisierer Ändert die Daten in einer Liste. Wird aufgerufen, wenn Benutzer Informationen in einer Liste aktualisieren. Weitere Informationen finden Sie unter So fügen Sie eine Updater-Methode hinzu.
Löscher Entfernt Daten. Wird aufgerufen, wenn Benutzer ein Element aus der Liste löschen. Weitere Informationen finden Sie unter So geht's: Eine Löschmethode hinzufügen.

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 übergeben oder den richtigen Datentyp zurückgeben. Eine Finder-Methode gibt z. B. standardmäßig eine Zeichenfolge zurück. In den meisten Fällen möchten Sie den Rückgabeparameter der Finder-Methode so ändern, dass er eine Auflistung von Entitäten zurückgibt. Sie können dies erreichen, indem Sie den Typdeskriptor des Parameters ändern. Ein Typdeskriptor ist eine Sammlung von Attributen, die den Datentyp eines Parameters beschreiben. Weitere Informationen finden Sie unter Vorgehensweise: Definieren des Typdeskriptors eines Parameters.

Mit Visual Studio können Sie Typdeskriptoren zwischen Parametern im Modell kopieren. Beispielsweise können Sie einen Typdeskriptor definieren, der für den Rückgabeparameter der CustomerTD Methode benannt GetCustomer ist. Sie können den CustomerTD Typdeskriptor im BDC-Explorer kopieren und diesen Typdeskriptor dann in den Eingabeparameter der CreateCustomer Methode einfügen. Dadurch wird 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: Den Typ-Deskriptor eines Parameters definieren.

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

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

Hinzufügen von Filterdeskriptoren

Nutzer des Modells möchten möglicherweise Instanzen einer Entität abrufen, die einigen Kriterien entsprechen. Um diese Funktionalität zu aktivieren, können Sie einer Methode einen Filterdeskriptor hinzufügen. Filterdeskriptoren ermöglichen Modellanwendern das Filtern von Methodenergebnissätzen, indem Werte an Methoden übergeben werden, bevor sie ausgeführt werden. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen von Filterparametern zu Operationen, um Instanzen aus dem externen System zu beschränken.

SharePoint bietet mehrere Features, mit denen Benutzer Filterwerte bereitstellen können. Beispielsweise stellen Geschäftsdaten-Webparts ein Filtertextfeld bereit. Benutzer 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 How to: Add a filter descriptor to a Finder method.

Filter-Deskriptoreigenschaften

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

Die Associated Type Descriptor-Eigenschaft verbindet den Filterdeskriptor mit einem Eingabeparameter. Wenn ein Benutzer einen Filterwert bereitstellt, ü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 ausgewählte Filtermuster auf den Text aus, der auf der Benutzeroberfläche angezeigt wird. Zum Beispiel erscheint bei einem Vergleichsfiltermuster der Text ist gleich als Steuerung über einem Business-Daten-Webpart. Weitere Informationen zu den einzelnen Filtermustern finden Sie unter Typen von Filtern, die vom BDC unterstützt werden.

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

Bereitstellen von Standardwerten

In einigen Fällen stellt der Benutzer möglicherweise keinen Filterwert bereit. Sie können einen Standardwert bereitstellen, indem Sie der Methodeninstanz einen Standardwert hinzufügen oder den Standardwert im Code Der Methode festlegen. Weitere Informationen zum Hinzufügen eines Standardwerts zur Methodeninstanz finden Sie unter "MethodInstance". Ein Beispiel zum Festlegen des Standardwerts eines Eingabeparameters im Code der Methode finden Sie unter How to: Add a filter descriptor to a Finder method.

Überprüfen des Modells

Sie können Ihr Modell während der Entwicklung überprüfen. Visual Studio identifiziert Probleme, die verhindern können, dass Ihr Modell erwartungsgemäß angezeigt wird. Diese Probleme werden in der Visual Studio-Fehlerliste 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 sie in der Fehlerliste angezeigt. Sie können den Cursor schnell in den Code verschieben, der einen Fehler enthält, indem Sie in der Liste auf den Fehler doppelklicken. Alternativ können Sie die F8 - oder UMSCHALTTASTE+F8 wiederholt auswählen, um die Fehler in der Liste vorwärts oder rückwärts zu durchlaufen.

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

Debuggen der Lösung, die das Modell enthält

Sie können Ihren Code so debuggen, wie Sie beliebigen Code in Visual Studio debuggen würden. Um Den Code zu debuggen, legen Sie Haltepunkte an einer beliebigen Stelle im Code fest, und starten Sie dann den Debugger. Visual Studio öffnet die SharePoint-Website. Erstellen Sie in SharePoint eine Liste oder ein Webpart, die Ihre Geschäftsdaten verwendet. Anschließend können Sie Ihren Code schrittweise durchlaufen. Weitere Informationen zum Debuggen von SharePoint-Projekten finden Sie unter Problembehandlung für SharePoint-Lösungen.

Sie können code auch in benutzerdefinierten Assemblys debuggen, die Sie dem Projekt hinzufügen. Um Code in einer benutzerdefinierten Assembly zu debuggen, müssen Sie die Assembly jedoch dem Lösungspaket hinzufügen. Weitere Informationen finden Sie unter So fügen Sie zusätzliche Baugruppen hinzu und entfernen Sie sie.

Weitere Informationen zum Hinzufügen einer benutzerdefinierten Assembly zu Ihrem Projekt finden Sie unter How to: Include a custom assembly in a BDC feature.

Konfigurieren der BDC-Sicherheit

Möglicherweise müssen Sie Ihre Sicherheitseinstellungen in SharePoint ändern, bevor Sie Ihre Lösung debuggen können. Um diese Einstellungen zu ändern, öffnen Sie die Business Data Connectivity-Dienstanwendung auf der SharePoint 2010-Zentraladministrationswebsite. Fügen Sie im Dialogfeld "Berechtigungen für den Metadatenspeicher festlegen " Ihr Benutzerkonto hinzu, und wählen Sie dann eine der folgenden Optionen aus:

Aufgabe Option
So stellen Sie Modelle für den BDC-Dienst bereit. Bearbeiten
So erstellen Sie Listen und Webparts mithilfe externer Inhaltstypen (Entitäten) in Ihrem Modell. In Clients auswählbar
Zum Erstellen, Lesen, Aktualisieren und Löschen von Entitätsdaten Ausführen

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 Verwaltung 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 dem SharePoint-Produktionsserver finden Sie in der Sicherheitsübersicht zu Business Data Connectivity Services.

Zurückziehen von Modellen, die fehlerhaft sind

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

Es kann Situationen geben, in denen Visual Studio das Modell vollständig aus SharePoint zurückziehen soll. Beispielsweise kann ein Modell defekt werden. Wenn Sie Ihr Modell erneut in SharePoint bereitstellen möchten, legen Sie die Eigenschaft für das inkrementelle Update des Modells auf "False" fest, und starten Sie dann den Debugger. Die Eigenschaft "Inkrementelle Aktualisierung " wird im Eigenschaftenfenster angezeigt, wenn Sie den Knoten auswählen, der das Modell im BDC-Explorer darstellt. Standardmäßig lautet der Name des Modells BdcModel1.

Ändern von Bezeichnernamen von Entitäten im Modell

Wenn Sie den Namen eines Bezeichners ändern, nachdem Sie das Modell bereitgestellt haben, wird möglicherweise ein Bereitstellungsfehler angezeigt. Sie können diesen Fehler nicht beheben, indem Sie die Eigenschaft "Inkrementelle Aktualisierung " des Modells auf "False" festlegen. Sie müssen das Modell manuell zurückziehen und dann die Lösung erneut bereitstellen. Weitere Informationen finden Sie unter Problembehandlung für SharePoint-Lösungen. Sie können diesen Fehler vermeiden, indem Sie die Eigenschaft "Inkrementelle Aktualisierung " auf "False" festlegen, bevor Sie das Modell anfänglich bereitstellen.

Suchen der Dokumentation für BDC-Modellelemente

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

Title Description
Übersicht über die BDC-Modellentwurfstools 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 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 die Details einer bestimmten Entität anzeigen können.
Gewusst wie: Hinzufügen einer Creator-Methode Zeigt, wie Sie eine Methode hinzufügen, mit der Benutzer Datensätze direkt aus einer Liste oder einem Webpart einer Datenquelle hinzufügen können.
Vorgehensweise: Hinzufügen einer Deleter-Methode Zeigt, wie Sie eine Methode hinzufügen, mit der Benutzer 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 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 Methodendetailseitefenster in Visual Studio verwenden, um einer Methode Eingabe- und Rückgabeparameter hinzuzufügen.
Vorgehensweise: Definieren des Typdeskriptors eines Parameters Zeigt, wie Parameterdatentypen im Modell definiert werden.
Vorgehensweise: 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 Benutzern das Einschränken der Anzahl von Instanzen ermöglichen, die von einer Finder-Methode zurückgegeben werden.
Erstellen einer Zuordnung 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 auf 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 schrittweise Anleitungen zum Erstellen und Testen eines Modells, 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.
  • Last updated on