Procedura: Selezionare un itinerario usando criteri di regole buiness
Obiettivo
In questa sezione viene illustrato come creare regole business che possono essere usate per selezionare un itinerario in base al contenuto di un messaggio ricevuto e come configurare il componente pipeline del selettore di itinerari all'interno di un itinerario generico su rampa per chiamare queste regole. Questa sezione descrive uno scenario aziendale in cui i messaggi vengono indirizzati in modo diverso, in base all'area in cui risiede il cliente.
In questo argomento di procedura si completeranno i passaggi seguenti:
Itinerari del modello per le divisioni western e orientali della banca globale del cliente.
Creare criteri di regole business che verranno usati per selezionare un itinerario per l'elaborazione della richiesta.
Configurare il componente pipeline del selettore di itinerari per usare i criteri delle regole business per selezionare l'itinerario appropriato.
Prerequisiti
Le procedure descritte in questa procedura richiedono il completamento dei prerequisiti per le attività di sviluppo.
Prima di iniziare
Completare le attività seguenti prima di eseguire i passaggi più avanti in questo argomento procedura:
Creare il messaggio di test di GlobalBank West.
Creare il messaggio di test di GlobalBank East.
Le procedure seguenti descrivono come eseguire ognuna di queste operazioni.
Per creare il messaggio di test di GlobalBank West
In Esplora risorse passare a C:\HowTos.
Creare una copia di NAOrderDoc.xml e quindi denominare la copia West.xml.
Nel Blocco note aprire West.xml e quindi modificare il valore dell'elemento customerName in GlobalBankWest.
Salvare West.xml come UTF-8 e quindi chiudere blocco note.
Per creare il messaggio di test di GlobalBank East
In Esplora risorse passare a C:\HowTos.
Creare una copia di NAOrderDoc.xml e quindi denominare la copia East.xml.
Nel Blocco note aprire East.xml e quindi modificare il valore dell'elemento customerName in GlobalBankEast.
Salvare East.xml come UTF-8 e quindi chiudere blocco note.
Passaggi
Per creare un criterio di business rules engine (BRE) per selezionare un itinerario usando le proprietà personalizzate dei messaggi
Fare clic su Start sulla barra delle applicazioni, scegliere Tutti i programmi, 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 al criterio il nome ResolveItineraryBasedOnCustomer.
Nota
In questo argomento procedure vengono usati gli stessi criteri e gli itinerari delle regole business creati nell'argomento Procedura: Dividere un interscambio e instradare i messaggi risultanti a più percorsi di file usando itinerari distinti. Se la sezione è già stata completata, è possibile passare alla procedura "Per creare e configurare un ESB su rampa" più avanti in questo argomento.
Per aggiungere una regola di selezione per il cliente GlobalBank West
Nel criterio ResolveItineraryBasedOnCustomer fare clic con il pulsante destro del mouse sulla versione 1.0 (non salvata) e quindi scegliere Aggiungi nuova regola. Assegnare alla regola il nome SetGlobalBankWestItinerary.
In Esplora fatti fare clic sulla scheda XML Schema, fare clic con il pulsante destro del mouse su Schemi e quindi scegliere Sfoglia.
Nella finestra di dialogo File schema passare a C:\Projects\Microsoft.Practices.ESB\Source\Samples\DynamicResolution\Source\ESB. DynamicResolution.Schemas, selezionare NAOrderDoc.xsd e quindi fare clic su Apri.
Nota
Si tratta dello schema che definisce il messaggio di NAOrderDoc.xml, usato per creare i messaggi occidentali e orientali che verranno usati per il test.
In Esplora fatti fare clic su NAOrderDoc.xsd, fare clic sulla proprietà Tipo di documento nel riquadro Proprietà e quindi digitare GlobalBank.ESB.DynamicResolution.Schemas.NAOrderDoc.
Nota
Nome completo dello schema.
In Esplora fatti espandere NAOrderDoc.xsd, quindi espandere OrderDoc.
Nella finestra Regola fare clic con il pulsante destro del mouse su Condizioni, scegliere Predicatie quindi fare clic su Uguale.
Da Esplora fatti trascinare l'elemento customerName nel nodo argument1 in Condizioni.
Fare clic sul nodo argument2 e quindi digitare GlobalBankWest.
In Esplora fatti fare clic sulla scheda Vocabolari . Espandere ESB. Vocabolario itinerario , espandere versione 1.1 e quindi trascinare la definizione Imposta nome itinerario in Azioni.
Fare clic su <stringa> vuota e quindi digitare GlobalBankWestItinerary.
Nota
Più avanti in questo argomento di procedura verrà creato questo itinerario per elaborare i messaggi da GlobalBank West.
Per aggiungere una regola di selezione per Customer GlobalBank East
In Esplora criteri fare clic con il pulsante destro del mouse sulla regola SetGlobalBankWestItinerary e quindi scegliere Copia.
Fare clic con il pulsante destro del mouse sulla versione 1.0 (non salvata) e quindi scegliere Incolla.
Nella finestra di dialogo Nuovo nome regola digitare SetGlobalBankEastItinerary, quindi fare clic su OK.
In Esplora criteri fare clic sulla regola SetGlobalBankEastItinerary .
Nella sezione Condizioni fare clic con il pulsante destro del mouse su GlobalBankWest e quindi scegliere Reimposta argomento.
Fare clic su argument2 e quindi digitare GlobalBankEast.
Nella sezione Azioni fare clic con il pulsante destro del mouse su GlobalBankWestItinerary e quindi scegliere Reimposta argomento.
Fare clic su <stringa> vuota e quindi digitare GlobalBankEastItinerary.
Nota
Più avanti nell'argomento Procedura verrà creato questo itinerario per elaborare i messaggi da GlobalBank East.
Per pubblicare e distribuire i criteri
In Esplora criteri, nel criterio ResolveItineraryBasedOnCustomer fare clic con il pulsante destro del mouse sulla versione 1.0 (non salvata) e quindi scegliere Pubblica.
In Esplora criteri, nel criterio ResolveItineraryBasedOnCustomer fare clic con il pulsante destro del mouse sulla versione 1.0 - Pubblicata e quindi scegliere Distribuisci.
Per creare un modello DSL (Domain Specific Language) dell'itinerario ESB per i messaggi GlobalBank West
In Visual Studio aprire C:\HowTos\Patterns\Patterns.sln.
In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto ItinerarioLibrario, scegliere Aggiungi e quindi fare clic su Nuovo itinerario.
Nel riquadro Modelli della finestra di dialogo Aggiungi nuovo elemento fare clic su ItineraryDsl.
Nella casella Nome digitare GlobalBankWestItinerary e quindi fare clic su Aggiungi.
Per configurare le proprietà dell'itinerario GlobalBank West
In Visual Studio fare clic sull'area di progettazione di GlobalBankWestItinerary.itinerary. Nella Finestra Proprietà GlobalBankWestItinerary configurare le proprietà seguenti:
Nell'elenco a discesa Esportazione modelli fare clic su Esportazione itinerari di database.
Fare clic sul pulsante con i puntini di sospensione (...) accanto alla proprietà Database itinerario .
Nella finestra di dialogo Proprietà connessione scegliere il SQL Server che ospita il database del repository dell'itinerario e quindi specificare il nome del database ( il nome predefinito è EsbItineraryDb).
Nell'elenco a discesa Stato itinerario fare clic su Distribuito.
Nota
Questo passaggio consente di esportare l'itinerario in un repository centrale; gli itinerari possono essere selezionati e collegati da questo repository al momento della ricezione dei messaggi. Successivamente si configurerà il componente pipeline del selettore di itinerari per usare il sistema di risoluzione del motore regole business (BRI) per valutare i messaggi in ingresso e selezionare l'itinerario appropriato da questo repository.
Per definire la struttura dell'itinerario
Dalla casella degli strumenti trascinare un elemento del modello On-Ramp nell'area di progettazione. Nel Finestra Proprietà OnRamp1 configurare le proprietà seguenti:
Fare clic sulla proprietà Name e quindi digitare ReceiveNAOrder.
Nell'elenco a discesa Extender fare clic su On-Ramp ESB Service Extension (Estensione servizio ESB).
Nell'elenco a discesa Applicazione BizTalk fare clic su Microsoft.Practices.ESB.
Nell'elenco a discesa Porta di ricezione fare clic su OnRamp.Itinerario.
Dalla Casella degli strumenti trascinare un elemento del modello Off-Ramp nell'area di progettazione e quindi posizionarlo a destra dell'elemento del modello ReceiveNAOrder . Nel Finestra Proprietà OffRamp1 configurare le proprietà seguenti:
Fare clic sulla proprietà Name e quindi digitare SendNAOrder.
Nell'elenco a discesa Extender fare clic su Off-Ramp ESB Service Extension .In the Extender list, click Off-Ramp ESB Service Extension.
Nell'elenco a discesa Applicazione BizTalk fare clic su GlobalBank.ESB.
Nell'elenco a discesa Porta di trasmissione fare clic su DynamicResolutionOneWay.
Dalla casella degli strumenti trascinare un elemento modello Del servizio itinerario nell'area di progettazione e quindi posizionarlo tra l'elemento del modello ReceiveNAOrder e l'elemento del modello SendNAOrder . Nel Finestra Proprietà ItineraryService1 configurare le proprietà seguenti:
Fare clic sulla proprietà Name e quindi digitare RouteMessage.
Nell'elenco a discesa Estensione servizio itinerario fare clic su Off-Ramp Itinerary Service Extension .In the Itinerary Service Extension.
Nell'elenco a discesa Off-Ramp espandere SendNAOrder e quindi fare clic su Gestori di invio.
Fare clic con il pulsante destro del mouse sull'insieme Resolver dell'elemento modello RouteMessage e quindi scegliere Aggiungi nuovo resolver. Nella Finestra Proprietà Resolver1 configurare le proprietà seguenti:
Fare clic sulla proprietà Name e quindi digitare StaticResolver.
Nell'elenco a discesa Implementazione resolver fare clic su Estensione resolver statica.
Nell'elenco a discesa Nome trasporto fare clic su FILE.
Fare clic sulla proprietà Percorso trasporto e quindi digitare C:\HowTos\Out\West%MessageID%.xml.
Nella casella degli strumenti fare clic su Connettore. Trascinare una connessione dall'elemento modello ReceiveNAOrder all'elemento modello RouteMessage .
Nella casella degli strumenti fare clic su Connettore. Trascinare una connessione dall'elemento modello RouteMessage all'elemento modello SendNAOrder .
Per esportare il modello nel database di itinerario
In Visual Studio fare clic con il pulsante destro del mouse sull'area di progettazione dell'itinerario GlobalBankWestItinerary e quindi scegliere Esporta modello.
Nota
L'itinerario è stato esportato nel database itinerario e ora può essere usato dal componente Selettore itinerario.
Salvare tutti gli artefatti del progetto.
Per creare un modello DSL di itinerario ESB per il messaggio GlobalBank East
In Visual Studio aprire C:\HowTos\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 finestra di dialogo Aggiungi nuovo elemento fare clic su ItinerarioDl nel riquadro Modelli.
Nella casella Nome digitare GlobalBankEastItinerary e quindi fare clic su Aggiungi.
Per configurare le proprietà dell'itinerario GlobalBank East
In Visual Studio fare clic sull'area di progettazione di GlobalBankEastItinerary.itinerario. Nella Finestra Proprietà GlobalBankEastItinerary configurare le proprietà seguenti:
Nell'elenco a discesa Esportazione modello fare clic su Esportazione itinerari di database.
Fare clic sul pulsante con i puntini di sospensione (...) accanto alla proprietà Database itinerario .
Nella finestra di dialogo Proprietà connessione scegliere la SQL Server che ospita il database del repository di itinerario e quindi specificare il nome del database ( il nome predefinito è EsbItineraryDb).
Nell'elenco a discesa Stato itinerario fare clic su Distribuito.
Nota
Questo passaggio consente di esportare l'itinerario in un repository centrale; gli itinerari possono essere selezionati e collegati da questo repository quando vengono ricevuti i messaggi. Successivamente verrà configurato il componente pipeline del selettore itinerario per usare il resolver BRI per valutare i messaggi in ingresso e selezionare l'itinerario appropriato da questo repository.
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 ReceiveNAOrder.
Nell'elenco a discesa Extender fare clic su On-Ramp ESB Service Extension (Estensione del servizio ESB).
Nell'elenco a discesa Applicazione BizTalk fare clic su Microsoft.Practices.ESB.
Nell'elenco a discesa Porta di ricezione fare clic su OnRamp.Itinerario.
Dalla casella degli strumenti trascinare un elemento modello Off-Ramp nell'area di progettazione e quindi inserirlo a destra dell'elemento modello ReceiveNAOrder . Nell'Finestra Proprietà OffRamp1 configurare le proprietà seguenti:
Fare clic sulla proprietà Name e quindi digitare SendNAOrder.
Nell'elenco a discesa Extender fare clic su Off-Ramp ESB Service Extension (Estensione del servizio ESB).
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 ReceiveNAOrder e l'elemento modello SendNAOrder . Nell'Finestra Proprietà ItinerarioService1 configurare le proprietà seguenti:
Fare clic sulla proprietà Name e quindi digitare RouteMessage.
Nell'elenco a discesa Estensione servizio itinerario fare clic su Off-Ramp Itinerario Estensione servizio.
Nell'elenco a discesa Off-Ramp espandere SendNAOrder e quindi fare clic su Invia gestori.
Fare clic con il pulsante destro del mouse sull'insieme Resolver dell'elemento modello RouteMessage e quindi scegliere Aggiungi nuovo resolver. Nella Finestra Proprietà Resolver1 configurare le proprietà seguenti:
Fare clic sulla proprietà Name e quindi digitare StaticResolver.
Nell'elenco a discesa Implementazione resolver fare clic su Estensione resolver statica.
Nell'elenco a discesa Nome trasporto fare clic su FILE.
Fare clic sulla proprietà Percorso trasporto e quindi digitare C:\HowTos\Out\East%MessageID%.xml.
Nella casella degli strumenti fare clic su Connettore. Trascinare una connessione dall'elemento modello ReceiveNAOrder all'elemento modello RouteMessage .
Nella casella degli strumenti fare clic su Connettore. Trascinare una connessione dall'elemento modello RouteMessage all'elemento modello SendNAOrder .
Per esportare il modello nel database di itinerario
In Visual Studio fare clic con il pulsante destro del mouse sull'area di progettazione dell'itinerario GlobalBankEastItinerary e quindi scegliere Esporta modello.
Nota
L'itinerario è stato esportato nel database itinerario e ora può essere usato dal componente Selettore itinerario.
Salvare tutti gli artefatti del progetto.
Per creare e configurare un ESB su rampa
Fare clic su Avvia sulla barra delle applicazioni, scegliere Tutti i programmi, scegliere BizTalk Server e quindi fare clic su BizTalk Server Amministrazione.
Nella console di amministrazione BizTalk Server espandere Gruppo BizTalk, espandere Applicazioni e quindi Microsoft.Practices.ESB.
Fare clic con il pulsante destro del mouse su Posizioni di ricezione, scegliere Nuovo e quindi fare clic su Posizione di ricezione unidirezionale.
Nella finestra di dialogo Seleziona porta di ricezione fare clic su OnRamp.Itinerario e quindi fare clic su OK.
Nella finestra di dialogo Proprietà posizione di ricezione digitare OnRamp.Routey.HowTo nella casella Nome.
Nell'elenco a discesa Tipo fare clic su FILE e quindi su Configura.
Nella finestra di dialogo Proprietà trasporto FILE digitare C:\HowTos\DropFolder e quindi fare clic su OK.
Per configurare il componente pipeline del selettore itinerario
Nell'elenco a discesa Ricezione pipeline della finestra di dialogo Proprietà posizione ricezione fare clic su ItinerarioSelectReceiveXml e quindi fare clic sul pulsante con i puntini di sospensione (...).
Usare la finestra di dialogo Configura pipeline per configurare le proprietà del componente selettore itinerario seguenti:
Fare clic sulla proprietà ItinerarioFactKey e quindi digitare Resolver.Itinerario.
Fare clic sulla proprietà ResolverConnectionString e quindi digitare BRI:\\policy=ResolveItineraryBasedOnCustomer; useMsg=true; recognizeMessageFormat=true;
Fare clic su OK per chiudere la finestra di dialogo Configura pipeline .
Fare clic su OK per chiudere la finestra di dialogo Proprietà posizione ricezione .
Nella console di amministrazione di BizTalk Server fare clic con il pulsante destro del mouse sul percorso di ricezione OnRamp.Itinerario.HowTo e quindi scegliere Abilita.
Per testare il selettore di itinerario e le regole aziendali
In Esplora risorse passare a C:\HowTos.
Copiare (non spostare) i file East.xml e West.xml nella cartella DropFolder.
Passare a C:\HowTos\Out. Verificare che i messaggi East%MessageID%.xml e West%MessageID%.xml siano stati scritti nella directory.
Nota
Anche se identico ad eccezione del valore dell'elemento del cliente, i messaggi sono stati elaborati usando itinerari diversi, in base alla risoluzione del componente pipeline del selettore itinerario.
Nella console di amministrazione di BizTalk Server fare clic con il pulsante destro del mouse sul percorso di ricezione OnRamp.Itinerario.HowTo e quindi scegliere Disabilita.
Dopo aver disabilitato la posizione di ricezione OnRamp.Itinerario.HowTo , fare clic con il pulsante destro del mouse su di esso e quindi scegliere Elimina. Nella finestra di dialogo Conferma posizione ricezione eliminazione fare clic su Sì.
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