OrderedSample (BizTalk Server-Beispiel)

  • Artikel

Das OrderedSample-Beispiel zeigt, wie Sie eine Orchestrierung verwenden, um im Roundtripverfahren eine geordnete Folge von Nachrichten zu empfangen und zu senden.

Ziel des Beispiels

In diesem Beispiel wird davon ausgegangen, dass sich Nachrichten in der MQSeries-Warteschlange befinden, von der Nachrichten empfangen werden. Wenn der Adapter die Nachrichten aus der MQSeries-Warteschlange liest, liest er sie in der richtigen Reihenfolge und übermittelt sie an BizTalk Server.

Für den Empfangsport in der Orchestrierung mqreceive ist die Ordered Delivery-Eigenschaft auf True festgelegt.

Im Falle der Sendeseite sendet die Orchestrierung eine Nachricht und wartet dann auf eine Übermittlungsbenachrichtigung, bevor sie die nächste Nachricht sendet. Für den Sendeport mqsend ist die Eigenschaft Übermittlungsbenachrichtigung auf Übertragen festgelegt. Damit das Beispiel möglichst einfach bleibt, verwendet die Orchestrierung eine Endlosschleife.

Die Orchestrierung kann Nachrichtenbatches und einzelne Nachrichten empfangen.

Speicherort dieses Beispiels

<Samples Path>\AdaptersUsage\MQSeriesAdapter\OrderedSample

In der folgenden Tabelle werden die Dateien in diesem Beispiel samt Zweck beschrieben.

Datei BESCHREIBUNG
OrderedReceiveSend.btproj,

OrderedReceiveSend.sln		 Projekt- und Projektmappendateien für die Anwendung.
OrderedReceiveSendOrchestration.odx Die Orchestrierung der Anwendung
OrderedSample.snk Die Schlüsseldatei für starke Benennung.
Setup.bat Erstellt und initialisiert dieses Beispiel.

Erstellen und Ausführen des Beispiels

So erstellen Sie das Beispiel und stellen es bereit

  1. Navigieren Sie in einem Befehlsfenster zum folgenden Ordner:

    <Samples Path>\AdaptersUsage\MQSeriesAdapter\OrderedSample

  2. Führen Sie die Datei "Setup.bat" aus, von der folgende Aktionen ausgeführt werden:

    1. Sie erstellt einen Schlüssel mit starkem Namen für das Projekt.

    2. Sie kompiliert das Orchestrierungsprojekt und stellt es bereit.

    Wenn Sie über die erforderlichen Berechtigungen für die Installation von MQSeries-Server für Windows verfügen, können Sie die MQSeries-Warteschlange über die Adapterdialogfelder erstellen und das nächste Verfahren überspringen. Verfügen Sie nicht über den erforderlichen Zugriff, können Sie die Warteschlange mithilfe von IBM WebSphere MQ Explorer erstellen. Um die Warteschlange mit WebSphere MQ Explorer zu erstellen, führen Sie die folgenden Schritte aus.

Erstellen der MQSeries-Warteschlangen mit WebSphere MQ Explorer

So erstellen Sie die MQSeries-Warteschlangen mit WebSphere MQ Explorer

  1. Klicken Sie auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf IBM WebSphere MQ, und klicken Sie dann auf WebSphere MQ Explorer.

  2. Doppelklicken Sie auf Warteschlangen-Manager, und doppelklicken Sie dann auf den Standardwarteschlangen-Manager. Der Standardwarteschlangen-Manager heißt in der Regel QM_<machine_name> wobei machine_name der Name Ihres Computers ist.

  3. Klicken Sie mit der rechten Maustaste auf Warteschlangen, zeigen Sie auf Neu, und klicken Sie dann auf Lokale Warteschlange.

  4. Geben Sie im Dialogfeld Lokale Warteschlange erstellen unter Warteschlangenname die Zeichenfolge "queue1" ein, und klicken Sie dann auf OK.

  5. Klicken Sie mit der rechten Maustaste auf Warteschlangen, klicken Sie auf Neu, und klicken Sie dann auf Lokale Warteschlange.

  6. Geben Sie im Dialogfeld Lokale Warteschlange erstellen unter Warteschlangennameden Wert "queue2" ein, und klicken Sie dann auf OK.

Erstellen des Empfangsspeicherorts und der MQSeries-Warteschlange

Mit diesem Verfahren werden der Sendeport und der Empfangsspeicherort für das Senden der Nachricht und den Empfang der Korrelationsnachricht von MQSeries erstellt. Die MQSeries-Warteschlange wird beim Erstellen des Empfangsspeicherorts erstellt, sofern sie nicht bereits erstellt wurde.

So erstellen Sie den Empfangsspeicherort und die MQSeries-Warteschlange

  1. Öffnen Sie die BizTalk Server-Verwaltungskonsole.

  2. Erweitern Sie BizTalk Server Verwaltung, BizTalk-Gruppe, Anwendungen und dann die erforderliche Anwendung.

  3. Klicken Sie mit der rechten Maustaste auf Empfangsports, zeigen Sie auf Neu, und klicken Sie dann auf Unidirektionale Empfangsport.

  4. Geben Sie im Dialogfeld Eigenschaften für unidirektionale Empfangsports im Feld Name den Namen OrderedSampleReceive ein, und klicken Sie auf OK.

  5. Klicken Sie im linken Bereich auf die Registerkarte Empfangsspeicherorte , und klicken Sie dann auf Neu.

  6. Geben Sie im Dialogfeld Eigenschaften des Empfangsspeicherorts im Feld Name den Namen "OrderedSampleReceiveLocation" ein.

  7. Wählen Sie im Feld Transporttyp die Option MQSeries aus.

  8. Wählen Sie im Feld Empfangshandler die Option BizTalkServerAnwendung aus.

  9. Wählen Sie im Feld Empfangspipelinedie Option Microsoft.BizTalk.DefaultPipelines.PassThruReceive aus.

  10. Klicken Sie auf Konfigurieren.

  11. Geben Sie im Dialogfeld MQSeries-Transporteigenschaften im Feld Abrufintervallden Wert "10" ein.

  12. Klicken Sie im Feld Warteschlangendefinition auf die Schaltfläche mit den Auslassungspunkten (...) .

  13. Geben Sie im Dialogfeld Warteschlangendefinition im Feld Servername den Computernamen ein.

  14. Wählen Sie im Feld Warteschlangen-Manager den Standardwarteschlangen-Manager aus.

  15. Geben Sie im Feld Warteschlange den Wert " queue1" ein, und klicken Sie dann auf Exportieren.

  16. Klicken Sie im Dialogfeld Exportieren auf Warteschlange erstellen, und klicken Sie dann auf OK oder Fertig , bis Sie alle Dialogfelder beendet haben.

Erstellen des Sendeports und der MQSeries-Warteschlange

So erstellen Sie den Sendeport und die MQSeries-Warteschlange

  1. Klicken Sie mit der rechten Maustaste auf Sendeports, zeigen Sie auf Neu, und klicken Sie dann auf Statischer unidirektionale Sendeport.

  2. Geben Sie im Dialogfeld Eigenschaften des statischen Ports im Feld Name den Namen "OrderedSampleSend" ein.

  3. Wählen Sie im Feld Transporttyp die Option MQSeries aus.

  4. Wählen Sie im Feld Pipeline senden die Option Microsoft.BizTalk.DefaultPipelines.PassThruTransmit aus.

  5. Klicken Sie auf Konfigurieren.

  6. Klicken Sie im Dialogfeld MQSeries-Transporteigenschaften im Feld Warteschlangendefinition auf die Schaltfläche mit den Auslassungspunkten (...) .

  7. Geben Sie im Dialogfeld Warteschlangendefinition im Feld Servername den Computernamen ein.

  8. Wählen Sie im Feld Warteschlangen-Manager den Standardwarteschlangen-Manager aus.

  9. Geben Sie im Feld Warteschlange den Wert " queue2" ein, und klicken Sie dann auf Exportieren.

  10. Klicken Sie im Dialogfeld Exportieren auf Warteschlange erstellen, und klicken Sie dann auf OK oder Fertig , bis Sie alle Dialogfelder beendet haben.

So aktivieren Sie den Empfangsspeicherort und starten den Sendeport

  1. Klicken Sie in der BizTalk Server-Verwaltungskonsole auf Empfangsports.

  2. Klicken Sie im Detailbereich mit der rechten Maustaste auf den MQIn-Empfangsspeicherort , und klicken Sie auf Aktivieren.

  3. Klicken Sie im Detailbereich mit der rechten Maustaste auf den MQOut-Sendeport , und klicken Sie auf Start.

So binden und starten Sie die Orchestrierung

  1. Erweitern Sie in der BizTalk Server-Verwaltungskonsole den Ordner Orchestrierungen.

  2. Doppelklicken Sie auf die Orchestrierung OrderedSampleOrchestration , und klicken Sie dann auf Bindungen.

  3. Binden Sie die Orchestrierungsports an folgende Sendeports und Empfangsspeicherorte:

    Orchestrierungsport Messagingport/Empfangsspeicherort
    mqreceive OrderedSampleReceive
    mqsend OrderedSampleSend

  4. Klicken Sie auf Host.

  5. Wählen Sie im Feld Host die Option BizTalkServerAnwendung aus, und klicken Sie auf OK.

  6. Klicken Sie mit der rechten Maustaste auf Orchestrierung , und klicken Sie dann auf Start.

So führen Sie das Beispiel aus

  1. Starten Sie die Orchestrierung.

  2. Stellen Sie Nachrichten in die MQSeries-Warteschlange, aus der der Empfangsspeicherort liest, wie Sie dies in der Konfiguration festgelegt haben.

  3. Zeigen Sie im WebSphere MQ Explorer die Nachrichten in der Sendewarteschlange an, an die der Sendeport gemäß der Konfiguration Nachrichten sendet.

Weitere Informationen

Beispiele für MQSeries-Adapter