Procedura: Suddividere un interscambio e instradare i messaggi risultanti a più percorsi di file usando itinerari distinti
Obiettivo
In questa sezione viene illustrato come creare una rampa on-ramp ESB che usa la pipeline ItinerarySelectReceiveXml e come configurare i componenti della pipeline per suddividere un interscambio in ingresso e selezionare la lista di distribuzione appropriata per ogni messaggio risultante, in base al contesto del messaggio. La selezione dell'itinerario verrà risolta usando un criterio delle regole business e i messaggi verranno instradati in modo diverso in base all'area in cui risiede il cliente.
In questo argomento di procedura si completeranno i passaggi seguenti:
Creare una ESB su rampa che divide un interscambio XML.
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 gli artefatti necessari.
Aggiungere un progetto di schemi alla soluzione Patterns.
Aggiungere gli artefatti al progetto Schemi.
Creare un criterio BRE per selezionare un itinerario usando le proprietà personalizzate dei messaggi.
Aggiungere una regola di selezione per il cliente GlobalBank West.
Aggiungere una regola di selezione per customer GlobalBank East.
Pubblicare e distribuire i criteri.
Creare un modello DSL (Domain Specific Language) dell'itinerario ESB per i messaggi GlobalBank West.
Configurare le proprietà dell'itinerario GlobalBank West.
Definire la struttura dell'itinerario GlobalBank West.
Esportare il modello GlobalBank West nel database dell'itinerario.
Creare un modello DSL di itinerario ESB per i messaggi GlobalBank East.
Configurare le proprietà dell'itinerario GlobalBank East.
Definire la struttura dell'itinerario GlobalBank East.
Esportare il modello GlobalBank East nel database dell'itinerario.
Le procedure seguenti descrivono come eseguire ognuna di queste operazioni.
Per creare gli artefatti necessari
In Esplora risorse passare a C:\HowTos.
Creare un nuovo documento di testo denominato OrderDocEnvelope.xsd.
Aprire lo schema OrderDocEnvelope.xsd nel Blocco note.
Modificare il documento usando il codice seguente.
<?xml version="1.0" ?> <xs:schema xmlns:ns0="http://globalbank.esb.dynamicresolution.com/northamericanservices/" xmlns:b="http://schemas.microsoft.com/BizTalk/2003" xmlns="http://ESB.BizUnit.Map.Test" targetNamespace="http://ESB.BizUnit.Map.Test" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:import schemaLocation="GlobalBank.ESB.DynamicResolution.Schemas.NAOrderDoc" namespace="http://globalbank.esb.dynamicresolution.com/northamericanservices/" /> <xs:annotation> <xs:appinfo> <b:schemaInfo is_envelope="yes" xmlns:b="http://schemas.microsoft.com/BizTalk/2003" /> <b:references> <b:reference targetNamespace="http://globalbank.esb.dynamicresolution.com/northamericanservices/" /> </b:references> </xs:appinfo> </xs:annotation> <xs:element name="OrderEnvelope"> <xs:annotation> <xs:appinfo> <b:recordInfo body_xpath="/*[local-name()='OrderEnvelope' and namespace-uri()='http://ESB.BizUnit.Map.Test']" /> </xs:appinfo> </xs:annotation> <xs:complexType> <xs:sequence> <xs:element ref="ns0:OrderDoc" /> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>Salvare OrderDocEnvelope.xsd come UTF-8 e quindi chiudere blocco note.
Nella cartella C:\HowTos creare un nuovo documento di testo denominato Batch.xml.
Nel Blocco note aprire Batch.xml.
Modificare il documento usando il codice seguente.
<?xml version="1.0" ?> <ns0:OrderEnvelope xmlns:ns0="http://ESB.BizUnit.Map.Test"> <ns0:OrderDoc xmlns:ns0="http://globalbank.esb.dynamicresolution.com/northamericanservices/"> <ns0:customerName>GlobalBankWest</ns0:customerName> <ns0:ID>ns0:ID_0</ns0:ID> <ns0:requestType>10</ns0:requestType> </ns0:OrderDoc> <ns0:OrderDoc xmlns:ns0="http://globalbank.esb.dynamicresolution.com/northamericanservices/"> <ns0:customerName>GlobalBankEast</ns0:customerName> <ns0:ID>ns0:ID_0</ns0:ID> <ns0:requestType>11</ns0:requestType> </ns0:OrderDoc> <ns0:OrderDoc xmlns:ns0="http://globalbank.esb.dynamicresolution.com/northamericanservices/"> <ns0:customerName>GlobalBankEast</ns0:customerName> <ns0:ID>ns0:ID_0</ns0:ID> <ns0:requestType>12</ns0:requestType> </ns0:OrderDoc> </ns0:OrderEnvelope>Salvare e chiudere Batch.xml.
Per aggiungere un progetto di schemi alla soluzione Patterns
In Visual Studio aprire C:\HowTos\Patterns\Patterns.sln.
In Esplora soluzioni fare clic con il pulsante destro del mouse su Soluzione "Modelli", scegliere Aggiungi e quindi fare clic su Nuovo progetto.
Nel riquadro Tipi di progetto della finestra di dialogo Aggiungi nuovo progetto fare clic su Progetti BizTalk e quindi eseguire le operazioni seguenti:
Nel riquadro Modelli fare clic su Vuoto BizTalk Server Progetto.
Nella casella Nome digitare Patterns.Schemas e quindi fare clic su OK.
In Esplora soluzioni fare clic con il pulsante destro del mouse su Patterns.Schemas e quindi scegliere Proprietà.
Nella scheda Firma della Finestra Proprietà selezionare la casella di controllo Firma assembly.
Nell'elenco a discesa Scegliere un file di chiave con nome sicuro fare clic su <Nuovo.>
Nella finestra di dialogo Crea chiave con nome sicuro configurare le proprietà seguenti:
Nella casella Nome file chiave digitare Divisione.
Deselezionare la casella di controllo Proteggi file di chiave con una password e quindi fare clic su OK.
Nella casella Nome applicazione della scheda Distribuzione della Finestra Proprietà digitare Microsoft.Practices.ESB nella scheda Distribuzione.
Chiudere la finestra Proprietà.
Per aggiungere gli artefatti al progetto Schemi
In Esplora soluzioni fare clic con il pulsante destro del mouse su Patterns.Schemas e quindi scegliere Aggiungi riferimento.
Nella scheda Sfoglia della finestra di dialogo Aggiungi riferimento passare a e selezionare C:\Projects\Microsoft.Practices.ESB\Source\Samples\DynamicResolution\Source\ESB.DynamicResolution.Schemas\bin\Debug\GlobalBank.ESB.DynamicResolution.Schemas.dll, quindi fare clic su OK.
In Esplora soluzioni fare clic con il pulsante destro del mouse su Patterns.Schemas, scegliere Aggiungie quindi fare clic su Elemento esistente.
Nella finestra di dialogo Aggiungi elemento esistente passare a e selezionare C:\HowTos\OrderDocEnvelope.xsd, quindi fare clic su Aggiungi.
Salvare tutti gli artefatti della soluzione.
In Esplora soluzioni fare clic con il pulsante destro del mouse su Patterns.Schemas e quindi scegliere Distribuisci.
Nota
In questo argomento procedure vengono usati gli stessi criteri e gli itinerari delle regole business creati nell'argomento Procedura: Selezionare un itinerario usando un criterio delle regole business . Se la sezione non è già stata completata, completare i passaggi aggiuntivi seguenti. Se la sezione è stata completata, passare direttamente alla sezione "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.
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 il cliente 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 in questo argomento di 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 sulla versione 1.0 (non salvata) e quindi su Pubblica.
In Esplora criteri, sotto il criterio ResolveItineraryBasedOnCustomer , fare clic su Versione 1.0 - Pubblicata e quindi fare clic su Distribuisci.
Per creare un modello DSL di 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; è possibile selezionare e allegare itinerari da questo repository quando vengono ricevuti i messaggi. Successivamente si configurerà il componente pipeline del selettore di itinerari per usare il sistema di risoluzione BRI per valutare i messaggi in ingresso e selezionare l'itinerario appropriato da questo repository.
Per definire la struttura dell'itinerario GlobalBank West
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 . Nella finestra delle 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 sistema di risoluzione. 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 statico.
Nell'elenco a discesa Nome trasporto fare clic su FILE.
Fare clic sulla proprietà Posizione trasporto e quindi digitare C:\HowTos\Out\West%MessageID%.xml.
Nella casella degli strumenti fare clic su Connettore. Trascinare una connessione dall'elemento del modello ReceiveNAOrder all'elemento del modello RouteMessage .
Nella casella degli strumenti fare clic su Connettore. Trascinare una connessione dall'elemento del modello RouteMessage all'elemento del modello SendNAOrder .
Per esportare il modello GlobalBank West nel database dell'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 dell'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 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 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.itinerary. Nella Finestra Proprietà GlobalBankEastItinerary 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; è possibile selezionare e allegare itinerari da questo repository quando vengono ricevuti i messaggi. Successivamente si configurerà il componente pipeline del selettore di itinerari per usare il sistema di risoluzione BRI per valutare i messaggi in ingresso e selezionare l'itinerario appropriato da questo repository.
Per definire la struttura dell'itinerario GlobalBank East
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 sistema di risoluzione. 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 statico.
Nell'elenco a discesa Nome trasporto fare clic su FILE.
Fare clic sulla proprietà Posizione trasporto e quindi digitare C:\HowTos\Out\East%MessageID%.xml.
Nella casella degli strumenti fare clic su Connettore. Trascinare una connessione dall'elemento del modello ReceiveNAOrder all'elemento del modello RouteMessage .
Nella casella degli strumenti fare clic su Connettore. Trascinare una connessione dall'elemento del modello RouteMessage all'elemento del modello SendNAOrder .
Per esportare il modello GlobalBank East nel database dell'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 dell'itinerario e ora può essere usato dal componente Selettore itinerario.
Salvare tutti gli artefatti del progetto.
Passaggi
Per creare e configurare un'istanza di ESB su rampa
Fare clic su Start sulla barra delle applicazioni, scegliere Tutti i programmi, BizTalk Server e quindi fare clic su BizTalk Server Amministrazione.
Nella console di amministrazione di BizTalk Server espandere Gruppo BizTalk, 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
Nella finestra di dialogo Proprietà posizione ricezione fare clic su ItinerarioSelectReceiveXml nell'elenco a discesa Ricezione pipeline 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 .
Nota
Poiché questa posizione di ricezione sta smontando un interscambio XML, non è necessaria alcuna configurazione del componente disassembler XML.
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 itinerario e le regole di business
In Esplora risorse passare a C:\HowTos.
Copiare (non spostare) Batch.xml nella cartella DropFolder.
Passare a C:\HowTos\Out. Verificare che un messaggio West%MessageID%.xml e due messaggi East%MessageID%.xml siano stati scritti nella directory.
Nota
Anche se i messaggi sono identici ad eccezione del valore dell'elemento del cliente, 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 sulla posizione 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