Condividi tramite

Procedura: Trasformare un messaggio e instradare il messaggio risultante a un percorso di file usando una lista di distribuzione dell'itinerario

  • Articolo

Obiettivo

Questa sezione illustra come usare il linguaggio specifico del dominio (DSL) ESB Designer per creare un itinerario che implementa la trasformazione dei messaggi richiamando una mappa BizTalk e quindi instrada i messaggi usando l'adapter FILE di Microsoft BizTalk ESB Toolkit.

In questo argomento procedura si completeranno i passaggi seguenti:

  • Creare una lista di routing itinerario con un servizio di itinerario di trasformazione che implementa una mappa BizTalk.

  • Configurare l'itinerario per instradare il messaggio trasformato a un percorso di file.

  • 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 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 sul progetto ItinerarioLibrary, scegliere Aggiungi e quindi fare clic su Nuovo itinerario.

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

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

Per configurare le proprietà dell'itinerario

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

    1. Nell'elenco a discesa Esportazione modello fare clic su Esportazione itinerari XML.

    2. Nella sezione Impostazioni estensione 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\DataModelTransformation 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 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

  1. Dalla casella degli strumenti trascinare un elemento modello On-Ramp nell'area di progettazione. Nell'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 ESB Service Extension (Estensione del servizio ESB).

    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. 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:

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

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

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

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

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

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

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

    3. Nell'elenco a discesa Trasforma tipo fare clic su GlobalBank.ESB.DynamicResolution.Transforms.SubmitOrderRequestNA_To_SubmitOrderRequestCN.

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

  4. Nella casella degli strumenti fare clic su Connettore. Trascinare una connessione dall'elemento modello ReceiveNAOrder all'elemento modello MapNAOrderToCNOrder .

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

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

    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 Invia porta fare clic su DynamicResolutionOneWay.

  6. Dalla casella degli strumenti trascinare un elemento modello del servizio itinerario nell'area di progettazione e quindi inserirlo tra l'elemento del modello MapNAOrderToCNOrder e l'elemento modello SendCNOrder . Nell'Finestra Proprietà ItinerarioService1 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 SendCNOrder e quindi fare clic su Invia gestori.

  7. Fare clic con il pulsante destro del mouse sull'insieme Resolver dell'elemento modello SendPortFilter e quindi scegliere Aggiungi nuovo resolver. Nella Finestra Proprietà Resolver1 configurare le proprietà seguenti:

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

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

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

      Nota

      Ogni rampa fuori rampa avrà un servizio itinerario associato a esso; la combinazione delle proprietà del servizio itinerario e delle proprietà della rampa off-ramp definiscono la sottoscrizione della porta di trasmissione dinamica.

  8. Nella casella degli strumenti fare clic su Connettore. Trascinare una connessione dall'elemento modello MapNAOrderToCNOrder all'elemento modello SendPortFilter .

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

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

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

    Nota

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

  2. Salvare tutti gli artefatti del progetto.

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

Per testare l'itinerario

  1. 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).

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

  3. Nella finestra di dialogo Apri file itinerario passare a C:\HowTos\Itinerari. Selezionare DataModelTransformation.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 test itinerari fare clic sul pulsante con i puntini di sospensione (...) accanto alla casella Carica messaggio .

  6. 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.

  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 il messaggio %MessageID%.xml sia stato scritto nella directory.

Risorse aggiuntive

Per altre informazioni, vedere questi argomenti correlati:

  1. Procedura: Suddividere un interscambio e instradare i messaggi risultanti a più percorsi di file usando itinerari distinti

  2. Attività di sviluppo

  3. Modelli di trasformazione del messaggio