Condividi tramite

Procedura: Abilitare il rilevamento BAM in un servizio di itinerari ESB

  • Articolo

Obiettivo

Questa sezione illustra come abilitare il rilevamento BAM (Business Activity Monitor) per un itinerario esistente.

In questo argomento di procedura si completeranno i passaggi seguenti:

  • Abilitare la proprietà utilizzata per tenere traccia dei servizi di itinerario usando Monitoraggio attività business.

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

  • Verificare i risultati BAM usando una query SQL.

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 un modello DSL (Domain Specific Language) dell'itinerario ESB.

  • Configurare le proprietà dell'itinerario.

  • Definire la struttura dell'itinerario.

    Le procedure seguenti descrivono come eseguire ognuna di queste operazioni.

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 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 BamTracking e quindi fare clic su Aggiungi.

Per configurare le proprietà dell'itinerario

  1. In Visual Studio fare clic sull'area di progettazione di BamTracking.route. Nel Finestra Proprietà BamTracking 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\BamTracking 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 ESB Service Extension (Estensione 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. 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 MapNAOrderToCNOrder.

    2. Nell'elenco a discesa Estensione servizio itinerario fare clic su Estensione servizio itinerari di 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 Estensione del servizio di itinerario di orchestrazione.

    3. Nell'elenco a discesa Contenitore espandere ReceiveNAOrdere 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 del modello MapNAOrderToCNOrder 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 StaticallySpecifyTheMap.

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

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

    4. Nell'elenco a discesa TransportName fare clic su FILE.

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

  5. Dalla Casella degli strumenti trascinare un elemento del modello Off-Ramp nell'area di progettazione e quindi posizionarlo a destra dell'elemento del modello MapNAOrderToCNOrder . Nel 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 Service Extension .In the Extender list, click Off-Ramp ESB Service Extension.

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

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

  6. Dalla casella degli strumenti trascinare un elemento modello Del servizio itinerario nell'area di progettazione e quindi posizionarlo tra l'elemento del modello MapNAOrderToCNOrder e l'elemento del modello SendCNOrder . 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 Itinerary Service Extension .In the Itinerary Service Extension.

    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 del modello SendPortFilter 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 ConfigureFolderSettings.

    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\BAM%MessageID%.xml

      Nota

      Ogni off-rampa avrà un servizio di itinerario associato; 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 del modello MapNAOrderToCNOrder all'elemento del modello SendPortFilter .

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

  10. Salvare tutti gli artefatti del progetto.

Passaggi

Per modificare l'itinerario

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

  2. In Esplora soluzioni fare doppio clic su BamTracking.route.

  3. Fare clic sull'elemento del servizio itinerario MapNAOrderToCNOrder .

  4. Nell'Finestra Proprietà MapNAOrderToCNOrder fare clic su True nell'elenco a discesa Rilevamento abilitato.

  5. Fare clic sull'elemento del servizio di itinerario SendPortFilter .

  6. Nella Finestra Proprietà SendPortFilter fare clic su True nell'elenco a discesa Rilevamento abilitato.

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 BamTracking 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 notare la creazione del codice XML dell'itinerario (BamTracking.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 BamTracking.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:\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 BAM%MessageID%.xml sia stato scritto nella directory.

Per verificare il rilevamento dei messaggi

  1. Fare clic su Start sulla barra delle applicazioni, scegliere Tutti i programmi, SQL Server 2014 o SQL Server 2012 SP1 e quindi fare clic su SQL Server Management Studio.

  2. Fare clic su Nuova query.

  3. Nel riquadro della query digitare quanto segue:

    SELECT *  
FROM [BAMPrimaryImport].[dbo].[bam_ItineraryServiceActivity_Completed]  
GO

  4. Fare clic su Execute.

  5. Nel riquadro Risultati usare la colonna TimeStamp per individuare la voce più recente.

Risorse aggiuntive

Per altre informazioni, vedere i seguenti argomenti correlati: