Freigeben über

Lernprogramm: Empfangen von Daten mit dem BizTalk-Adapter für TIBCO Enterprise Message Service

  • Artikel

Mit dem BizTalk-Adapter für TIBCO Enterprise Message Service (EMS) können Sie Daten von einem TIBCO-System empfangen. In dieser exemplarischen Vorgehensweise wird ein SDK-Beispiel beschrieben, in dem dies veranschaulicht wird.

Voraussetzungen

  • Für den BizTalk-Adapter für TIBCO Enterprise Message Service müssen Sie dem globalen Assemblycache (GAC) die TIBCO EMS C#-API (TIBCO.EMS.dll) hinzufügen. Weitere Informationen zum Installieren der Assembly finden Sie unter Anforderungen und Einschränkungen des TIBCO Enterprise Message Service.

  • Installieren Sie Visual Studio auf dem BizTalk Server, auf dem der Adapter ausgeführt wird, um das Beispiel zu erstellen und bereitzustellen.

Ziel des Beispiels

In diesem Beispiel wird eine XML-Datei aus einem Ordner gelesen, die Datei an eine Orchestrierung gesendet und anschließend mithilfe des BizTalk-Adapters für TIBCO Enterprise Message Service ein Datensatz aus einem TIBCO-System abgerufen. Das Ergebnis wird in eine XML-Datei geschrieben.

Wie dieses Beispiel gestaltet ist und warum

Dieses in Visual Studio entwickelte Beispiel veranschaulicht die grundlegenden Funktionen unter Verwendung des BizTalk-Adapters für TIBCO Enterprise Message Service mit einer BizTalk-Orchestrierung.

Hinweis

Das Beispiel setzt voraus, dass Sie wissen, wie eine Nachricht aus TIBCO gesendet wird, die die Anwendung verarbeiten soll.

Speicherort dieses Beispiels

Der Standardspeicherort für das Beispiel ist

C:\Programme\Microsoft BizTalk Adapters for Enterprise Applications\TIBCO(r) Enterprise Message Service(TM)\Sdk\OneWayReceive

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

Dateiname des Laufzeitprojekts Dateibeschreibung des Laufzeitprojekts
OneWayReceive.btproj

OneWayReceive.sln		 Projekt- und Projektmappendateien für die Anwendung.
Schema.xsd, Schemadatei für die Anwendung.
Orchestration.odx Die Orchestrierung, die von der Anwendung verwendet wird.
TIBCOEMSOneWaySend.snk Die Schlüsseldatei für starke Benennung.

Verwenden dieses Beispiels

Erstellen einer neuen Instanz des BizTalk-Adapters für TIBCO EMS

  1. Starten Sie die BizTalk Server-Verwaltungskonsole. Klicken Sie auf Start, Programme, MicrosoftBizTalk ServerBizTalk Server Administration.

  2. Erweitern Sie in der BizTalk Server Verwaltungskonsole BizTalk Server Verwaltung, BizTalk-Gruppe, Plattformeinstellungen, und klicken Sie dann auf Adapter.

  3. Klicken Sie mit der rechten Maustaste auf Adapter, und zeigen Sie auf Neu, Adapter , um das Dialogfeld Adaptereigenschaften anzuzeigen.

  4. Geben Sie einen Wert für das Feld Name ein, z. B. TIBCO EMS.

  5. Wählen Sie TIBCO Enterprise Message System aus der Liste der verfügbaren Adapter in der Dropdownliste Adapter aus, und klicken Sie auf OK.

Erstellen eines BizTalk-Empfangsports

  1. Erweitern Sie in der BizTalk Server Verwaltungskonsole BizTalk Server Verwaltung, BizTalk-Gruppe, Anwendungen, BizTalk-Anwendung 1, und klicken Sie auf Empfangsports.

  2. Klicken Sie mit der rechten Maustaste auf den Ordner Empfangsports, und klicken Sie dann auf Neu, Unidirektionale Empfangsport, um das Dialogfeld Eigenschaften des Empfangsports anzuzeigen.

  3. Geben Sie einen Wert für das Feld Name ein, z. B . TIBCOEMSOneWayRP, und klicken Sie auf OK.

Erstellen eines BizTalk-Empfangsspeicherorts

  1. Klicken Sie mit der rechten Maustaste auf den neuen Empfangsport, und klicken Sie dann auf Neu, Empfangsspeicherort , um das Dialogfeld Eigenschaften des Empfangsspeicherorts anzuzeigen.

  2. Geben Sie einen Wert für das Feld Name ein, z. B. TIBCOEMSOneWayRL.

  3. Wählen Sie in der Liste der verfügbaren Adapter im Dropdownfeld Typ den TIBCO EMS-Adapter aus, und klicken Sie auf die Schaltfläche Konfigurieren , um das Dialogfeld Transporteigenschaften des Adapters anzuzeigen.

    Hinweis

    Dieser Wert ist der Name, der beim Erstellen des TIBCO-Adapters in der BizTalk Server-Verwaltungskonsole angegeben wurde.

  4. Geben Sie Werte für die Serververbindungsdefinition ein:

    Eigenschaft Wert
    Destination Die Serverzielwarteschlange oder der Themenname
    Portnummer Der Port, den der TIBCO-Server überwacht. Der Standardwert ist 7222.
    Servername Der Name des TIBCO EMS-Servers

  5. Geben Sie Werte für die Benutzeranmeldeinformationen ein:

    Eigenschaft Wert
    Kennwort Das Kennwort für den TIBCO EMS-Server
    Benutzername Der Benutzername für den TIBCO EMS-Server

    Weitere Informationen zu den Eigenschaften finden Sie unter Erstellen von TIBCO Enterprise Message Service-Empfangshandlern.

  6. Klicken Sie auf OK.

  7. Wählen Sie xmlReceive aus der Liste der verfügbaren Pipelines im Dropdownfeld Pipeline empfangen aus, und klicken Sie auf OK.

  8. Klicken Sie mit der rechten Maustaste auf den Empfangsspeicherort, und klicken Sie auf Aktivieren.

Erstellen eines unidirektionalen Dateisendeports

  1. Erstellen Sie einen Zielordner, der vom Sendeport verwendet werden soll (z. B. C:\DateienAusgehend).

  2. Erweitern Sie in der BizTalk Server Verwaltungskonsole BizTalk Server-Verwaltung, BizTalk-Gruppe, Anwendungen, BizTalk-Anwendung 1, und klicken Sie auf Ports senden.

  3. Klicken Sie mit der rechten Maustaste auf Ports senden , und zeigen Sie auf Neu, Statischer unidirektionalen Sendeport , um das Dialogfeld Porteigenschaften senden anzuzeigen.

  4. Geben Sie einen Wert für das Feld Name ein, z. B. TIBCOEMSOneWayFileSP.

  5. Wählen Sie in der Liste der verfügbaren Adapter im Dropdownfeld Typ die Option DATEI aus, und klicken Sie auf die Schaltfläche Konfigurieren, um das Dialogfeld Transporteigenschaften des Adapters anzuzeigen.

  6. Geben Sie für die Eigenschaft Zielordner den Speicherort des Ordners ein, den Sie zuvor erstellt haben, und klicken Sie auf OK.

  7. Wählen Sie die Pipeline XMLTransmit aus der Liste der verfügbaren Pipelines in der Dropdownliste Pipeline senden aus, und klicken Sie auf OK.

  8. Klicken Sie mit der rechten Maustaste auf den Sendeport, und klicken Sie auf Start , um den Sendeport ein- und zu starten.

Erstellen und Bereitstellen des Projekts

  1. Klicken Sie mit der rechten Maustaste auf das OneWayReceive-Projekt in Projektmappen-Explorer, und klicken Sie auf Eigenschaften, um das Projekt Designer für das Projekt zu starten.

  2. Klicken Sie auf die Registerkarte Bereitstellung .

  3. Geben Sie die entsprechenden Werte für die Server-Eigenschaft und die Configuration Database-Eigenschaft unter der Kategorie BizTalk-Gruppe ein .

  4. Klicken Sie mit der rechten Maustaste auf das OneWayReceive-Projekt in Projektmappen-Explorer, und klicken Sie auf Bereitstellen, um das Projekt zu erstellen und die Assembly in der BizTalk Server Konfigurationsdatenbank bereitzustellen.

Binden und Eintragen der Orchestrierung

  1. Erweitern Sie in der BizTalk Server Verwaltungskonsole BizTalk Server Verwaltung, BizTalk-Gruppe, Anwendungen, BizTalk-Anwendung 1, und klicken Sie auf Orchestrierungen.

  2. Klicken Sie auf der Symbolleiste der BizTalk Server Verwaltungskonsole auf die Schaltfläche Aktualisieren, oder drücken Sie die Taste F5 auf der Tastatur, um die BizTalk Server Verwaltungskonsolenansicht zu aktualisieren.

  3. Doppelklicken Sie auf die Orchestrierung, um das Dialogfeld Orchestrierungseigenschaften anzuzeigen.

  4. Klicken Sie im linken Bereich des Dialogfelds auf Bindungen , um die Optionen für Bindungen für die Orchestrierung anzuzeigen.

  5. Geben Sie die entsprechenden Werte für die Bindungsoptionen an. Zum Beispiel:

    Parameter Wert
    Host BizTalkServerApplication
    FileSendPort TIBCOEMSOneWayFileSP
    TibcoEMSOneWayReceiveOperation TIBCOEMSOneWayRP

  6. Klicken Sie auf OK.

Starten der Orchestrierung

  • Klicken Sie in der BizTalk Server Verwaltungskonsole mit der rechten Maustaste auf die Orchestrierung, und klicken Sie auf Start, um die Orchestrierung einzugeben und zu starten.

Bestätigen, dass die Anwendung eine Nachricht empfängt

  • Öffnen Sie den Ordner, der in der Konfiguration des Dateisendeports als Sendeziel angegeben ist, und prüfen Sie, ob ein Ausgabedokument generiert wurde. Diese Datei muss das Ergebnis der Abfrage enthalten, die vom BizTalk-Adapter für TIBCO Enterprise Message Service verarbeitet wurde.

    Die folgenden Ereignisse treten in der angegebenen Reihenfolge auf, wenn die Dokumentinstanz erfolgreich verarbeitet wird:

  1. Der TIBCO EMS-Adapter empfängt eine Nachricht vom TIBCO-System und veröffentlicht sie in der MessageBox als BizTalk-Nachricht.

  2. Die Orchestrierung abonniert diese veröffentlichte Nachricht. Daher aktiviert die BizTalk-Messaging-Engine eine Instanz der Orchestrierung und sendet die Nachricht an die Orchestrierungsinstanz.

  3. Die Orchestrierungsinstanz veröffentlicht die Nachricht wiederum in der MessageBox.

  4. Der Dateisendeport abonniert diese Nachricht, weshalb BizTalk sie an den Dateiadapter sendet.

  5. Der Dateiadapter schreibt die Nachricht, die das Resultset enthält, in den dafür vorgesehenen Ausgabeordner.

Weitere Informationen

Lernprogramm: Senden von Daten mit dem BizTalk-Adapter für TIBCO Enterprise Message Service
Tutorials: Verwenden des Microsoft BizTalk-Adapters für TIBCO Enterprise Message Service
Erste Schritte