Exemplarische Vorgehensweise: Modul 2 – Integrieren von Office mit dem Windows SharePoint Services-Adapter

Diese exemplarische Vorgehensweise ist eine Fortsetzung der exemplarischen Vorgehensweise: Modul 1 – Senden und Empfangen von Nachrichten mit dem Windows SharePoint Services Adapter und zeigt Ihnen, wie Sie Microsoft Office in die von Ihnen erstellte anwendung BizTalk Server inhaltsbasiertes Routing (CBR) integrieren. 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 Bereitstellung auf einem einzelnen Server mit einer vollständigen Installation von BizTalk Server.

• Sie müssen die folgende exemplarische Vorgehensweise ausführen: Exemplarische Vorgehensweise: Modul 1 – Senden und Empfangen von Nachrichten mit dem Windows SharePoint Services Adapter

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

Erstellen eines BizTalk-Projekts

In diesem Verfahren erstellen Sie mithilfe des BizTalk-Editors ein leeres BizTalk-Projekt und ein Schema. Dieses Verfahren ist erforderlich, um das Schema für das InfoPath-Formular zu erstellen, das später verwendet wird.

Erstellen einer Schlüsseldatei mit starkem Namen

1. Starten Sie die Visual Studio-Eingabeaufforderung.

2. Geben Sie ein sn -k C:\WSSAdapterWalkthrough\OrderProcess.snk, und drücken Sie dann die EINGABETASTE. Das Schlüsselpaar wird geschrieben.

3. Schließen Sie die Eingabeaufforderung.

Erstellen eines leeren BizTalk-Projekts

1. Starten Sie Microsoft Visual Studio.

2. Klicken Sie auf Datei, Neu und dann auf Projekt.

3. Wählen Sie unter Projekttypen die Option BizTalk-Projekte aus.

4. Wählen Sie unter Vorlagen die Option Leere BizTalk Server Projekt aus.

5. Geben Sie OrderProcess in das Feld Name ein.

6. Geben Sie im Feld Speicherort den Dateipfad zu Ihrem Arbeitsverzeichnis ein . Beispiel: C:\WSSAdapterWalkthrough\.

7. Klicken Sie auf OK.

Zuordnen der Schlüsseldatei zur Assembly

1. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf das OrderProcess Projekt, und klicken Sie dann auf Eigenschaften, um die Projekt-Designer zu starten.

2. Klicken Sie auf die Registerkarte Signierung.

3. Wählen Sie die Option Assembly signieren , klicken Sie in der Dropdownliste auf die Option Schlüsseldatei mit starkem Namen auswählen , und klicken Sie dann auf Durchsuchen.

4. Geben Sie C:\WSSAdapterWalkthrough\OrderProcess.snkein.

5. Klicken Sie auf Öffnen.

Erstellen eines XSD-Schemas mithilfe des BizTalk-Editors

1. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf das OrderProcess Projekt, klicken Sie auf Hinzufügen, und klicken Sie dann auf Neues Element.

2. Klicken Sie unter Kategorien auf Schemadateien.

3. Klicken Sie unter Vorlagen auf Schema.

4. Geben Sie OrderProcessSchema in das Feld Name ein, und klicken Sie dann auf Hinzufügen.

5. Wählen Sie im Eigenschaftenfenster für die OrderProcessSchemaElement FormDefault-Eigenschaft ausQualified.

6. Geben Sie im Eigenschaftenfenster für OrderProcessSchemain das Feld Zielnamespace ein.http://OrderProcess.PurchaseOrder

7. Klicken Sie im BizTalk-Editor mit der rechten Maustaste auf Root, klicken Sie auf Umbenennen, und geben Sie dann ein PurchaseOrder.

8. Klicken Sie mit der rechten Maustaste auf den Knoten PurchaseOrder , klicken Sie auf Schemaknoten einfügen, und klicken Sie dann auf Untergeordnetes Feldelement.

9. Nennen Sie es PurchaseOrderID.

10. Erstellen Sie ein weiteres untergeordnetes Feldelement, und nennen Sie es BillTo.

11. Erstellen Sie ein weiteres untergeordnetes Feldelement, und nennen Sie es Amount.

12. Legen Sie im Eigenschaftenfenster die Eigenschaft Datentyp für Amount auf xs:unsignedInt fest.

13. Erstellen Sie ein weiteres untergeordnetes Feldelement, und nennen Sie es PurchaseOrderDate.

14. Legen Sie im Eigenschaftenfenster die Eigenschaft Datentyp für PurchaseOrderDate auf xs:dateTime fest.

15. Klicken Sie auf Dateiund dann auf Alle speichern.

16. Schließen Sie Visual Studio.

Erstellen eines InfoPath-Formulars

In diesem Verfahren erstellen Sie eine weitere Dokumentbibliothek und ein InfoPath-Formular auf Grundlage des Schemas, das im letzten Verfahren erstellt wurde. Dieses InfoPath-Formular wird verwendet, um ein Dokument an BizTalk Server zu übermitteln.

Hinweis

Für diese exemplarische Vorgehensweise ist Microsoft Office InfoPath 2007 erforderlich.

Erstellen einer neuen Dokumentbibliothek

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 in der oberen Navigationsleiste auf Erstellen.

3. Klicken Sie unter Dokumentbibliotheken auf Dokumentbibliothek.

4. Geben Sie InfoPathSolutions im Abschnitt Name und Beschreibung in das Feld Name ein.

5. Wählen Sie im Abschnitt Navigation die Option Ja aus, um diese Formularbibliothek auf der Schnellstartleiste anzuzeigen.

6. Wählen Sie im Abschnitt Dokumentvorlage die Option NoneDokumentvorlage aus.

7. Klicken Sie auf Erstellen. Sie werden zu der gerade erstellten, leeren Bibliothek weitergeleitet.

8. Klicken Sie auf der linken Seite auf Einstellungen und Spalten ändern.

9. Klicken Sie unter Spalten auf Neue Spalte hinzufügen.

10. Geben Sie Namespace unter Name und Typ in das Feld Name ein.

11. Klicken Sie auf OK.

12. Schließen Sie die WSSAdapterWalkthrough Website.

Erstellen eines InfoPath-Formulars auf Grundlage der Schemadatei „OrderProcessSchema“

1. Klicken Sie auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf Microsoft Office, und klicken Sie dann auf Microsoft Office InfoPath 2007.

2. Wählen Sie im Dialogfeld Formular ausfüllen die Option Formular entwerfen aus.

3. Wählen Sie im Aufgabenbereich Formular entwerfen die Option Neu aus XML-Dokument oder -Schema aus.

4. Klicken Sie im Datenquellen-Assistenten auf Durchsuchen , und wählen Sie die Schemadatei aus, die Sie im letzten Verfahren erstellt haben. Beispiel: C:\WSSAdapterWalkthrough\OrderProcess\OrderProcess\OrderProcessSchema.xsd.

5. Klicken Sie auf Weiterund dann auf Fertig stellen.

6. Klicken Sie im Aufgabenbereich Datenquelle mit der rechten Maustaste auf den Knoten PurchaseOrder , und klicken Sie dann auf Abschnitt mit Steuerelementen. Hierdurch wird das Formular in der Vorlage erstellt.

7. Klicken Sie auf Datei, klicken Sie auf Speichern, und klicken Sie dann auf Speichern.

8. Geben PurchaseOrder.xsn Sie im Dialogfeld Speichern unter das Feld Dateiname ein, und klicken Sie dann auf Speichern.

9. Klicken Sie auf Datei und dann auf Veröffentlichen.

10. Klicken Sie im Veröffentlichungs-Assistenten auf Weiter.

11. Wählen Sie Zu einem Webserver aus, und klicken Sie dann auf Weiter.

12. Geben Sie den Pfad und Dateinamen ihrer InfoPathSolutions Dokumentbibliothek ein, und klicken Sie dann auf Weiter. Beispiel: http://<server_name>/sites/WSSAdapterWalkthrough/InfoPathSolutions/PurchaseOrder.xsn.

13. Klicken Sie auf Fertig stellen und anschließend auf Schließen.

14. Schließen Sie Microsoft InfoPath.

Ändern der SharePoint-Dokumentbibliotheken

In diesem Verfahren aktualisieren Sie die Namespace-Eigenschaft der Datei PurchaseOrder.xsn und ändern die Zieldokumentbibliothek. Dieser Namespace wird in inhaltsbasierten Routingszenarios beim Bestimmen von Abonnenten veröffentlichter Dokumente als Variable verwendet.

Aktualisieren des Namespace für „PurchaseOrder.xsn“

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 linken Seite unter Dokumente auf InfoPathSolutions.

3. Bewegen Sie den Zeiger über PurchaseOrder.xsn, klicken Sie mit der rechten Maustaste darauf, und klicken Sie dann auf Eigenschaften bearbeiten.

4. Geben Sie http://OrderProcess.PurchaseOrder das Feld Namespace ein, und klicken Sie dann auf Speichern und Schließen.

Ändern der Zieldokumentbibliothek

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

2. Klicken Sie unter Dokumentbibliotheken auf Ziel.

3. Klicken Sie auf der linken Seite auf Einstellungen und Spalten ändern.

4. Klicken Sie unter Spalten auf Neue Spalte hinzufügen.

5. Geben Sie Partner Name unter Name und Typ in das Feld Spaltenname ein.

6. Klicken Sie auf OK.

7. Schließen Sie die WSSAdapterWalkthrough Website.

Ändern des Sendeports aus der exemplarischen Vorgehensweise 1

In diesem Verfahren ändern Sie den Sendeport aus der exemplarischen Vorgehensweise 1. Dieses Verfahren ist erforderlich, um sicherzustellen, dass das in dieser exemplarischen Vorgehensweise verarbeitete Dokument richtig an den Sendeport weitergeleitet wird.

Ändern des Sendeports

1. Öffnen Sie BizTalk Server Verwaltung.

2. Erweitern Sie Microsoft BizTalk Server-Verwaltung, BizTalk-Gruppe, Anwendungen, BizTalk-Anwendung 1, und klicken Sie dann auf den Knoten Ports senden.

3. Klicken Sie mit der rechten Maustaste auf SendToDestination, und klicken Sie dann auf Eigenschaften.

4. Klicken Sie unter Transport auf Konfigurieren.

5. Geben Sie im Feld Dateiname ein PurchaseOrder2-%XPATH=//pons:PurchaseOrder/pons:PurchaseOrderID%.xml.

6. Geben Sie im Feld Namespacealiases einpons="http://OrderProcess.PurchaseOrder".

7. Geben Sie in der Vorlagendokumentbibliothek den Namen ein InfoPathSolutions.

8. Geben Sie in der Spalte Vorlagennamespace ein Namespace.

9. Wählen Sie für die Microsoft Office-Integrationseigenschaft ausYes.

10. Geben Sie Partner Nameunter Windows SharePoint Services Integration in das Feld Spalte 01 ein.

11. Geben Sie %XPATH=//pons:PurchaseOrder/pons:BillTo% in das Feld Spaltenwert 01 ein, klicken Sie auf OK, und klicken Sie dann erneut auf OK , um das Dialogfeld Porteigenschaften senden zu beenden.

Erneutes 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 Eintrag aufheben.

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

4. Schließen Sie die BizTalk-Verwaltungskonsole.

Senden einer Nachricht durch das System

In diesem Verfahren erstellen Sie ein InfoPath-Formular und laden es auf die Windows SharePoint Services-Website hoch. 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 von einer Sharepoint-Website über BizTalk Server und mithilfe des Windows Sharepoint Services-Adapters zu einer Sharepoint Services-Website fließt.

Erstellen eines InfoPath-Formulars zum Senden durch das System

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 linken Seite unter Dokumente auf InfoPathSolutions.

3. Klicken Sie auf die PurchaseOrder Datei, um das Dialogfeld Dateidownload anzuzeigen, und klicken Sie dann auf Öffnen. Das Formular wird in InfoPath geladen.

4. Geben Sie im Feld Bestell-ID ein 1002.

5. Geben Sie im Feld Rechnung an den Namen ein John Doe.

6. Geben Sie im Feld Betrag ein 750.

7. Geben 1/2/2005Sie im Feld Bestelldatum ein.

8. Klicken Sie auf Speichern.

9. Geben http://<server_name>/sites/WSSAdapterWalkthrough/SourceSie im Dialogfeld Speichern unter das Feld Dateiname ein, und drücken Sie dann die EINGABETASTE.

10. Geben Sie PurchaseOrder2.xml in das Feld Dateinamen ein, und klicken Sie dann auf Speichern.

11. Schließen von Microsoft Office InfoPath

12. Klicken Sie im Webbrowser in der oberen Navigationsleiste auf Dokumente und Listen.

13. Klicken Sie unter Dokumentbibliotheken auf Ziel.

14. In der Zieldokumentbibliothek wird nun Ihre Nachricht aufgeführt. Außerdem ist eine archivierte Kopie in der Archivdokumentbibliothek enthalten.

15. Klicken Sie in der Zieldokumentbibliothek auf PurchaseOrder1.xml. Beachten Sie, dass diese XML-Datei in Microsoft Internet Explorer geöffnet wird.

16. Klicken Sie in der Zieldokumentbibliothek auf PurchaseOrder2.xml. Beachten Sie, dass diese XML-Datei in Microsoft Office InfoPath geöffnet wird.

Hinweis

In der Zieldokumentbibliothek sollte die Spalte Dateiname den Wert des Felds PurchaseOrderID enthalten und die Spalte Partnername den Wert des Felds BillTo (Rechnungsadresse).

Zusammenfassung

In dieser exemplarischen Vorgehensweise wurde gezeigt, wie unter Verwendung des Windows SharePoint Services-Adapters und mit inhaltsbasiertem Routing eine engere Integration mit Microsoft InfoPath erzielt wurde.

Nächste Schritte

Nachdem Sie diese exemplarische Vorgehensweise abgeschlossen haben, führen Sie die Exemplarische Vorgehensweise aus: Modul 3 – Zugreifen auf SharePoint-Eigenschaften aus einer Orchestrierung , die die Arbeit erweitert, die Sie mit dieser exemplarischen Vorgehensweise ausgeführt haben, eine Orchestrierung in das Projekt integriert und Ihnen zeigt, wie Sie von dort aus auf SharePoint-Eigenschaften zugreifen.

Weitere Informationen

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