Exemplarische Vorgehensweise: Modul 1 – Senden und Empfangen von Nachrichten mit dem Windows SharePoint Services-Adapter

In dieser exemplarischen Vorgehensweise erfahren Sie, wie Sie Windows SharePoint Services und BizTalk Server konfigurieren, damit Sie eine Nachricht mithilfe des Windows SharePoint Services-Adapters und inhaltsbasiertem Routing (CBR) senden und empfangen können. Das inhaltsbasierte Routing macht das Abonnement von Nachrichten überflüssig, die deterministisch an bestimmte Ports gebunden sind. Es bietet darüber hinaus Benutzern zusätzliche Flexibilität, die Nachrichten basierend auf Umschlageigenschaften oder auf Konfigurationseigenschaften des Empfangsports weiterleiten möchten. Eine Einführung in den Windows SharePoint Services-Adapter finden Sie unter Was ist der Windows SharePoint Services-Adapter?.

Voraussetzungen

Zur Durchführung der Verfahren in diesem Thema müssen die folgenden Voraussetzungen erfüllt sein:

• Sie benötigen eine Einzelserverbereitstellung mit einer vollständigen Installation von BizTalk Server, die unter Windows Server 2008 SP2 oder Windows Server 2008 R2 ausgeführt werden.

  Informationen zur Verwendung des Windows SharePoint Services-Adapters in einer Multiserverbereitstellung finden Sie unter Einrichten und Bereitstellen des Windows SharePoint Services-Adapters.

Konfigurieren von Windows SharePoint Services

Nachfolgend erstellen Sie eine SharePoint-Website auf oberster Ebene, die drei Dokumentbibliotheken enthält. Der Windows SharePoint Services-Adapter verwendet diese Bibliotheken zum Verschieben einer Nachricht aus einer Quellbibliothek in eine Zielbibliothek. Diese Nachricht wird außerdem in einer Dokumentbibliothek archiviert. Diese Schritte müssen zum Bereitstellen der Windows SharePoint Services-Website, auf die der Windows SharePoint Services-Adapter in dieser exemplarischen Vorgehensweise zugreift, und zum Festlegen von Benutzerrechten zum Aktivieren des Zugriffs auf diese Website erfolgen.

Erstellen einer Windows SharePoint Services-Website

1. Klicken Sie auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf Verwaltung, und klicken Sie dann auf SharePoint-Zentraladministration.

2. Klicken Sie unter Konfiguration virtueller Server auf Website der obersten Ebene erstellen.

3. Wählen Sie unter Liste virtueller Server die Website aus, auf der Sie den Windows SharePoint Services Adapter installiert haben. Beispiel: Default Web Site.

4. Geben Sie im Abschnitt Websiteadresse im Feld URL-Name den Namen ein WSSAdapterWalkthrough.

5. Geben Sie im Abschnitt Besitzer der Websitesammlung im Feld Benutzername einen Benutzernamen ein. Dieser Benutzer ist der Besitzer der Website und benötigt keine besonderen Berechtigungen in BizTalk Server.

6. Geben Sie im Abschnitt Besitzer der Websitesammlung im Feld E-Mail eine E-Mail-Adresse ein.

7. Klicken Sie auf OK.

8. Klicken Sie auf der Seite Website auf oberster Ebene erfolgreich erstellt auf die neue Website der obersten Ebene, die Sie gerade erstellt haben. Beispiel: http://<server_name>/sites/WSSAdapterWalkthrough.

9. Wählen Sie die Teamwebsitevorlage aus der Liste der Vorlagen aus, und klicken Sie dann auf OK. Die Startseite der Teamwebsite wird geöffnet.

Erstellen einer Quelldokumentbibliothek

1. Klicken Sie auf der Startseite der Teamwebsite in der oberen Navigationsleiste auf Erstellen.

2. Klicken Sie unter Dokumentbibliotheken auf Dokumentbibliothek.

3. Geben Sie im Abschnitt Name und Beschreibung im Feld Name den Namen ein Source.

4. Wählen Sie im Abschnitt Navigationdie Option Ja aus, um diese Formularbibliothek auf der Schnellstartleiste anzuzeigen.

5. Wählen Sie im Abschnitt Dokumentvorlage in der Dropdownliste Dokumentvorlage die Option aus None.

6. Klicken Sie auf Erstellen. Die Dokumentbibliothek wird erstellt, und Sie werden zur leere Bibliothek umgeleitet.

Erstellen einer Zieldokumentbibliothek

1. Klicken Sie auf der Startseite der Teamwebsite in der oberen Navigationsleiste auf Erstellen.

2. Klicken Sie unter Dokumentbibliotheken auf Dokumentbibliothek.

3. Geben Sie im Abschnitt Name und Beschreibung im Feld Name den Namen ein Destination.

4. Wählen Sie im Abschnitt Navigationdie Option Ja aus, um diese Formularbibliothek auf der Schnellstartleiste anzuzeigen.

5. Wählen Sie im Abschnitt Dokumentvorlage in der Dropdownliste Dokumentvorlage die Option aus None.

6. Klicken Sie auf Erstellen. Die Dokumentbibliothek wird erstellt, und Sie werden zur leere Bibliothek umgeleitet.

Erstellen einer Archivdokumentbibliothek

1. Klicken Sie auf der Startseite der Teamwebsite in der oberen Navigationsleiste auf Erstellen.

2. Klicken Sie unter Dokumentbibliotheken auf Dokumentbibliothek.

3. Geben Sie im Abschnitt Name und Beschreibung im Feld Name den Namen ein Archive.

4. Wählen Sie im Abschnitt Navigationdie Option Ja aus, um diese Formularbibliothek auf der Schnellstartleiste anzuzeigen.

5. Wählen Sie im Abschnitt Dokumentvorlage in der Dropdownliste Dokumentvorlage die Option aus None.

6. Klicken Sie auf Erstellen. Die Dokumentbibliothek wird erstellt, und Sie werden zur leere Bibliothek umgeleitet.

7. Schließen Sie die WSSAdapterWalkthrough Website.

8. Schließen Sie die SharePoint-Zentraladministrationswebsite .

Konfigurieren der Windows-Sicherheit

1. Klicken Sie auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf Verwaltung, und klicken Sie dann auf Computerverwaltung.

2. Erweitern Sie in der Konsolenstruktur Lokale Benutzer und Gruppen, und klicken Sie dann auf Gruppen.

3. Klicken Sie mit der rechten Maustaste auf die Gruppe SharePoint-aktivierte Hosts , klicken Sie auf Zu Gruppe hinzufügen, und klicken Sie dann auf Hinzufügen.

4. Geben Sie im Dialogfeld Benutzer, Computer oder Gruppen auswählen unter Geben Sie die zu wählenden Objektnamen ein, den Namen des Kontos ein, unter dem Sie die BizTalk Server Hostinstanz für die Ausführung konfiguriert haben, und klicken Sie dann auf OK.

5. Erweitern Sie in der Konsolenstruktur Dienste und Anwendungen, und klicken Sie dann auf Dienste.

6. Klicken Sie mit der rechten Maustaste auf BizTalk Service BizTalk Group: <BizTalk_Host_Name>, und klicken Sie dann auf Neu starten.

   Hinweis

   <> BizTalk_Host_Name ist der Name Ihres Hosts. Standardmäßig ist BizTalkServerApplicationdies .

   Hinweis

   Die Mitgliedschaft wird erst nach dem Neustart des Dienst aktiviert.

7. Schließen Sie die Computerverwaltung.

Konfigurieren der SharePoint-Sicherheit

1. Öffnen Sie einen Webbrowser, und navigieren Sie zur URL der website, die Sie erstellt haben. Beispiel: http://<server_name>/sites/WSSAdapterWalkthrough.

2. Klicken Sie auf der Startseite der Teamwebsite in der oberen Navigationsleiste auf Websiteeinstellungen.

3. Klicken Sie unter Verwaltung auf Benutzer verwalten.

4. Klicken Sie auf Benutzer hinzufügen.

5. Geben Sie in Schritt 1: Benutzer den Namen des Kontos ein, unter dem die BizTalk Server Hostinstanz ausgeführt wird.

6. Aktivieren Sie in Schritt 2: Websitegruppen die Kontrollkästchen Leser und Mitwirkender.

7. Klicken Sie auf Weiter.

8. Deaktivieren Sie das Kontrollkästchen Folgende E-Mail senden, damit diese Benutzer jetzt hinzugefügt wurden , und klicken Sie dann auf Fertig stellen.

9. Schließen Sie die WSSAdapterWalkthrough Website.

Erstellen und Konfigurieren der BizTalk Server-Ports

In diesem Verfahren erstellen und konfigurieren Sie die BizTalk Server Empfangensports, Empfangsorte und Sendeports für den Windows SharePoint Services-Adapter. Diese Ports sind Einstiegspunkte in und aus BizTalk Server für Dokumente, die vom Windows Sharepoint Services-Adapter empfangen und gesendet werden.

Erstellen des Empfangsports

1. Klicken Sie auf Start, Alle Programme, Microsoft BizTalk Server 20xx, und klicken Sie dann auf BizTalk Server Verwaltung.

2. Erweitern Sie BizTalk Server Verwaltung, erweitern Sie BizTalk-Gruppe, Erweitern Sie Anwendungen, erweitern Sie BizTalk-Anwendung 1, klicken Sie mit der rechten Maustaste auf Empfangsports, klicken Sie auf Neu, und klicken Sie dann auf Unidirektionale Empfangsport...

3. Geben FromSource Sie im Dialogfeld Eigenschaften des Empfangsports unter Allgemein in das Feld Name ein.

4. Klicken Sie auf OK.

Erstellen des Empfangsspeicherorts

1. Klicken Sie in der BizTalk-Verwaltungskonsole mit der rechten Maustaste auf den Knoten Empfangsstandorte , klicken Sie auf Neu, und klicken Sie dann auf Unidirektionale Empfangsadresse.

2. Wählen Sie im Dialogfeld Empfangsport auswählen die Option aus FromSource, und klicken Sie dann auf OK.

3. Geben SourceLocation Sie im Dialogfeld Eigenschaften des Empfangsspeicherorts unter Allgemein in das Feld Name ein.

4. Wählen Sie im Abschnitt Transport in der Dropdownliste Typ die Option aus Windows``SharePoint``Services.

5. Klicken Sie auf Konfigurieren, um die Windows SharePoint Services Adaptereigenschaften zu konfigurieren.

6. Geben Sie in der Eigenschaft Adapter-Webdienstport die Portnummer des virtuellen Servers ein, auf dem der Windows SharePoint Services-Adapterwebdienst installiert wurde. Standardmäßig ist dies Port 80.

7. Geben Sie Archive die Eigenschaft Archive Location ein.

8. Geben Sie 10 in die Eigenschaft Polling Interval ein .

9. Geben Sie die URL zu Ihrer SharePoint-Website in die Eigenschaft SharePoint Site URL ein. Beispiel: http://<server_name>/sites/WSSAdapterWalkthrough.

10. Geben Sie Source für die Eigenschaft Quelldokumentbibliothek ein .

11. Klicken Sie auf OK.

12. Wählen Sie BizTalkServerApplication im Dialogfeld Eigenschaften des Empfangsspeicherorts als Empfangshandler aus.

13. Wählen Sie in der Dropdownliste Empfangspipeline die Option aus PassThruReceive.

14. Klicken Sie auf OK.

Erstellen des Sendeports

1. Klicken Sie in der BizTalk-Verwaltungskonsole mit der rechten Maustaste auf den Knoten Sendeports , klicken Sie auf Neu und dann auf Statischer unidirektionale Sendeport.

2. Geben SendToDestination Sie im Dialogfeld Porteigenschaften senden unter Allgemein in das Feld Name ein.

3. Wählen Sie im Abschnitt Transport die Option Windows SharePoint Services für den Typ aus.

4. Klicken Sie auf Konfigurieren, um die eigenschaften des Windows SharePoint Services adapters zu konfigurieren.

5. Geben Sie in der Eigenschaft Adapterwebdienstport die Portnummer des virtuellen Servers ein, auf dem der Windows SharePoint Services-Adapterwebdienst installiert wurde. Standardmäßig ist dies Port 80.

6. Geben Sie für Destination die Eigenschaft Zielordner ein.

7. Geben Sie für PurchaseOrder1-%MessageID%.xml die Filename-Eigenschaft ein.

8. Legen Sie die Overwrite-Eigenschaft auf fest Yes.

9. Geben Sie die URL zu Ihrer SharePoint-Website in der SharePoint-Website-URL-Eigenschaft ein. Beispiel: http://<server_name>/sites/WSSAdapterWalkthrough.

10. Legen Sie die Microsoft Office-Integrationseigenschaft auf fest No.

11. Klicken Sie auf OK.

12. Wählen Sie im Dialogfeld Porteigenschaften senden in der Dropdownliste Sendehandler die Option aus BizTalkServerApplication.

13. Wählen Sie in der Dropdownliste Pipeline senden die Option aus PassThruTransmit.

14. Klicken Sie auf die Registerkarte Filter.

15. Wählen Sie im Feld Eigenschaft die OptionWSS.InListName aus.

16. Wählen Sie im Feld Operator die Option == aus.

17. Geben Sie Source im Feld Wert ein.

18. Klicken Sie auf OK.

Aktivieren des Empfangsspeicherorts und Starten des Empfangsports

Nachfolgend wird erklärt, wie Sie den Empfangsspeicherort aktivieren und den Empfangsport starten. Diese Schritte müssen ausgeführt werden, damit der Windows SharePoint Services-Adapter mithilfe des angegebenen Sendeports und Empfangsspeicherorts Nachrichten senden und empfangen kann.

Aktivieren des Empfangsspeicherorts

1. Klicken Sie in der BizTalk-Verwaltungskonsole auf den Knoten Empfangsspeicherorte .

2. Klicken Sie mit der rechten Maustaste auf SourceLocation, und klicken Sie dann auf Aktivieren.

Starten des Sendeports

1. Klicken Sie in der BizTalk-Verwaltungskonsole auf den Knoten Ports senden .

2. Klicken Sie mit der rechten Maustaste auf SendToDestination, und klicken Sie dann auf Start.

3. Schließen Sie die BizTalk-Verwaltungskonsole.

Senden einer Nachricht über das System

Nachfolgend erstellen Sie ein XML-Dokument, das Sie auf die Windows SharePoint Services-Website hochladen. Der Windows SharePoint Services-Adapter übernimmt diese Nachricht, archiviert Sie in der Dokumentbibliothek "Archiv" und sendet sie anschließend an die Dokumentbibliothek "Ziel". Dieses Verfahren veranschaulicht, wie ein Dokument mithilfe des Windows Sharepoint Services-Adapters von einer SharePoint-Website über BizTalk Server zu einer Sharepoint Services-Website fließt.

Erstellen eines Arbeitsverzeichnisses

• Erstellen Sie auf Ihrem Computer ein Verzeichnis mit dem Namen WSSAdapterWalkthrough. Beispiel: C:\WSSAdapterWalkthrough.

Erstellen einer XML-Datei

1. Klicken Sie auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf Zubehör, und klicken Sie dann auf Editor.

2. Geben Sie folgenden Pfad ein:

   <?xml version="1.0"?>  
   <PurchaseOrder>  
       <ID>1001</ID>  
       <FirstName>John</FirstName>  
       <LastName>Doe</LastName>  
       <Amount>750</Amount>  
   </PurchaseOrder>  
   

3. Speichern Sie die Datei in Ihrem Arbeitsverzeichnis als PurchaseOrder1.xml. Beispiel: C:\WSSAdapterWalkthrough\PurchaseOrder1.xml.

Hochladen der XML-Datei

1. Öffnen Sie einen Webbrowser, und wechseln Sie zur URL der zuvor erstellten Website. Beispiel: http://<server_name>/sites/WSSAdapterWalkthrough.

2. Klicken Sie auf der linken Seite unter Dokumente auf Quelle.

3. Klicken Sie auf Dokument hochladen.

4. Geben Sie im Feld Name die XML-Datei ein, die Sie oben erstellt haben, oder navigieren Sie zu dieser Datei. Beispiel: C:\WSSAdapterWalkthrough\PurchaseOrder1.xml, und klicken Sie dann auf Speichern und Schließen. Die Datei sollte jetzt in der Liste angezeigt werden.

5. Aktualisieren Sie das Browserfenster. Die PurchaseOrder1.xml Datei wird in dieser Bibliothek nicht mehr aufgeführt.

   Hinweis

   Sie müssen das Browserfenster ggf. mehrmals aktualisieren, da das Abrufintervall auf 10 Sekunden festgelegt ist.

6. Klicken Sie in der oberen Navigationsleiste auf Dokumente und Listen.

7. Klicken Sie unter Dokumentbibliotheken auf Ziel.

8. Ihre Nachricht wird nun in der Dokumentbibliothek Ziel aufgeführt. Außerdem finden Sie in der Dokumentbibliothek Archiv eine archivierte Kopie.

   Hinweis

   Wenn die Meldung nicht in der Zieldokumentbibliothek angezeigt wird, finden Sie weitere Informationen unter Problembehandlung für den Windows SharePoint Services-Adapter in BizTalk Server Hilfe.

Zusammenfassung

In dieser exemplarischen Vorgehensweise haben Sie erfahren, wie Sie Windows SharePoint Services und BizTalk Server konfigurieren, damit Sie mithilfe des Windows SharePoint Services-Adapters und des inhaltsbasierten Routings (CONTENT-Based Routing, CBR) eine Nachricht senden und empfangen können.

Nächste Schritte

Nachdem Sie diese exemplarische Vorgehensweise abgeschlossen haben, führen Sie die exemplarische Vorgehensweise :Modul 2 – Integrieren von Office in den Windows SharePoint Services Adapter aus, die die Arbeit, die Sie mit dieser exemplarischen Vorgehensweise erledigt haben, erweitert und zeigt, wie Sie Office in den Windows SharePoint Services-Adapter integrieren.

Weitere Informationen

Was ist der Windows SharePoint Services-Adapter?
Windows SharePoint Services-Adapter – Exemplarische Vorgehensweisen