Condividi tramite

Procedura: Instradare un singolo messaggio a più destinatari usando una lista di distribuzione dell'itinerario

  • Articolo

Obiettivo

In questa sezione viene illustrato come usare il linguaggio DSL (Domain Specific Language) di Designer per creare un itinerario che instrada un messaggio a tre destinatari distinti usando un resolver statico e l'adattatore FILE BizTalk Server.

In questo argomento di procedura si completeranno i passaggi seguenti:

  • Creare un itinerario con tre resolver statici per instradare i messaggi a più destinatari.

  • Testare l'itinerario usando l'applicazione di esempio Client di test dell'itinerario.

Prerequisiti

Le procedure descritte in questa procedura richiedono il completamento dei prerequisiti per le attività di sviluppo.

Passaggi

Per creare un modello DSL di itinerariO ESB

  1. In Visual Studio aprire C:\HowTos\Patterns\Patterns.sln.

  2. In Esplora soluzioni fare clic con il pulsante destro del mouse su ItinerarioLibrario, scegliere Aggiungi e quindi fare clic su Nuovo itinerario.

  3. Nella finestra di dialogo Aggiungi nuovo elemento fare clic su ItineraryDsl nel riquadro Modelli.

  4. Nella casella Nome digitare RecipientList e quindi fare clic su Aggiungi.

Per configurare le proprietà dell'itinerario

  1. In Visual Studio fare clic sull'area di progettazione di RecipientList.itinerario. Nel Finestra Proprietà RecipientList configurare le proprietà seguenti:

    1. Nell'elenco a discesa Esportazione modelli fare clic su Utilità di esportazione itinerari XML.

    2. Nella sezione Impostazioni extender accanto alla proprietà File XML itinerario fare clic sul pulsante con i puntini di sospensione (...).

    3. Nella finestra di dialogo Seleziona file XML digitare C:\HowTos\Itineraries\RecipientList nella casella Nome file e quindi fare clic su Salva.

      Nota

      Questo passaggio consente di esportare l'itinerario come XML in un percorso di file locale. Esportando un itinerario in un percorso di file locale, anziché nel database dell'itinerario, consente il test dell'itinerario usando l'applicazione client di test ESB. Questo processo verrà completato più avanti in questo argomento relativo alle procedure.

Per definire la struttura dell'itinerario

  1. Dalla casella degli strumenti trascinare un elemento del modello On-Ramp nell'area di progettazione. Nel Finestra Proprietà OnRamp1 configurare le proprietà seguenti:

    1. Fare clic sulla proprietà Name e quindi digitare ReceiveNAOrder.

    2. Nell'elenco a discesa Extender fare clic su On-Ramp Extender.

    3. Nell'elenco a discesa Applicazione BizTalk fare clic su Microsoft.Practices.ESB.

    4. Nell'elenco a discesa Porta di ricezione fare clic su OnRamp.Itinerario.

  2. Dalla casella degli strumenti trascinare un elemento modello Del servizio itinerario nell'area di progettazione e quindi posizionarlo a destra dell'elemento del modello On-Ramp . Nel Finestra Proprietà ItineraryService1 configurare le proprietà seguenti:

    1. Fare clic sulla proprietà Name e quindi digitare RouteToThreeRecipients.

    2. 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 di itinerario su Orchestration Extender.

    3. Nell'elenco a discesa Contenitore espandere ReceiveNaOrderDoc e quindi fare clic su Gestori di ricezione.

    4. Nell'elenco a discesa Nome servizio fare clic su Microsoft.Practices.ESB.Services.Routing.

  3. Fare clic con il pulsante destro del mouse sull'insieme Resolver dell'elemento del modello RouteToThreeRecipients e quindi scegliere Aggiungi nuovo sistema di risoluzione. Nella Finestra Proprietà Resolver1 configurare le proprietà seguenti:

    1. Fare clic sulla proprietà Name e quindi digitare FirstResolver.

    2. Nell'elenco a discesa Implementazione resolver fare clic su Estensione resolver statico.

    3. Nell'elenco a discesa Nome trasporto fare clic su FILE.

    4. Fare clic sulla proprietà Posizione trasporto e quindi digitare C:\HowTos\Out\First%MessageID%.xml.

      Nota

      Sono stati aggiunti i primi tre resolver per questo servizio di itinerario. Verranno ora aggiunti altri due resolver per instradare il messaggio ad altri destinatari.

  4. Fare clic con il pulsante destro del mouse sull'insieme Resolver dell'elemento del modello RouteToThreeRecipients e quindi scegliere Aggiungi nuovo sistema di risoluzione. Nella Finestra Proprietà Resolver1 configurare le proprietà seguenti:

    1. Fare clic sulla proprietà Name e quindi digitare SecondResolver.

    2. Nell'elenco a discesa Implementazione resolver fare clic su Estensione resolver statico.

    3. Nell'elenco a discesa Nome trasporto fare clic su FILE.

    4. Fare clic sulla proprietà Percorso trasporto e quindi digitare C:\HowTos\Out\Second%MessageID%.xml.

  5. Fare clic con il pulsante destro del mouse sull'insieme Resolver dell'elemento del modello RouteToThreeRecipients e quindi scegliere Aggiungi nuovo sistema di risoluzione. Nella Finestra Proprietà Resolver1 configurare le proprietà seguenti:

    1. Fare clic sulla proprietà Name e quindi digitare ThirdResolver.

    2. Nell'elenco a discesa Implementazione resolver fare clic su Estensione resolver statico.

    3. Nell'elenco a discesa Nome trasporto fare clic su FILE.

    4. Fare clic sulla proprietà Posizione trasporto e quindi digitare C:\HowTos\Out\Third%MessageID%.xml.

  6. Nella casella degli strumenti fare clic su Connettore. Trascinare una connessione dall'elemento del modello ReceiveNAOrder all'elemento del modello RouteToThreeRecipients .

  7. Dalla casella degli strumenti trascinare un elemento del modello Off-Ramp nell'area di progettazione e quindi posizionarlo a destra dell'elemento del modello RouteToThreeRecipients . Nel Finestra Proprietà OffRamp1 configurare le proprietà seguenti:

    1. Fare clic sulla proprietà Name e quindi digitare SendThreeMessages.

    2. Nell'elenco a discesa Extender fare clic su Off-Ramp ESB Extender.

    3. Nell'elenco a discesa Applicazione BizTalk fare clic su GlobalBank.ESB.

    4. Nell'elenco a discesa Porta di trasmissione fare clic su DynamicResolutionOneWay.

  8. Dalla casella degli strumenti trascinare un elemento modello Del servizio itinerario nell'area di progettazione e quindi posizionarlo tra l'elemento modello RouteToThreeRecipients e l'elemento modello SendThreeMessages . Nel Finestra Proprietà ItineraryService1 configurare le proprietà seguenti:

    1. Fare clic sulla proprietà Name e quindi digitare SendPortFilter.

    2. Nell'elenco a discesa Estensione servizio itinerario fare clic su Off-Ramp Extender.

    3. Nell'elenco a discesa Off-Ramp espandere SendThreeMessages e quindi fare clic su Invia gestori.

  9. Nella casella degli strumenti fare clic su Connettore. Trascinare una connessione dall'elemento del modello RouteToThreeRecipients all'elemento del modello SendPortFilter .

  10. Nella casella degli strumenti fare clic su Connettore. Trascinare una connessione dall'elemento del modello SendPortFilter all'elemento del modello SendThreeMessages .

Per esportare il modello da usare con il client di test dell'itinerario

  1. In Visual Studio fare clic con il pulsante destro del mouse sull'area di progettazione dell'itinerario RecipientList e quindi scegliere Esporta modello.

    Nota

    Viene aperta la versione XML dell'itinerario in Visual Studio.

  2. Salvare tutti gli artefatti del progetto.

  3. In Esplora risorse passare a C:\HowTos\Itineraries e quindi notare la creazione del codice XML dell'itinerario (RecipientList.xml).

Per testare l'itinerario

  1. Aprire l'applicazione di esempio Client di test dell'itinerario usando il collegamento creato durante i prerequisiti per le attività di sviluppo (C:\HowTos\ESB.Itinerary.Test.exe - Collegamento).

  2. Nel client di test dell'itinerario deselezionare la casella di controllo Usa servizio WCF e quindi fare clic su Carica itinerario.

  3. Nella finestra di dialogo Apri file itinerari passare a C:\HowTos\Itineraries. Selezionare RecipientList.xmle quindi fare clic su Apri per caricare l'itinerario.

  4. Fare clic su OK per cancellare il messaggio "Itinerario caricato correttamente: .

  5. Nel client di test dell'itinerario fare clic sul pulsante con i puntini di sospensione (...) accanto alla finestra Carica messaggio .

  6. Nella finestra di dialogo Seleziona documento XML da caricare passare a C:\Patterns. Selezionare NAOrderDoc.xml e quindi fare clic su Apri per caricare il messaggio di test.

  7. Fare clic sul pulsante Invia richiesta . Al termine del test, fare clic su OK per ignorare la conferma visualizzata.

  8. In Esplora risorse passare a C:\HowTos\Out\. Verificare che nella directory siano stati scritti i messaggi seguenti:

    • First%MessageID%.xml

    • Second%MessageID%.xml

    • Terzo%MessageID%.xml

Risorse aggiuntive

Per altre informazioni, vedere i seguenti argomenti correlati: