Tutorial: Verwenden von TIBCO EMS-Nachrichtendeskriptoren

Überblick

Dieses Lernprogramm demonstriert, wie Sie mithilfe von BizTalk Server-Kontexteigenschaften Message Descriptor-Felder für TIBCO Enterprise Message Service (EMS) in Ihrer Orchestrierung festlegen können. Es wird vorausgesetzt, dass Sie eine Orchestrierung besitzen, die eine Nachricht von einem Empfangsport empfängt und an einen Sendeport sendet, der an einen Microsoft BizTalk-Adapter für TIBCO Enterprise Message Service gebunden ist.

Das folgende Verfahren veranschaulicht, wie die Priorität der TIBCO EMS-Nachricht durch Ändern des Werts der Kontexteigenschaft "TibcoEMS.Priority" geändert wird. In BizTalk Server sind Nachrichten unveränderbar. Daher müssen Sie zum Ändern eines Eigenschaftswerts eine neue Nachricht erstellen und ändern. Sie erstellen und ändern die neue Nachricht, indem Sie zwischen den Formen "Empfangen" und "Senden" eine Form vom Typ "Nachrichtenzuweisung" einfügen. Zuerst müssen Sie jedoch auf die Schema-DLL verweisen, um Zugriff auf die TIBCO EMS-Eigenschaften zu erhalten.

Verweisen auf die Schema-DLL

1. Öffnen Sie in Visual Studio Ihr BizTalk Server-Projekt, und öffnen Sie Projektmappen-Explorer .

2. Klicken Sie mit der rechten Maustaste auf Verweise, und wählen Sie Verweis hinzufügen aus.

   Das Dialogfeld Verweis hinzufügen wird angezeigt.

3. Klicken Sie auf die Registerkarte Durchsuchen .

   Das Dialogfeld Komponente auswählen wird angezeigt.

4. Suchen Sie <TIBCO EMS_Adapter_installation_directory>\bin, und wählen Sie dann Microsoft.Adapters.TibcoEMSProperties.dllaus.

5. Klicken Sie auf Öffnen.

   Die DLL wird im Dialogfeld Verweis hinzufügen in den ausgewählten Komponenten angezeigt.

6. Klicken Sie auf OK, und doppelklicken Sie dann auf Ihre Orchestrierung, um auf die Orchestrierungs-Designer zuzugreifen.

7. Zeigen Sie im Menü Ansicht auf Andere Fenster, und klicken Sie dann auf Orchestrierungsansicht.

8. Klicken Sie in der Orchestrierungsansicht mit der rechten Maustaste auf Nachrichten , und wählen Sie Neue Nachricht aus.

9. Bearbeiten Sie ihre neuen Nachrichteneigenschaften, und weisen Sie einen Nachrichtentyp zu.

   Der "Message_2" wird "Message_1" zugewiesen. Deshalb müssen Sie beiden Nachrichten denselben Nachrichtentyp zuweisen.

10. Klicken Sie im Menü Ansicht auf Toolbox.

11. Ziehen Sie ein Nachrichtenzuweisungs-Shape auf die Orchestrierung, an der Sie eine neue Nachricht erstellen möchten.

12. Bearbeiten Sie die äußere ConstructMessage_1 Form, und wählen Sie ihre neue Nachricht Message_2 in der Eigenschaft Konstruierte Nachrichten aus.

13. Doppelklicken Sie auf die innere "MessageAssignment_1"-Form.

    Der BizTalk-Ausdrucks-Editor wird angezeigt.

14. Geben Sie im BizTalk-Ausdrucks-Editor Ihren Code ein.

15. Kopieren Sie zuerst eine vorhandene Nachricht, und weisen Sie dann den Kontexteigenschaften der Nachricht Werte zu.

    Die Syntax ist Message(property) = value;. Zum Beispiel:

    Message_2 = Message_1;  
    Message_2( TibcoEMS.Priority) = 6;  
    

    Eine Liste der unterstützten Eigenschaften, die in Ihrer benutzerdefinierten Nachricht verwendet werden können, finden Sie unter TIBCO EMS.

16. Klicken Sie auf OK , um den BizTalk-Ausdrucks-Editor zu schließen und Ihren Code zu speichern.

17. Klicken Sie auf das Shape Senden, und weisen Sie die Nachricht Message_2 zu.

18. Überprüfen Sie, dass die Formen im restlichen Nachrichtenfluss die richtige Nachricht verarbeiten.

19. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt, und wählen Sie Erstellen aus.

20. Klicken Sie mit der rechten Maustaste auf Ihr Projekt, und wählen Sie Bereitstellen aus.

21. Wählen Sie binden, eintragen und starten im BizTalk-Explorer aus, um Ihre Orchestrierung zu testen.

Weitere Informationen

EIGENSCHAFTEN DES TIBCO EMS-Nachrichtenkontexts