Freigeben über

Lernprogramm: Verwenden des BizTalk-Adapters für TIBCO Rendezvous zum Senden von Daten

  • Artikel

Mit dem BizTalk-Adapter für TIBCO Rendezvous können Sie Daten an ein TIBCO-System senden. In dieser exemplarischen Vorgehensweise wird ein SDK-Beispiel beschrieben, in dem dies veranschaulicht wird.

Voraussetzungen

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

  • Im Beispiel wird eine DLL verwendet, die Nachrichtenkontexteigenschaften enthält: Microsoft.BizTalk.Adapters.TibRV.Properties.dll. Sie müssen möglicherweise den Verweis der Lösung auf diese Bibliothek aktualisieren. Weitere Informationen finden Sie unter BizTalk Server Nachrichtenkontexteigenschaften (Sendehandler).

Über das Beispiel

  • In diesem Beispiel wird eine XML-Datei aus einem Dateiordner gelesen, die Datei an eine Orchestrierung gesendet und dann BizTalk-Adapter für TIBCO Rendezvous dazu verwendet, einen Datensatz im TIBCO-System zu erstellen.

  • Dieses Beispiel, das in Visual Studio entworfen wurde, veranschaulicht grundlegende Funktionen unter Verwendung des BizTalk-Adapters für TIBCO Rendezvous mit einer BizTalk-Orchestrierung.

  • Der Standardspeicherort für das Beispiel ist C:\Program Files\Microsoft BizTalk Adapters for Enterprise Applications\TIBCO(r) Rendezvous(r)\Sdk\OneWaySend, und enthält die folgenden Dateien:

    Dateiname des Laufzeitprojekts Dateibeschreibung des Laufzeitprojekts
    OneWaySend.btproj

    OneWaySend.sln    		 Projekt- und Projektmappendateien für die Anwendung.
    Schema.xsd

    PropertySchema.xsd    		 Schema- und Eigenschaftenschemadateien für die Anwendung.
    Orchestration.odx Die Orchestrierung, die von der Anwendung verwendet wird.
    TIBCORendezvousOneWaySend.snk Die Schlüsseldatei für starke Benennung.

Schritt 1: Hinzufügen des Adapters zur BizTalk-Verwaltung

  1. Erweitern Sie in BizTalk Server Verwaltungdie Option BizTalk-Gruppe, erweitern Sie Plattformeinstellungen, und klicken Sie dann auf Adapter.

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

  3. Geben Sie einen Wert für das Feld Name ein. Geben Sie z. B. TIBCO Rendezvous ein.

  4. Wählen Sie TIBCO(r) Rendezvous(r) aus der Liste der Adapter aus, die in der Dropdownliste Adapter verfügbar sind, und klicken Sie auf OK.

Schritt 2: Erstellen eines Sendeports

  1. Erweitern Sie BizTalk Server Verwaltungdie Optionen 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, Statisch One-Way Sendeport... , um das Dialogfeld Porteigenschaften senden anzuzeigen.

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

  4. Wählen Sie in der Liste der verfügbaren Adapter im Dropdownfeld Typ den TIBCO Rendezvous-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 Eigenschaften des zertifizierten Absenders ein:

    Eigenschaft Wert
    Ledgerdateiname Der Hauptdateiname, der für die Übermittlung persistenter zertifizierter Nachrichten verwendet werden soll.
    Wiederverwendbarer Name Der wiederverwendbare Korrespondentenname, der für die Übermittlung zertifizierter Nachrichten verwendet werden soll. Der Name muss für alle zertifizierten Nachrichtenkorrespondentennamen im Netzwerk eindeutig sein.

  6. Geben Sie Werte für anmeldeinformationen ein:

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

  7. Geben Sie Werte für rendezvousTransport ein:

    Eigenschaft Wert
    Daemon Der Rendezvous-Transportdaemonparameter.
    Netzwerk Der Rendezvous-Transportnetzwerkparameter.
    Dienst Der Rendezvous-Transportdienstparameter.

    Weitere Informationen zu den Eigenschaften finden Sie unter Erstellen der Sendeartefakte.

  8. Klicken Sie auf OK.

  9. Wählen Sie die XML-Übertragungspipeline aus der Liste der Pipelines aus, die in der Dropdownliste Pipeline senden verfügbar sind, und klicken Sie auf OK.

  10. Klicken Sie mit der rechten Maustaste auf den Sendeport, und klicken Sie auf Start , um den Sendeport zu eintragen und zu starten.

Schritt 3: Erstellen eines Empfangsports

  1. Erweitern Sie in BizTalk Server Verwaltung die Optionen 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. TIBCORndOneWayFileRP, und klicken Sie auf OK.

Schritt 4: Erstellen eines Empfangsspeicherorts

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

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

  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 Empfangsordner erstellt haben, und klicken Sie auf OK.

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

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

Schritt 5: Generieren eines Dokuments instance aus dem Schema

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

  2. Klicken Sie im Eigenschaftenfenster, um im Abschnitt Allgemein die Option Dateiname der Ausgabeinstanz 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.

Schritt 6: Aktualisieren des generierten Dokuments instance

  1. Öffnen Sie das generierte Dokument instance in einem Text-Editor (Editor funktioniert), und bearbeiten Sie den Inhalt des Dokuments instance, um sicherzustellen, dass die Daten einen eindeutigen Datensatz im TIBCO-System generieren. Der folgende Code zeigt beispielsweise den ersten Teil der Datendatei:

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

  2. Speichern Sie die geänderte Dokumentinstanz.

Schritt 7: Erstellen und Bereitstellen des Projekts

  1. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf das Projekt OneWaySend, 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 BizTalk-Gruppe ein.

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

Schritt 8: Binden, Eintragen und Starten der Orchestrierung

  1. Erweitern Sie BizTalk Server Verwaltungdie Optionen 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 F5-Taste auf der Tastatur, um die Ansicht BizTalk Server Verwaltungskonsole 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 TIBCORndOneWayFileRP
    TibcoRendezvousSend TIBCORndOneWaySP

  6. Klicken Sie auf OK.

  7. Klicken Sie mit der rechten Maustaste auf die Orchestrierung, und klicken Sie auf Start , um die Orchestrierung ein- und zu starten.

Schritt 9: Ablegen eines Dokuments und Überprüfen des TIBCO-Systems

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

  • Ü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 Rendezvous.

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

Weitere Informationen

Tutorial: Empfangen von Daten mit dem BizTalk-Adapter für TIBCO Rendezvous
Tutorials: Verwenden des Microsoft BizTalk-Adapters für TIBCO Rendezvous
Erste Schritte