Lernprogramm: Verwenden von TIBCO EMS-Nachrichtendeskriptoren

Überblick

In diesem Tutorial wird die Verwendung von BizTalk Server-Kontexteigenschaften erläutert, um die Nachrichtenbeschreibungsfelder des TIBCO Enterprise Message Service (EMS) in Ihrer Orchestrierung festzulegen. Im Lernprogramm wird davon ausgegangen, dass Sie über eine Orchestrierung verfügen, die eine Nachricht von einem Empfangsport empfängt und die Nachricht an einen Sendeport sendet, der an den Microsoft BizTalk Adapter für TIBCO Enterprise Message Service gebunden ist.

Das folgende Verfahren veranschaulicht, wie die Priorität der TIBCO EMS-Nachricht geändert wird, indem der Wert der TibcoEMS.Priority-Kontexteigenschaft geändert wird. In BizTalk Server sind Nachrichten unveränderlich. Um einen Eigenschaftswert zu ändern, müssen Sie daher eine neue Nachricht erstellen und ändern. Sie erstellen und ändern die neue Nachricht, indem Sie ein Nachrichtenzuweisungs-Shape zwischen den Empfangs- und Sende-Shapes einfügen. Zunächst müssen Sie jedoch auf die Schema-DLL verweisen, um Zugriff auf die TIBCO EMS-Eigenschaften zu erhalten.

Auf die Schema-DLL verweisen

1. Öffnen Sie in Visual Studio Ihr BizTalk Server-Projekt, und öffnen Sie den 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 den Orchestration 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.

   Sie werden Message_1 an Message_2 zuweisen. Daher 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, in der Sie eine neue Nachricht erstellen möchten.

12. Bearbeiten Sie das äußere ConstructMessage_1-Shape 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 Nachrichtenkontexteigenschaften Werte zu.

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

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

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

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

17. Klicken Sie auf die "Senden"-Form und weisen Sie der Nachricht die Bezeichnung Message_2 zu.

18. Stellen Sie sicher, dass die Shapes im restlichen Nachrichtenfluss über die entsprechende Nachricht ausgeführt werden.

19. Klicken Sie im 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", "Registrieren" und "Starten" im BizTalk-Explorer aus, um Ihre Orchestrierung zu testen.

Siehe auch

TIBCO EMS-Nachrichtenkontexteigenschaften