Procedura: Instradare dinamicamente un messaggio in base al contesto del messaggio usando criteri di regole business
Obiettivo
In questa sezione viene illustrato come creare un itinerario che determina gli endpoint del messaggio, in base alle proprietà del contesto del messaggio, usando un criterio del motore regole di business BizTalk Server (BRE) e quindi instrada il messaggio usando l'adattatore FILE BizTalk Server.
In questo argomento procedura si completeranno i passaggi seguenti:
Creare criteri di regole business per valutare il tipo di messaggio.
Creare una lista di routing di itinerari per instradare dinamicamente usando criteri di regole business.
Testare l'itinerario usando l'applicazione di esempio client di test di itinerario.
Prerequisiti
Le procedure descritte in questo argomento richiedono il completamento dei prerequisiti per le attività di sviluppo.
Passaggi
Per creare un criterio bre per instradare un messaggio usando le proprietà del contesto del messaggio
Fare clic su Avvia sulla barra delle applicazioni, scegliere Tutti i programmi, scegliere BizTalk Server e quindi fare clic su Business Rule Composer.
In Esplora criteri fare clic con il pulsante destro del mouse su Criteri e quindi scegliere Aggiungi nuovo criterio. Assegnare un nome al criterio RouteBasedOnMessageType.
Per aggiungere una regola di routing per gli ordini North American
Nel criterio RouteBasedOnMessageType fare clic con il pulsante destro del mouse sulla versione 1.0 (non salvata) e quindi scegliere Aggiungi nuova regola. Assegnare un nome alla regola SetNAOrderEndpoint.
Nella finestra Regola fare clic con il pulsante destro del mouse su Condizioni, scegliere Predicati e quindi fare clic su Uguale.
In Esplora fatti espandere ESB. Vocabolario ContextInfo , espandere Versione 1.0 e quindi trascinare il fatto Del tipo di messaggio di contesto nel nodo argument1 in Condizioni.
Nota
Microsoft BizTalk ESB Toolkit include diversi vocabolari che possono essere usati per la creazione di regole. Alcuni di questi devono essere sostituiti o incrementati con i propri vocabolari. Ad esempio, i criteri DynamicRunTimeMaptypes hanno definizioni per le mappe fornite negli esempi di GlobalBank .
Fare clic sul nodo argument2 e quindi digitare http://globalbank.esb.dynamicresolution.com/northamericanservices/#OrderDoc
In Esplora fatti espandere ESB. Vocabolario EndPointInfo , espandere Versione 1.0 e quindi trascinare la definizione Imposta percorso trasporto in uscita punto finale in Azioni.
Fare clic su <stringa> vuota e quindi digitare C:\HowTos\Out\NorthAmerica%MessageID%.xml
Da Esplora fatti trascinare la definizione Imposta tipo di trasporto in uscita punto finale su Azioni.
In Esplora fatti espandere ESB. Vocabolario TansportTypes, espandere Versione 1.0 e quindi trascinare la definizione Provider di adattatori in <stringa> vuota.
Nel riquadro Azioni espandere l'elenco a discesa Provider di adattatori e quindi fare clic su FILE.
Per pubblicare e distribuire i criteri
In Esplora criteri, nel criterio RouteBasedOnMessageType fare clic con il pulsante destro del mouse sulla versione 1.0 (non salvata) e quindi scegliere Pubblica.
In Esplora criteri, nel criterio RouteBasedOnMessageType fare clic con il pulsante destro del mouse sulla versione 1.0 - Pubblicata e quindi scegliere Distribuisci.
Per creare un modello di linguaggio specifico del dominio (DSL)
In Visual Studio aprire C:\HowTos\Patterns\Patterns.sln.
In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto ItinerarioLibrary, scegliere Aggiungi e quindi fare clic su Nuovo itinerario.
Nella casella Nome digitare MessageType e quindi fare clic su Aggiungi.
Per configurare le proprietà dell'itinerario
In Visual Studio fare clic sull'area di progettazione di MessageType.route. Nella Finestra Proprietà MessageType configurare le proprietà seguenti:
Nell'elenco a discesa Esportazione modello fare clic su Esportazione itinerari XML.
Nella sezione Impostazioni estensione accanto alla proprietà file XML Itinerario fare clic sul pulsante con i puntini di sospensione (...).
Nella finestra di dialogo Seleziona file XML digitare C:\HowTos\Itinerari\MessageType e quindi fare clic su Salva.
Nota
Questo passaggio consente di esportare l'itinerario come XML in un percorso di file locale. L'esportazione di un itinerario in un percorso di file locale, anziché nel database di itinerario, consente di testare l'itinerario usando l'applicazione Client di test ESB. Questo processo verrà completato più avanti in questo argomento procedura.
Per definire la struttura dell'itinerario
Dalla casella degli strumenti trascinare un elemento modello On-Ramp nell'area di progettazione. Nell'Finestra Proprietà OnRamp1 configurare le proprietà seguenti:
Fare clic sulla proprietà Name e quindi digitare ReceiveOrders.
Nell'elenco a discesa Extender fare clic su On-Ramp ESB Extender.
Nell'elenco a discesa Applicazione BizTalk fare clic su Microsoft.Practices.ESB.
Nell'elenco a discesa Porta di ricezione fare clic su OnRamp.Itinerario.
Nella casella degli strumenti trascinare un elemento modello del servizio itinerario nell'area di progettazione e quindi inserirlo a destra dell'elemento modello On-Ramp . Nell'Finestra Proprietà ItinerarioService1 configurare le proprietà seguenti:
Fare clic sulla proprietà Name e quindi digitare BreRoute.
Nell'elenco a discesa Estensione servizio itinerario fare clic su Estensione messaggistica.
Nota
Questa proprietà definisce che il processo verrà eseguito in una pipeline (messaggistica). In alternativa, se il processo verrà eseguito in un'orchestrazione, impostare la proprietà Extender del servizio itinerario su Orchestration Extender.
Nell'elenco a discesa Contenitore espandere ReceiveOrders e quindi fare clic su Gestori di ricezione.
Nell'elenco a discesa Nome servizio fare clic su Microsoft.Practices.ESB.Services.Routing.
Fare clic con il pulsante destro del mouse sull'insieme Resolver dell'elemento modello BreRoute e quindi scegliere Aggiungi nuovo resolver. Nella Finestra Proprietà Resolver1 configurare le proprietà seguenti:
Fare clic sulla proprietà Name e quindi digitare ByMessageType.
Nell'elenco a discesa Implementazione resolver fare clic su Bre Resolver Extension (Estensione del resolver).
Nell'elenco a discesa Criteri fare clic su RouteBasedOnMessageType v 1.0.
Nella casella degli strumenti fare clic su Connettore. Trascinare una connessione dall'elemento modello ReceiveOrders all'elemento modello BreRoute .
Dalla casella degli strumenti trascinare un elemento modello Off-Ramp nell'area di progettazione e quindi inserirlo a destra dell'elemento modello BreRoute . Nell'Finestra Proprietà OffRamp1 configurare le proprietà seguenti:
Fare clic sulla proprietà Name e quindi digitare SendBasedOnType.
Nell'elenco a discesa Extender fare clic su Off-Ramp ESB Extender.
Nell'elenco a discesa Applicazione BizTalk fare clic su GlobalBank.ESB.
Nell'elenco a discesa Invia porta fare clic su DynamicResolutionOneWay.
Dalla casella degli strumenti trascinare un elemento modello del servizio Itinerario nell'area di progettazione e quindi inserirlo tra l'elemento modello BreRoute e l'elemento modello SendBasedOnType . Nell'Finestra Proprietà ItinerarioService1 configurare le proprietà seguenti:
Fare clic sulla proprietà Name e quindi digitare SendPortFilter.
Nell'elenco a discesa Estensione servizio itinerario fare clic su Off-Ramp Extender.
Nell'elenco a discesa Off-Ramp espandere SendBasedOnType e quindi fare clic su Invia gestori.
Nella casella degli strumenti fare clic su Connettore. Trascinare una connessione dall'elemento modello BreRoute all'elemento modello SendPortFilter .
Nella casella degli strumenti fare clic su Connettore. Trascinare una connessione dall'elemento modello SendPortFilter all'elemento modello SendBasedOnType .
Per esportare il modello da usare con il client di test di itinerario
In Visual Studio fare clic con il pulsante destro del mouse sull'area di progettazione dell'itinerario MessageType e quindi scegliere Esporta modello.
Nota
Viene visualizzata la versione XML dell'itinerario in Visual Studio.
Salvare tutti gli artefatti del progetto.
In Esplora risorse passare a C:\HowTos\Itinerari e notare la creazione del codice XML dell'itinerario (MessageType.xml).
Per testare l'itinerario
Aprire l'applicazione di esempio client di test di itinerario usando il collegamento creato durante i prerequisiti per le attività di sviluppo (C:\HowTos\ESB.Itinerary.Test.exe - Collegamento).
Nel client di test itinerari deselezionare la casella di controllo Usa servizio WCF e quindi fare clic su Carica itinerario.
Nella finestra di dialogo Apri file itinerario passare a C:\HowTos\Itinerari. Selezionare MessageType.xmle quindi fare clic su Apri per caricare l'itinerario.
Fare clic su OK per cancellare il messaggio Itinerario caricato correttamente .
Nel client test itinerari fare clic sul pulsante con i puntini di sospensione (...) accanto alla casella Carica messaggio .
Nella finestra di dialogo Seleziona documento XML da caricare passare a C:\HowTos. Selezionare NAOrderDoc.xmle quindi fare clic su Apri per caricare il messaggio di test.
Fare clic sul pulsante Invia richiesta . Al termine del test, fare clic su OK per ignorare la conferma visualizzata.
In Esplora risorse passare a C:\HowTos\Out\. Verificare che il messaggio NorthAmerica%MessageID%.xml sia stato scritto nella directory.
Risorse aggiuntive
Per altre informazioni, vedere i seguenti argomenti correlati:
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per