Freigeben über

Lernprogramm: Senden 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 an ein TIBCO-System senden. In dieser exemplarischen Vorgehensweise wird ein SDK-Beispiel beschrieben, in dem dies veranschaulicht wird.

Voraussetzungen

  • Für BizTalk-Adapter für TIBCO EMS müssen Sie dem globalen Assemblycache (Global Assembly Cache, 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 Dateiordner gelesen, die Datei an eine Orchestrierung gesendet und dann BizTalk-Adapter für TIBCO Enterprise Message Service dazu verwendet, einen Datensatz im TIBCO-System zu erstellen.

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.

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\OneWaySend

In der folgenden Tabelle werden die im Beispiel verwendeten Dateien aufgeführt und beschrieben.

Dateiname des Laufzeitprojekts Dateibeschreibung des Laufzeitprojekts
OneWaySend.btproj

OneWaySend.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, Alle Programme, MicrosoftBizTalk ServerBizTalk Server Verwaltung.

  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-Sendeports

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

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

  3. Geben Sie einen Wert für das Feld Name ein, z. B. TIBCOEMSOneWaySP.

  4. 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 angegeben wurde, als der TIBCO Enterprise Message System-Adapter in der BizTalk Server-Verwaltungskonsole erstellt wurde.

  5. 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

  6. 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-Sendehandlern.

  7. Klicken Sie auf OK.

  8. Wählen Sie in der Liste der verfügbaren Pipelines in der Dropdownliste Pipeline senden die Pipeline XML-Übertragung aus, und klicken Sie auf OK.

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

Erstellen eines Empfangsports für Dateien

  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 Empfangsports , um das Dialogfeld Eigenschaften des Empfangsports anzuzeigen.

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

Erstellen eines Empfangsspeicherorts für Dateien

  1. Erstellen Sie einen Ordner, der als Empfangsspeicherort für Dateien überwacht werden soll (beispielsweise C:\Dateiquelle).

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

  3. Geben Sie einen Wert für das Feld Name ein, z. B. TIBCOEMSOneWayFileRL.

  4. 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.

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

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

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

Generieren einer Dokumentinstanz aus dem Adapterschema

  1. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf Schema.xsd, und klicken Sie dann auf Eigenschaften.

  2. Klicken Sie im Eigenschaftenfenster, um die Option Dateiname der Ausgabeinstanz unter der Kategorie Allgemein auszuwählen.

  3. Klicken Sie auf die Schaltfläche mit den Auslassungspunkten (...), um das Dialogfeld Ausgabedatei auswählen anzuzeigen.

  4. Geben Sie einen Ordner und einen Namen für die Ausgabedatei instance an, z. B.C:\instance.xml, und klicken Sie auf Speichern.

    Hinweis

    Geben Sie nicht den Pfad des Ordners an, der hier für den Empfangsspeicherort für Dateien angegeben wurde.

  5. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf Schema.xsd, und klicken Sie auf Instanz generieren, um ein Dokument instance am angegebenen Speicherort zu generieren.

Ändern der generierten Dokumentinstanz

  1. Öffnen Sie die generierte Dokumentinstanz in einem Texteditor (z. B. Editor), und bearbeiten Sie den Inhalt der Dokumentinstanz, damit sichergestellt ist, dass aus den Daten ein eindeutiger Datensatz im TIBCO-System generiert wird. Im folgenden Code wird der erste Teil der Datendatei als Beispiel gezeigt:

    <ns0:Root xmlns:ns0="http://TibcoEMSOne_WaySend.TibcoEMSOneWaySendSchema">  
  <Name>Punya Palit</Name>  
  <MailAddress>Prose Ware, Inc.</MailAddress>  
</ns0:Root>

  2. Speichern Sie die geänderte Dokumentinstanz.

Erstellen und Bereitstellen des Projekts

  1. Klicken Sie mit der rechten Maustaste auf das OneWaySend-Projekt in Projektmappen-Explorer, und klicken Sie dann auf Eigenschaften, um den 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 OneWaySend-Projekt in Projektmappen-Explorer, und klicken Sie dann 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 MMC-Symbolleiste 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
    FileReceivePort TIBCOEMSOneWayFileRP
    TibcoEMSOneWaySendPort TIBCOEMSOneWaySP

  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 zu starten und zu melden.

Kopieren einer Dokumentinstanz in den Ordner, der als Empfangsspeicherort für Dateien überwacht wird

  • Kopieren Sie die Dokumentinstanz, die Sie vor kurzem erstellt haben, in den Dateiempfangsordner, den die Anwendung überwacht.

Überprüfen, ob das TIBCO-System aktualisiert wurde

  • Überprüfen Sie mit der TIBCO-Weboberfläche, ob der Datensatz aus den Daten erstellt wurde, die in der XML-Datei enthalten sind.

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

  1. Der Dateiadapter ruft die Datei aus dem Ordner ab und veröffentlicht sie in der MessageBox als BizTalk-Nachricht.

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

  3. Die Orchestrierungsinstanz verarbeitet die Nachricht unter Verwendung der in der Orchestrierung angegebenen Logik und veröffentlicht die Nachricht wieder in der MessageBox-Datenbank.

  4. Der TIBCO-Sendeport abonniert diese veröffentlichte Nachricht, weshalb die BizTalk-Messaging-Engine die Nachricht an den TIBCO-Sendeport sendet.

  5. Der Sendeport übergibt die Nachricht an den BizTalk-Adapter für TIBCO Enterprise Message Service.

  6. Der BizTalk-Adapter für TIBCO Enterprise Message Service sendet die Nachricht an das TIBCO-System.

Weitere Informationen

Lernprogramm: Empfangen 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