Exemplarische Vorgehensweise: Modul 3 – Zugreifen auf SharePoint-Eigenschaften aus einer Orchestrierung

Diese exemplarische Vorgehensweise ist eine Fortsetzung der Exemplarischen Vorgehensweise: Modul 2 – Integrieren von Office in den Windows SharePoint Services-Adapter und zeigt Ihnen, wie Sie zur Laufzeit auf die Windows SharePoint Services Kontexteigenschaften einer eingehenden Nachricht zugreifen und dann das Ziel dieser Nachricht basierend auf einer Eigenschaft mithilfe dynamischer Ports in einem ermitteln. Orchestrierung. 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.

• Sie müssen die folgenden exemplarischen Vorgehensweisen ausführen: Exemplarische Vorgehensweise: Modul 1 – Senden und Empfangen von Nachrichten mit dem Windows SharePoint Services-Adapter und Exemplarische Vorgehensweise: Modul 2 – Integrieren von Office in den Windows SharePoint Services-Adapter

  Informationen zur Verwendung des Windows SharePoint Services-Adapters in einer Bereitstellung mit mehreren Servern finden Sie unter Einrichten und Bereitstellen des Windows SharePoint Services-Adapters.

Ändern des BizTalk-Projekts

In diesem Verfahren ändern Sie das PurchaseOrder-Schema aus Exemplarische Vorgehensweise: Modul 2 – Integrieren von Office in den Windows SharePoint Services-Adapter. Hierin wird veranschaulicht, wie Sie eine Schemaeigenschaft höher stufen, um den Zugriff in einer BizTalk-Orchestrierung zu erleichtern.

Ändern des Schemas „PurchaseOrder.xsd“

1. Starten Sie Microsoft Visual Studio.

2. Klicken Sie auf Datei, klicken Sie auf Öffnen, und klicken Sie dann auf Projekt/Projektmappe.

3. Navigieren Sie zur OrderProcess.sln Datei, und klicken Sie dann auf Öffnen.

4. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf die OrderProcessSchema.xsd Datei, und klicken Sie dann auf Öffnen.

5. Erweitern Sie PurchaseOrderim BizTalk-Editor .

6. Klicken Sie mit der rechten Maustaste auf AmountHöherstufen, und klicken Sie dann auf Schnellaufstufung.

7. Klicken Sie auf OK.

   Hinweis

   Visual Studio erstellt ein Eigenschaftenschema dafür im aktuellen Projekt.

8. Speichern Sie PurchaseOrder.xsd.

Erstellen einer Orchestrierung

In diesem Verfahren erstellen Sie eine neue BizTalk-Orchestrierung. Mit dieser Orchestrierung wird eine Nachricht verarbeitet, die der Windows SharePoint Services-Adapter empfängt.

Hinzufügen einer BizTalk-Orchestrierung

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. Wählen Sie unter Kategoriendie Option Orchestrierungsdateien aus.

3. Wählen Sie unter Vorlagendie Option BizTalk-Orchestrierung aus.

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

Erstellen von Informationen zum Empfang

In diesem Verfahren erstellen Sie eine neue Nachricht, einen neuen Empfangsport und eine Form vom Typ "Empfangen" für die Orchestrierung. In diesem Verfahren wird veranschaulicht, wie Sie eine Orchestrierung konfigurieren, um eine Nachricht von BizTalk Server zu empfangen.

Erstellen einer neuen Nachricht

1. Klicken Sie in der Orchestrierungsansicht mit der rechten Maustaste auf Nachrichten, und klicken Sie dann auf Neue Nachricht. Dadurch wird eine neue Nachricht mit dem Namen Message_1generiert.

2. Klicken Sie mit der rechten Maustaste auf Message_1, klicken Sie auf Umbenennen, und geben Sie dann ein Message_PO.

3. Klicken Sie mit der rechten Maustaste auf Message_PO, und klicken Sie dann auf Eigenschaftenfenster.

4. Erweitern Sie in der Eigenschaft Nachrichtentypden Eintrag Schemas, und wählen Sie dann Schema aus OrderProcess.OrderProcessSchema .

Hinzufügen eines Empfangsports zur Orchestrierung

1. Ziehen Sie unter BizTalk-Orchestrierungen in der Toolbox ein Port-Shape auf die Portoberfläche. Der Portkonfigurations-Assistent wird gestartet.

2. Klicken Sie auf dem Bildschirm Willkommen auf Weiter.

3. Geben Sie ReceivePurchaseOrder in das Feld Name ein, und klicken Sie dann auf Weiter.

4. Wählen Sie Neuen Porttyp erstellen aus.

5. Geben Sie PurchaseOrderPT in das Feld Porttypname ein, und klicken Sie dann auf Weiter.

6. Behalten Sie auf dem Bildschirm Portbindung die Standardwerte bei, und klicken Sie dann auf Weiter.

7. Klicken Sie auf Fertig stellen.

8. Erweitern Sie in der Orchestrierungsansicht unter Porttypen den PurchaseOrderPT Porttyp.

9. Klicken Sie mit der rechten Maustaste auf Operation_1, klicken Sie auf Umbenennen, und geben Sie dann ein PurchaseOrderOperation.

Hinzufügen einer Form vom Typ „Empfangen“ zur Orchestrierung

1. Ziehen Sie unter BizTalk-Orchestrierungen in der Toolbox ein Receive-Shape auf die Orchestrierung.

2. Klicken Sie mit der rechten Maustaste auf die Form Empfangen, und klicken Sie dann auf Eigenschaftenfenster.

3. Legen Sie die Activate-Eigenschaft auf fest True.

   Hinweis

   Wenn die Eigenschaft "Aktivieren" auf "False" festgelegt ist, wird der folgende Fehler ausgegeben: "Fehler X2214: Sie müssen mindestens einen bereits initialisierten Korrelationssatz für einen nicht aktivierten Empfangsport angeben, der sich auf einem nicht selbst korrelierten Port befindet"

4. Geben Sie Receive_PO in das Feld Name ein.

5. Wählen Sie im Eigenschaftenfenster die Option Message_PO Message-Eigenschaft aus.

6. Wählen Sie für die Eigenschaft Operation die Option ausReceivePurchaseOrder.PurchaseOrderOperation.Request. Dadurch wird im Orchestrierungs-Designer der Port mit der Form "Empfangen" verbunden.

Erstellen von Informationen zum Senden

In diesem Verfahren erstellen Sie eine neue Nachricht, Sendeports und eine Entscheidungsstruktur für die Orchestrierung. Hierin wird veranschaulicht, wie Sie eine Orchestrierung mit Entscheidungslogik konfigurieren und wie Sie eine Orchestrierung so konfigurieren, dass eine Nachricht an einen Sendeport gesendet wird.

Erstellen einer neuen Nachricht

1. Klicken Sie in der Orchestrierungsansicht mit der rechten Maustaste auf Nachrichten, und klicken Sie dann auf Neue Nachricht. Dadurch wird eine neue Nachricht mit dem Namen Message_1generiert.

2. Klicken Sie mit der rechten Maustaste auf Message_1, klicken Sie auf Umbenennen, und geben Sie dann ein Message_Task.

3. Klicken Sie mit der rechten Maustaste auf Message_Task, und klicken Sie dann auf Eigenschaftenfenster.

4. Erweitern Sie in der Eigenschaft Nachrichtentypden Eintrag Schemas, und wählen Sie dann Schema aus OrderProcess.OrderProcessSchema .

Hinzufügen eines Sendeports zur Orchestrierung

1. Ziehen Sie unter BizTalk-Orchestrierungen in der Toolbox ein Port-Shape auf die Portoberfläche. Der Portkonfigurations-Assistent wird gestartet.

2. Klicken Sie auf dem Bildschirm Willkommen auf Weiter.

3. Geben Sie SendPurchaseOrder in das Feld Name ein, und klicken Sie dann auf Weiter.

4. Wählen Sie Vorhandenen Porttyp verwenden aus.

5. Wählen Sie unter Verfügbare Porttypen die Option aus OrderProcess.PurchaseOrderPT, und klicken Sie dann auf Weiter.

6. Wählen Sie auf dem Bildschirm Portbindung unter Portrichtung der Kommunikation die Option aus I'll always be sending messages on this port, und klicken Sie dann auf Weiter.

7. Klicken Sie auf Fertig stellen.

Hinzufügen einer Form vom Typ „Senden“ zur Orchestrierung

1. Ziehen Sie unter BizTalk-Orchestrierungen in der Toolbox ein Shape senden auf die Orchestrierung Designer. Platzieren Sie sie unterhalb der Receive_PO Form Empfangen.

2. Klicken Sie mit der rechten Maustaste auf das Shape Senden, und klicken Sie dann auf Eigenschaftenfenster.

3. Geben Sie Send_PO in das Feld Name ein.

4. Wählen Sie für die Message-Eigenschaft ausMessage_PO.

5. Wählen Sie für die Eigenschaft Operation die Option ausSendPurchaseOrder.PurchaseOrderOperation.Request. Dadurch wird im Orchestrierungs-Designer der Port mit der Form Senden verbunden.

Form vom Typ "Entscheidung" zur Orchestrierung hinzufügen

1. Ziehen Sie unter BizTalk-Orchestrierungen in der Toolbox ein Shape Entscheiden auf die Orchestrierung Designer. Platzieren Sie sie unterhalb der Send_PO Form Senden.

2. Klicken Sie mit der rechten Maustaste auf die Form Entscheiden, und klicken Sie dann auf Eigenschaftenfenster.

3. Geben Sie NeedsApproval in das Feld Name ein.

4. Klicken Sie unter Orchestrierung Designer auf Rule_1 auf der Form Entscheiden.

5. Geben Sie ApprovalRequired im Eigenschaftenfenster die Name-Eigenschaft ein.

6. Klicken Sie auf das Feld Expression-Eigenschaft , und klicken Sie dann auf die Schaltfläche mit den Auslassungspunkten (...).

7. Geben Sie im BizTalk-Ausdrucks-Editor folgenden Ausdruck ein, oder kopieren Sie ihn:

   Message_PO(OrderProcess.PropertySchema.Amount) > 1000  
   

8. Klicken Sie auf OK.

Hinzufügen eines weiteren Sendeports zur Orchestrierung

1. Ziehen Sie unter BizTalk-Orchestrierungen in der Toolbox ein Port-Shape auf die Portoberfläche. Der Portkonfigurations-Assistent wird gestartet.

2. Klicken Sie auf dem Bildschirm Willkommen auf Weiter.

3. Geben Sie SendToTasksList in das Feld Name ein, und klicken Sie dann auf Weiter.

4. Wählen Sie Vorhandenen Porttyp verwenden aus.

5. Wählen Sie unter Verfügbare Porttypen die Option aus OrderProcess.PurchaseOrderPT, und klicken Sie dann auf Weiter.

6. Wählen Sie auf dem Bildschirm Portbindung unter Portrichtung der Kommunikation die Option aus I'll always be sending messages on this port.

7. Wählen Sie unter Portbindung die Option aus Dynamic, und klicken Sie dann auf Weiter.

8. Klicken Sie auf Fertig stellen.

Hinzufügen einer Form vom Typ „Senden“ zur Form „Entscheidung“

1. Ziehen Sie unter BizTalk-Orchestrierungen in der Toolbox ein Shape Senden in die Orchestrierungs-Designer. Platzieren Sie es unterhalb der ApprovalRequired Form.

2. Klicken Sie mit der rechten Maustaste auf das Shape Senden, und klicken Sie dann auf Eigenschaftenfenster.

3. Geben Sie CreateApprovalTask in das Feld Name ein.

4. Wählen Sie Message_Task für die Message-Eigenschaft aus.

5. Wählen Sie SendToTasksList.PurchaseOrderOperation.Request für die Eigenschaft Operation aus. Dadurch wird im Orchestrierungs-Designer der Port mit der Form Senden verbunden.

Erstellen eines Ausdrucks

In diesem Verfahren fügen Sie der Projektmappe eine Form vom Typ "Ausdruck" hinzu, durch die der Wert des Pfads für "Aufgaben" einer Variablen zugeordnet wird. Hierin wird veranschaulicht, wie Sie einer Orchestrierung Logik hinzufügen können, um die Eigenschaften eines dynamischen Sendeports zu ändern.

Erstellen eines neuen Ausdrucks

1. Ziehen Sie in der Toolbox unter BizTalk-Orchestrierungen ein Ausdrucks-Shape vor das CreateApprovalTask Shape Senden.

2. Klicken Sie mit der rechten Maustaste auf die Form Ausdruck, und klicken Sie dann auf Eigenschaftenfenster.

3. Geben Sie SetPortDestination in das Feld Name ein.

4. Klicken Sie auf das Eigenschaftenfeld Ausdruck und dann auf die Schaltfläche mit den Auslassungspunkten (...).

5. Geben Sie im BizTalk-Ausdrucks-Editor Folgendes ein:

   SendToTasksList(Microsoft.XLANGs.BaseTypes.Address) = "wss://localhost/sites/WSSAdapterWalkthrough/Lists/Tasks/";  
   

6. Klicken Sie auf OK.

Erstellen einer neuen Nachricht

In diesem Verfahren fügen Sie der Projektmappe eine Form vom Typ "Nachricht erstellen" hinzu, wodurch eine neue Instanz eines Nachrichtentyps in der Orchestrierung erstellt wird. Hierin wird veranschaulicht, wie Sie eine neue Nachricht erstellen, die eine Kopie der eingehenden Nachricht ist, und dann die Kontexteigenschaften der neuen Nachricht ändern. Dieser Schritt ist erforderlich, weil in BizTalk Nachrichten unveränderlich sind (d. h., dass das Original einer Nachricht nach dem Erstellen nicht mehr geändert werden kann).

Hinzufügen einer Form vom Typ „Nachricht erstellen“

1. Ziehen Sie unter BizTalk-Orchestrierungen in der Toolbox ein Shape Meldung erstellen vor das SetPortDestination Ausdrucks-Shape.

2. Klicken Sie mit der rechten Maustaste auf das Shape Nachricht erstellen, und klicken Sie dann auf Eigenschaftenfenster.

3. Geben Sie ConstructTaskMessagein das Feld Name ein.

4. Wählen Sie Message_Task für die Eigenschaft Messages Constructed aus .

5. Ziehen Sie unter BizTalk-Orchestrierungen in der Toolbox ein Nachrichtenzuweisungs-Shape in das ConstructTaskMessage Shape Meldung erstellen.

6. Geben InitTaskMessageSie im Eigenschaftenfenster in das Feld Name ein.

7. Klicken Sie auf das Eigenschaftenfeld Ausdruck und dann auf die Schaltfläche mit den Auslassungspunkten (...).

8. Geben Sie im BizTalk-Ausdrucks-Editor Folgendes ein, oder kopieren Sie sie:

   Message_Task = Message_PO;  
   Message_Task(WSS.ConfigOverwrite) = "no";  
   Message_Task(WSS.ConfigNamespaceAliases)= "orchns='http://OrderProcess.PurchaseOrder'";  
   Message_Task(WSS.ConfigPropertiesXml) = "<ConfigPropertiesXml><PropertyName1>Title</PropertyName1><PropertySource1>Approve %XPATH=//orchns:PurchaseOrder/orchns:PurchaseOrderID%</PropertySource1><PropertyName3>Status</PropertyName3><PropertySource3>Not Started</PropertySource3><PropertyName4>Priority</PropertyName4><PropertySource4>(1) High</PropertySource4></ConfigPropertiesXml>";  
   

   Wichtig

   Bei den für diese Kontexteigenschaften angegebenen Werten wird die Groß-/Kleinschreibung beachtet. Wenn Sie Konfigurationswerte für einen dynamischen Port mit Kontexteigenschaften festlegen, müssen Sie sicherstellen, dass Sie die richtige Groß-/Kleinschreibung verwenden. Andernfalls tritt ein Fehler auf, wenn BizTalk versucht, das Dokument an den angegebenen Sendeport weiterzuleiten.

9. Klicken Sie auf OK.

10. Klicken Sie auf Dateiund dann auf Alle speichern.

Erstellen des BizTalk-Projekts

In diesem Verfahren erstellen Sie das BizTalk-Projekt und stellen es bereit. Dieser Schritt ist erforderlich, um die Assembly zu erstellen und bereitzustellen, die BizTalk Server zur Laufzeit verwendet.

Erstellen und Bereitstellen der Lösung

1. Klicken Sie auf Erstellen und dann auf OrderProcess erstellen.

2. Klicken Sie auf Erstellen und dann auf OrderProcess bereitstellen.

3. Schließen Sie Microsoft Visual Studio.

Ändern des Empfangsspeicherorts und des Sendeports

In diesem Verfahren ändern Sie den vorhandenen Empfangsspeicherort und Sendeport, um die XML-Verarbeitung für die Pipelines zu verwenden. In der XML-Empfangspipeline werden während der Orchestrierungsverarbeitung verwendete Nachrichteneigenschaften gespeichert, und in der XML-Sendepipeline werden die in der Orchestrierung angewendeten Nachrichteneigenschaften gespeichert, die anschließend für die Weiterleitung der Nachrichten verwendet werden.

Ändern des Empfangsspeicherorts

1. Klicken Sie auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf MicrosoftBizTalk Server, und klicken Sie dann auf BizTalk Server Verwaltung.

2. Erweitern Sie MicrosoftBizTalk ServerAdministration SnapIn, erweitern Sie BizTalk-Gruppe, Erweitern Sie Anwendungen, erweitern Sie BizTalk-Anwendung 1, und klicken Sie dann auf den Knoten Empfangsspeicherorte.

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

4. Wählen Sie im Dialogfeld Eigenschaften des Empfangsspeicherorts unter Allgemein die Option XMLReceive für die Eigenschaft Empfangspipeline aus.

5. Klicken Sie auf OK.

Ändern des Sendeports

1. Klicken Sie auf den Knoten Ports senden .

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

3. Wählen Sie im Dialogfeld Porteigenschaften senden unter Allgemein die Option XMLTransmitpipeline-Eigenschaft senden aus.

4. Wählen Sie die Registerkarte Filter aus.

5. Wählen Sie die vorhandene Bedingung aus, drücken Sie ENTF, und klicken Sie dann auf OK.

Starten eines neuen Sendeports

1. Klicken Sie auf den Knoten Ports senden .

2. Klicken Sie mit der rechten Maustaste auf OrderProcess_1.0.0.0_OrderProcess.MyCompanyOrderProcess_SendToTasksList_<GUID>, und klicken Sie dann auf Start.

Hinweis

Falls der Port nicht angezeigt wird, müssen Sie möglicherweise die Konsolenansicht aktualisieren.

Binden der Orchestrierung

In diesem Verfahren binden Sie die Orchestrierung an die angegebenen Ports. Diese Schritte sind erforderlich, um physische Ports an die erstellte und bereitgestellte Orchestrierung zu binden.

Binden der Orchestrierung

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

2. Klicken Sie mit der rechten Maustaste auf die OrderProcess.MyCompanyOrderProcessing Orchestrierung, und klicken Sie dann auf Eigenschaften.

3. Wählen Sie die Registerkarte Bindungen aus.

4. Wählen Sie unter Host die Option BizTalkServerApplication im Feld Host aus.

5. Wählen Sie unter Bindungen die Option FromSource Logischer Port für eingehenden ReceivePurchaseOrder Datenverkehr aus.

6. Wählen Sie unter Bindungen die Option SendToDestination für den SendPurchaseOrder logischen Ausgehenden Port aus.

7. Klicken Sie auf OK.

8. Klicken Sie mit der rechten Maustaste auf OrderProcess.MyCompanyOrderProcessing Orchestrierung, und klicken Sie dann auf Start.

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". Während der Verarbeitung der Nachricht wird auf Windows SharePoint Services-Kontexteigenschaften zugegriffen, anhand derer das Ziel ermittelt wird.

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 im Schnellstartmenü 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 den Wert ein 1003.

5. Geben Sie im Feld Rechnung bis den Wert ein John Doe.

6. Geben Sie im Feld Betrag den Wert ein 1750.

7. Geben Sie im Feld Bestelldatum den Wert ein 1/3/2005.

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 PurchaseOrder3.xml das Feld Dateiname ein, und klicken Sie dann auf Speichern.

11. Schließen Sie InfoPath.

12. Klicken Sie im Webbrowser auf Dokumente und Listen.

13. Klicken Sie unter Dokumentbibliotheken auf Ziel.

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

15. Klicken Sie auf Startseite.

16. Klicken Sie unter Listen auf Aufgaben.

17. In der Aufgabenliste wird nun die neu erstellte Genehmigungsaufgabe angezeigt.

Hinweis

Da der Betrag der Bestellung über $ 1.000,00 lag, wurde die Aufgabe erstellt.

Zusammenfassung

In dieser exemplarischen Vorgehensweise haben Sie erfahren, wie Sie auf die Windows SharePoint Services-Kontexteigenschaften zugreifen und das Ziel von Nachrichten bestimmen, die dynamische Ports passieren.

Nächste Schritte

Arbeiten Sie auch den Rest des Abschnitts zum Windows SharePoint Services-Adapter durch. Weitere Informationen finden Sie in den Themen unter „Siehe auch“.

Weitere Informationen

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