Freigeben über

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

  • Artikel

Mit dem BizTalk-Adapter für TIBCO Rendezvous können Sie Daten von einem TIBCO-System empfangen. 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.

Über das Beispiel

  • In diesem Beispiel wird der BizTalk-Adapter für TIBCO Rendezvous verwendet, um Daten von einem TIBCO-System empfangen. Eine Orchestrierung verarbeitet die Nachricht und schreibt die Daten dann mithilfe des Dateiadapters als eine XML-Datei in einen angegebenen Ordner.

  • Dieses Beispiel, das in Visual Studio entwickelt wurde, veranschaulicht grundlegende 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.

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

    Dateiname des Laufzeitprojekts Dateibeschreibung des Laufzeitprojekts
    OneWayReceive.btproj

    OneWayReceive.sln    		 Projekt- und Projektmappendateien für die Anwendung.
    PureMessage.xsd, Schemadatei für die Anwendung.
    TIBCORvOWR.odx Die Orchestrierung, die von der Anwendung verwendet wird.
    TIBCORv.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, z. B. TIBCO Rendezvous.

  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 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. TIBCORvOneWayRP, und klicken Sie auf OK.

Schritt 3: Erstellen eines Empfangsspeicherorts

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

  2. Geben Sie einen Wert für das Feld Name ein. Geben Sie beispielsweise TIBCORvOneWayRL ein.

  3. 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-Adapter in der BizTalk Server-Verwaltungskonsole erstellt wurde.

  4. Geben Sie unter AdapterRequiredProperties einen Wert für RendezvousSubjectName ein.

  5. Geben Sie Werte für die Eigenschaften des zertifizierten Listeners 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 von Empfangsartefakten.

  8. Klicken Sie auf OK.

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

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

Schritt 4: Erstellen eines unidirektionale Sendeports

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

  2. Erweitern Sie in der BizTalk Server Verwaltungskonsole die Optionen 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, Statisch One-Way Sendeport... , um das Dialogfeld Porteigenschaften senden anzuzeigen.

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

  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 XMLTransmit-Pipeline aus der Liste der Pipelines aus, die in der Dropdownliste Pipeline senden verfügbar sind, und klicken Sie auf OK.

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

Schritt 5: 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 die 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 in Projektmappen-Explorer mit der rechten Maustaste auf das OneWayReceive-Projekt, und klicken Sie auf Bereitstellen, um das Projekt zu erstellen und die Assembly in der BizTalk Server Konfigurationsdatenbank bereitzustellen.

Schritt 6: Binden, Eintragen und Starten der Orchestrierung

  1. Erweitern Sie in der BizTalk Server Verwaltungskonsole die Optionen 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 Ansicht der 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
    SendPort TIBCORvOneWayFileSP
    ReceivePort TIBCORvOneWayRP

  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 7: Bestätigen, dass die Anwendung eine Nachricht empfängt

  • Öffnen Sie den Ordner, an den der Dateisendeport für das Senden konfiguriert ist, und überprüfen Sie, ob ein Ausgabedokument generiert wurde.

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

  1. Der TIBCO Rendezvous-Adapter empfängt eine Nachricht aus dem 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: Verwenden des BizTalk-Adapters für TIBCO Rendezvous zum Senden von Daten
Tutorials: Verwenden des Microsoft BizTalk-Adapters für TIBCO Rendezvous
Erste Schritte