Gewusst wie: Erstellen eines externen Inhaltstyps basierend auf einem Webdienst

Letzte Änderung: Mittwoch, 28. Juli 2010

Gilt für: SharePoint Server 2010

Der Designer für externe Inhaltstypen in Microsoft SharePoint Designer 2010 unterstützt das Erstellen von externen Inhaltstypen, die eine Verbindung mit Webdiensten herstellen. Sie können einfach Ihren Webdienst ermitteln, auf die Webmethoden verweisen, mit denen die gewünschten Vorgänge ausgeführt und die erforderlichen Daten zurückgegeben werden, und anschließend damit Ihren externen Inhaltstyp erstellen, ohne Code oder XML zu schreiben.

In diesem Thema erfahren Sie, wie Sie den externen Inhaltstyp Customer erstellen, der auf den Tabellen Person.Contact, Sales.Customer und Sales.Individual in der AdventureWorks SQL Server 2008-Beispieldatenbank basiert.

Voraussetzungen

• Ein Server mit Microsoft SQL Server 2008.

• Ein Server mit Microsoft SharePoint 2010

• Installation von Microsoft SharePoint Designer 2010 auf dem Clientcomputer

• Das mit diesem SDK bereitgestellte Codebeispiel: AdventureWorks2008 ASP.NET Web Service auf einem Webserver

Erstellen eines externen Inhaltstyps basierend auf einem Webdienst

SharePoint Designer 2010 benötigt eine SharePoint-Website zum Speichern der Dateien und Artefakte (z. B. externe Listen usw.), die beim Erstellen von externen Inhaltstypen mit Designer für externe Inhaltstypen generiert werden. Daher müssen Sie zuerst eine SharePoint-Website auf dem Server mit SharePoint Server erstellen, um die Artefakte des externen Inhaltstyps zu speichern, und sie auf dem Client in SharePoint Designer öffnen.

So definieren Sie die allgemeinen Einstellungen für externe Inhaltstypen

1. Öffnen Sie in SharePoint Designer 2010 die SharePoint-Website, in der Sie die Artefakte für den externen Inhaltstyp speichern möchten.

2. Klicken Sie im linken Navigationsbereich auf Externe Inhaltstypen.

3. Klicken Sie im kontextbezogenen Menüband für Entitäten auf Externer Inhaltstyp.

   Damit wird eine neue Seite Externer Inhaltstyp geöffnet.

4. Klicken Sie neben Name auf den Link Neuer externer Inhaltstyp, und geben Sie WSCustomer ein.

5. Klicken Sie neben Name auf den Link Anzeigename, und geben Sie WSCustomer ein.

6. Wählen Sie in der Dropdownliste Office-Elementtyp die Option Kontakt aus. In der folgenden Abbildung sind die allgemeinen Einstellungen für den externen Inhaltstyp dargestellt.

   

So fügen Sie dem externen System eine Verbindung hinzu

1. Klicken Sie auf Klicken Sie hier, um externe Datenquellen zur ermitteln und Vorgänge zu definieren.

2. Klicken Sie unter Externe Datenquellen auf die Schaltfläche Verbindung hinzufügen.

3. Wählen Sie im Dialogfeld Auswahl des externen Datenquellentyps wie in der folgenden Abbildung dargestellt die Option WCF-Dienst aus, und klicken Sie auf OK.

   

4. Geben Sie im Dialogfeld WCF-Verbindung, das geöffnet wird, im Feld Service-Metadaten-URL die URL zur WSDL des Webdiensts ein.

5. Geben Sie anschließend im Feld Service-Endpunkt-URL die URL zur ASMX-Seite ein.

6. Geben Sie den Namen AdventureWorksWS ein. In der folgenden Abbildung ist das Dialogfeld WCF-Verbindung dargestellt.

   

7. Behalten Sie für die restlichen Einstellungen die Standardeinstellungen bei, und klicken Sie auf OK.

Nachdem Sie die Verbindung mit der im vorherigen Schritt angegebenen Webdienstadresse überprüft haben, werden wie im Folgenden dargestellt im Fenster Datenquellen-Explorer im Bereich Vorgangs-Designer die Methoden der Webdienstdefinition aufgelistet.

So definieren Sie die unterstützten Vorgänge und deren Parameter und Filter

1. Erstellen Sie einen Erstellen-Vorgang.

   1. Klicken Sie mit der rechten Maustaste auf die CreateCustomer-Methode, und klicken Sie dann im Kontextmenü auf Neuer "Erstellen"-Vorgang. Der Erstellen-Assistent wird geöffnet.

   2. Klicken Sie im Erstellen-Assistenten auf Weiter, um den Standardnamen und die Anzeigenamenwerte für den Vorgang beizubehalten.

   3. Klicken Sie im Gruppenfeld Datenquellenelemente auf den CustomerID-Parameter.

   4. Aktivieren Sie wie im Folgenden dargestellt im Gruppenfeld Eigenschaften das Kontrollkästchen Zuzuordnender Bezeichner.

      

   5. Klicken Sie auf Weiter, um zur Seite für die Rückgabeparameterkonfiguration zu gelangen.

   6. Klicken Sie im Gruppenfeld Datenquellenelement e auf den CustomerID-Parameter.

   7. Aktivieren Sie im Gruppenfeld Eigenschaften das Kontrollkästchen Zuzuordnender Bezeichner.

   8. Klicken Sie auf die Schaltfläche Fertig stellen, um den Erstellen-Vorgang abzuschließen.

2. Erstellen Sie einen Element lesen-Vorgang.

   1. Klicken Sie im Datenquellen-Explorer mit der rechten Maustaste auf die GetCustomerById-Methode, und wählen Sie dann Neuer "Element lesen"-Vorgang im Kontextmenü aus. In diesem Kontextmenü werden alle von SharePoint Designer unterstützten Operationsstereotypen angezeigt.

      Der Assistent zum Lesen von Elementen wird geöffnet.

   2. Klicken Sie im Assistenten zum Lesen von Elementen auf Weiter, um den Standardnamen und die Anzeigenamenwerte für den Vorgang beizubehalten.

   3. Beachten Sie, dass auf der Seite für die Eingabeparameterkonfiguration im Gruppenfeld mit den Fehlermeldungen ein Fehler vorhanden ist. Sie müssen das Bezeichnerfeld für diesen externen Inhaltstyp identifizieren.

   4. Klicken Sie dazu im Gruppenfeld Datenquellenelemente auf das Feld CustomerId, und aktivieren Sie im Gruppenfeld Eigenschaften das Kontrollkästchen Zuzuordnender Bezeichner.

      Dadurch wird das ID-Feld als Bezeichner für diesen externen Inhaltstyp festgelegt, und nicht nur für diesen Parameter. Die Fehlermeldung wird nicht mehr angezeigt.

   5. Klicken Sie auf Weiter, um zur Seite für die Rückgabeparameterkonfiguration zu gelangen.

   6. Klicken Sie im Gruppenfeld Datenquellenelemente auf den CustomerID-Parameter.

   7. Aktivieren Sie im Gruppenfeld Eigenschaften das Kontrollkästchen Zuzuordnender Bezeichner. Beachten Sie, dass das Feld automatisch als schreibgeschützt gekennzeichnet wird.

   8. Im nächsten Schritt müssen Sie Felder wie LastName oder FirstName Outlook-Eigenschaften zuordnen. Wählen Sie jedes Feld aus, das einer vergleichbaren Outlook-Eigenschaft zugeordnet werden kann, und ordnen Sie es durch Auswählen des entsprechenden Felds im Feld mit den Office-Eigenschaften zu.

   9. Klicken Sie auf die Schaltfläche Fertig stellen, um den Element lesen-Vorgang abzuschließen.

3. Erstellen Sie einen Liste lesen-Vorgang.

   1. Klicken Sie mit der rechten Maustaste auf die GetCustomers-Methode, und klicken Sie dann im Kontextmenü auf Neuer "Liste lesen"-Vorgang.

      Der Assistent zum Lesen von Listen wird geöffnet.

   2. Klicken Sie im Assistenten zum Lesen von Listen auf Weiter, um den Standardnamen und die Anzeigenamenwerte für den Vorgang beizubehalten.

   3. Klicken Sie auf der Seite für die Eingabeparameterkonfiguration auf Weiter, um zur Seite für die Rückgabeparameterkonfiguration zu gelangen.

   4. Klicken Sie im Gruppenfeld Datenquellenelemente auf den CustomerID-Parameter.

   5. Aktivieren Sie in der Gruppe Eigenschaften das Kontrollkästchen Zuzuordnender Bezeichner.

   6. Wählen Sie das Feld Last Name aus, und aktivieren Sie das Kontrollkästchen In Auswahl anzeigen, damit das Feld LastName in der Auswahl für externe Datenelemente angezeigt wird. Wiederholen Sie diesen Schritt für FirstName.

   7. Klicken Sie auf Fertig stellen, um den Liste lesen-Vorgang abzuschließen.

      Nachdem Sie die Vorgänge Element lesen und Liste lesen erstellt haben, können Sie mithilfe dieses externen Inhaltstyps eine externe Liste erstellen.

      Vorgänge, die Sie für den externen Inhaltstyp erstellen, werden im Fenster Entwurfsansicht für Vorgänge im Bereich Vorgänge des externen Inhaltstyps angezeigt.

4. Erstellen Sie einen Aktualisieren-Vorgang.

   1. Klicken Sie mit der rechten Maustaste auf die UpdateCustomer-Methode, und klicken Sie dann im Kontextmenü auf Neuer "Aktualisieren"-Vorgang.

   2. Klicken Sie im Aktualisieren-Assistenten auf Weiter, um den Standardnamen und die Anzeigenamenwerte für den Vorgang beizubehalten.

   3. Klicken Sie im Gruppenfeld Datenquellenelemente auf den CustomerID-Parameter.

   4. Aktivieren Sie im Gruppenfeld Eigenschaften das Kontrollkästchen Zuzuordnender Bezeichner.

      Lassen Sie die anderen Parameter aktiviert.

   5. Klicken Sie auf Fertig stellen, um den Aktualisieren-Vorgang abzuschließen.

Damit haben Sie die grundlegenden Vorgänge für den externen Inhaltstyp Customer erstellt.

So speichern Sie den externen Inhaltstyp

• Drücken Sie STRG+S, um den externen Inhaltstyp in BDC für die SharePoint-Website zu speichern.

Nun können Sie mit den Präsentationsfunktionen von Microsoft Business Connectivity Services (BCS) die externen Daten in Office 2010 und SharePoint 2010 anzeigen. In der folgenden Abbildung ist eine externe Liste basierend auf dem externen Inhaltstyp WSCustomer dargestellt.