Esercitazione: Usare descrittori di messaggi TIBCO EMS
Panoramica
In questa esercitazione viene illustrato l'utilizzo delle proprietà di contesto di BizTalk Server per impostare campi di descrizione dei messaggi di TIBCO Enterprise Message Service (EMS) nell'orchestrazione. Si presuppone che si disponga di un'orchestrazione che riceve un messaggio da una porta di ricezione e lo invia alla porta di trasmissione associata all'adapter Microsoft BizTalk per TIBCO Enterprise Message Service.
Nella procedura seguente viene illustrato come cambiare la priorità del messaggio di TIBCO EMS modificando il valore della proprietà di contesto TibcoEMS.Priority. In BizTalk Server i messaggi non sono modificabili. Di conseguenza, per modificare il valore di una proprietà, è necessario creare e modificare un nuovo messaggio. Per creare e modificare il nuovo messaggio, inserire una forma Assegnazione messaggio tra le forme Ricezione e Trasmissione. Prima di eseguire questa operazione, è tuttavia necessario fare riferimento alla DLL dello schema per ottenere accesso alle proprietà di TIBCO EMS.
Fare riferimento alla DLL dello schema
In Visual Studio aprire il progetto BizTalk Server e aprire Esplora soluzioni .
Fare clic con il pulsante destro del mouse su Riferimenti e scegliere Aggiungi riferimento.
Verrà visualizzata la finestra di dialogo Aggiungi riferimento.
Fare clic sulla scheda Sfoglia .
Viene visualizzata la finestra di dialogo Seleziona componente .
Individuare <TIBCO EMS_Adapter_installation_directory>\bin e quindi selezionare Microsoft.Adapters.TibcoEMSProperties.dll.
Fare clic su Apri.
La DLL viene visualizzata nella finestra di dialogo Componenti selezionati della finestra di dialogo Aggiungi riferimento .
Fare clic su OK e quindi fare doppio clic sull'orchestrazione per accedere al Designer orchestrazione.
Scegliere Altre finestre dal menu Visualizza e quindi fare clic su Visualizzazione orchestrazione.
Nella visualizzazione Orchestrazione fare clic con il pulsante destro del mouse su Messaggi e scegliere Nuovo messaggio.
Modificare le nuove proprietà del messaggio e assegnare un tipo di messaggio.
L'utente assegnerà Message_1 a Message_2. Pertanto, è necessario assegnare lo stesso tipo ad entrambi i messaggi.
Scegliere Casella degli strumenti dal menu Visualizza.
Trascinare una forma Assegnazione messaggi nell'orchestrazione in cui si vuole creare un nuovo messaggio.
Modificare la forma ConstructMessage_1 esterna e selezionare il nuovo messaggio, Message_2, nella proprietà Messaggi costruiti .
Fare doppio clic sulla forma MessageAssignment_1 interna.
Verrà visualizzato l'Editor espressioni BizTalk.
Nell'Editor espressioni BizTalk digitare il codice.
Copiare un messaggio esistente e quindi assegnare valori alle relative proprietà di contesto.
La sintassi è
Message(property) = value;. Ad esempio:Message_2 = Message_1; Message_2( TibcoEMS.Priority) = 6;Per un elenco delle proprietà supportate che è possibile utilizzare nel messaggio personalizzato, vedere TIBCO EMS.
Fare clic su OK per chiudere l'Editor espressioni BizTalk e salvare il codice.
Fare clic sulla forma Invia e assegnare il messaggio da Message_2.
Verificare che le forme nel resto del flusso messaggi agiscano sul messaggio appropriato.
Fare clic con il pulsante destro del mouse sul progetto in Esplora soluzioni e scegliere Compila.
Fare clic con il pulsante destro del mouse sul progetto e scegliere Distribuisci.
Selezionare Bind, Enlist e Start in BizTalk Explorer per testare l'orchestrazione.