Freigeben über

Anleitung: So aktivieren Sie die BAM-Verfolgung in einem ESB-Itinerariedienst

Ziel

In diesem Abschnitt wird veranschaulicht, wie Sie die Überwachung von Business Activity Monitor (BAM) für eine vorhandene Reiseroute aktivieren.

In diesem Thema "Anleitungen" führen Sie die folgenden Schritte aus:

  • Aktivieren Sie die Eigenschaft, die zum Nachverfolgen von Reiseroutendiensten mit dem Business Activity Monitor verwendet wird.

  • Testen Sie die BAM-Nachverfolgung mithilfe der Beispielanwendung "Routey Test Client".

  • Überprüfen Sie die BAM-Ergebnisse mithilfe einer SQL-Abfrage.

Voraussetzungen

Die Verfahren in diesem Thema "Anleitungen" erfordern den Abschluss der Voraussetzungen für die Entwicklungsaktivitäten.

Bevor Sie beginnen

Führen Sie die folgenden Aufgaben aus, bevor Sie die Schritte weiter unten in diesem Thema "Anleitungen" ausführen:

  • Erstellen Sie ein domänenspezifisches ESB-Routenmodell (DSL).

  • Konfigurieren Sie die Eigenschaften der Reiseroute.

  • Definieren Sie die Struktur der Reiseroute.

    In den folgenden Verfahren wird beschrieben, wie Sie die einzelnen Schritte ausführen.

So erstellen Sie ein ESB-Ablauf-DSL-Modell

  1. Öffnen Sie in Visual Studio C:\HowTos\Patterns\Patterns.sln.

  2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das ItineraryLibrary-Projekt, zeigen Sie auf "Hinzufügen", und klicken Sie dann auf "Neue Reiseroute".

  3. Klicken Sie im Dialogfeld " Neues Element hinzufügen " im Bereich "Vorlagen" auf "RouteyDsl ".

  4. Geben Sie im Feld "Name " den Namen "BamTracking" ein, und klicken Sie dann auf "Hinzufügen".

So konfigurieren Sie die Eigenschaften der Reiseroute

  1. Klicken Sie in Visual Studio auf die Entwurfsoberfläche von BamTracking.itinerary. Konfigurieren Sie im Fenster " BamTracking-Eigenschaften " die folgenden Eigenschaften:

    1. Klicken Sie in der Dropdownliste "Modellexporteur " auf "XML-Reiseroutenexporteur".

    2. Klicken Sie im Abschnitt " Extender-Einstellungen" neben der Eigenschaft "Reiserouten-XML-Datei " auf die Schaltfläche mit den Auslassungspunkten (...).

    3. Geben Sie im Dialogfeld "XML-Datei auswählen " im Feld "Dateiname " "C:\HowTos\Reiserouten\BamTracking " ein, und klicken Sie dann auf " Speichern".

      Hinweis

      Mit diesem Schritt können Sie die Reiseroute als XML in einen lokalen Dateispeicherort exportieren. Durch das Exportieren einer Reiseroute an einen lokalen Dateispeicherort statt in die Reiseroutendatenbank können Sie die Reiseroute mithilfe der ESB-Testclientanwendung testen. Sie werden diesen Prozess später in diesem How-to-Thema abschließen.

Die Struktur der Reiseroute definieren

  1. Ziehen Sie ein On-Ramp-Modellelement aus der Toolbox auf die Entwurfsoberfläche. Konfigurieren Sie im Fenster " OnRamp1-Eigenschaften " die folgenden Eigenschaften:

    1. Klicken Sie auf die Name-Eigenschaft , und geben Sie " ReceiveNAOrder" ein.

    2. Klicken Sie in der Dropdownliste "Extender " auf " On-Ramp ESB-Diensterweiterung".

    3. Klicken Sie in der Dropdownliste " BizTalk Application " auf "Microsoft.Practices.ESB".

    4. Klicken Sie in der Dropdownliste Empfangsport auf „OnRamp.Itinerary“.

  2. Ziehen Sie aus der Toolbox ein Modellelement des Reiseroutendiensts auf die Entwurfsoberfläche, und platzieren Sie es dann rechts neben dem On-Ramp-Modellelement . Konfigurieren Sie im Fenster " ItineraryService1-Eigenschaften " die folgenden Eigenschaften:

    1. Klicken Sie auf die Name-Eigenschaft , und geben Sie dann MapNAOrderToCNOrder ein.

    2. Klicken Sie in der Dropdownliste "Routey Service Extender " auf "Messaging Routey Service Extension".

      Hinweis

      Diese Eigenschaft definiert, dass der Prozess in einer Pipeline (Messaging) stattfindet. Wenn der Prozess in einer Orchestrierung stattfindet, legen Sie die Eigenschaft Itinerary Service Extender auf Orchestration Itinerary Service Extension fest.

    3. Erweitern Sie in der Dropdownliste Container den Eintrag ReceiveNAOrder, und klicken Sie dann auf Receive Handlers.

    4. Klicken Sie in der Dropdownliste " Dienstname " auf "Microsoft.Practices.ESB.Services.Transform".

  3. Klicken Sie mit der rechten Maustaste auf die Resolver-Auflistung des MapNAOrderToCNOrder-Modellelements , und klicken Sie dann auf "Neuen Resolver hinzufügen". Konfigurieren Sie im Fenster "Resolver1-Eigenschaften " die folgenden Eigenschaften:

    1. Klicken Sie auf die Name-Eigenschaft , und geben Sie " StaticallySpecifyTheMap" ein.

    2. Klicken Sie in der Dropdownliste "Resolver-Implementierung" auf "Statische Resolver-Erweiterung".

    3. Klicken Sie in der Dropdown-Liste Transformationstyp auf GlobalBank.ESB.DynamicResolution.Transforms.SubmitOrderRequestNA_To_SubmitOrderRequestCN.

    4. Klicken Sie in der Dropdownliste "TransportName " auf "DATEI".

  4. Klicken Sie in der Toolbox auf "Verbinder". Ziehen Sie eine Verbindung vom ReceiveNAOrder-Modellelement zum MapNAOrderToCNOrder-Modellelement.

  5. Ziehen Sie aus der Toolbox ein Off-Ramp-Modellelement auf die Entwurfsoberfläche, und platzieren Sie es dann rechts neben dem MapNAOrderToCNOrder-Modellelement . Konfigurieren Sie im Fenster "OffRamp1-Eigenschaften " die folgenden Eigenschaften:

    1. Klicken Sie auf die Name-Eigenschaft , und geben Sie " SendCNOrder" ein.

    2. Klicken Sie in der Dropdownliste "Extender " auf Off-Ramp ESB-Diensterweiterung.

    3. Klicken Sie in der Dropdownliste "BizTalk Application" auf "GlobalBank.ESB".

    4. Klicken Sie in der Dropdownliste " Port senden " auf "DynamicResolutionOneWay".

  6. Ziehen Sie aus der Toolbox ein Modellelement des Reiseroutendiensts auf die Entwurfsoberfläche, und platzieren Sie es dann zwischen dem MapNAOrderToCNOrder-Modellelement und dem SendCNOrder-Modellelement . Konfigurieren Sie im Fenster " ItineraryService1-Eigenschaften " die folgenden Eigenschaften:

    1. Klicken Sie auf die Name-Eigenschaft , und geben Sie " SendPortFilter" ein.

    2. Klicken Sie in der Dropdownliste "Reiseroutendienst-Erweiterer" auf Off-Ramp Reiseroutendienst-Erweiterung.

    3. Erweitern Sie in der Dropdownliste Off-RampSendCNOrder und klicken Sie dann auf Send Handlers.

  7. Klicken Sie mit der rechten Maustaste auf die Resolver-Auflistung des SendPortFilter-Modellelements , und klicken Sie dann auf "Neuen Resolver hinzufügen". Konfigurieren Sie im Fenster "Resolver1-Eigenschaften " die folgenden Eigenschaften:

    1. Klicken Sie auf die Name-Eigenschaft , und geben Sie dann ConfigureFolderSettings ein.

    2. Klicken Sie in der Dropdownliste "Resolver-Implementierung" auf "Statische Resolver-Erweiterung".

    3. Klicken Sie in der Dropdownliste Transport Name auf "DATEI".

    4. Klicken Sie auf die Eigenschaft "Transportspeicherort", und geben Sie dann C:\HowTos\Out\BAM%MessageID%.xml ein.

      Hinweis

      Jede Ausstiegsstelle hat einen Reiseroutendienst zugeordnet; die Kombination der Eigenschaften des Reiseroutendiensts und der Eigenschaften der Ausstiegsstelle definieren das Abonnement des dynamischen Sendeports.

  8. Klicken Sie in der Toolbox auf "Verbinder". Ziehen Sie eine Verbindung von dem MapNAOrderToCNOrder-Modellelement zu dem SendPortFilter-Modellelement.

  9. Klicken Sie in der Toolbox auf "Verbinder". Ziehen Sie eine Verbindung aus dem SendPortFilter-Modellelement in das SendCNOrder-Modellelement .

  10. Speichern Sie alle Projektartefakte.

Schritte

So ändern Sie die Reiseroute

  1. Öffnen Sie in Visual Studio C:\HowTos\Patterns\Patterns.sln.

  2. Doppelklicken Sie im Projektmappen-Explorer auf BamTracking.itinerary.

  3. Klicken Sie auf das MapNAOrderToCNOrder-Routendienstelement .

  4. Klicken Sie im Fenster "MapNAOrderToCNOrder-Eigenschaften" in der Dropdownliste "Nachverfolgung aktiviert" auf "True".

  5. Klicken Sie auf das SendPortFilter-Routendienstelement .

  6. Klicken Sie im Fenster "SendPortFilter-Eigenschaften" in der Dropdownliste "Nachverfolgung aktiviert" auf "True".

So exportieren Sie das Modell für die Verwendung mit dem Reiserouten-Testclient.

  1. Klicken Sie in Visual Studio mit der rechten Maustaste auf die Entwurfsoberfläche der BamTracking-Reiseroute , und klicken Sie dann auf "Modell exportieren".

    Hinweis

    Die XML-Version der Reiseroute wird in Visual Studio geöffnet.

  2. Speichern Sie alle Projektartefakte.

  3. Navigieren Sie im Windows-Explorer zu C:\HowTos\Itineraries and notice the creation of your itinerary XML (BamTracking.xml).

Die Reiseroute testen

  1. Öffnen Sie die Beispielanwendung "Itinerary Test Client" mithilfe der Verknüpfung, die während der Voraussetzungen für die Entwicklungsaktivitäten erstellt wurde (C:\HowTos\ESB.Itinerary.Test.exe - Verknüpfung).

  2. Deaktivieren Sie im Testclient "Reiseroute" das Kontrollkästchen "WCF-Dienst verwenden ", und klicken Sie dann auf " Reiseroute laden".

  3. Navigieren Sie im Dialogfeld "Itinerary-Datei öffnen" zu "C:\HowTos\Itineraries". Wählen Sie BamTracking.xmlaus, und klicken Sie dann auf "Öffnen ", um die Reiseroute zu laden.

  4. Klicken Sie auf "OK ", um die Nachricht "Route erfolgreich geladen " zu löschen.

  5. Klicken Sie im Testclient der Reiseroute auf die Schaltfläche mit den Auslassungspunkten (...) neben dem Feld "Nachricht laden".

  6. Navigieren Sie im Dialogfeld " XML-Dokument zum Laden auswählen " zu "C:\HowTos". Wählen Sie NAOrderDoc.xmlaus, und klicken Sie dann auf "Öffnen ", um die Testnachricht zu laden.

  7. Klicken Sie auf die Schaltfläche " Anforderung senden ". Wenn der Test abgeschlossen ist, klicken Sie auf "OK ", um die angezeigte Bestätigung zu schließen.

  8. Navigieren Sie im Windows Explorer zu C:\HowTos\Out. Verify that the BAM%MessageID%.xml, wo die Nachricht in das Verzeichnis geschrieben wurde.

So überprüfen Sie die Nachrichtenverfolgung

  1. Klicken Sie auf der Taskleiste auf "Start ", zeigen Sie auf "Alle Programme", zeigen Sie auf SQL Server 2014 oder SQL Server 2012 SP1, und klicken Sie dann auf SQL Server Management Studio.

  2. Klicken Sie auf "Neue Abfrage".

  3. Geben Sie im Abfragebereich Folgendes ein:

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

  4. Klicken Sie auf Ausführen.

  5. Verwenden Sie im Bereich "Ergebnisse" die Spalte "TimeStamp ", um den letzten Eintrag zu suchen.

Zusätzliche Ressourcen

Weitere Informationen finden Sie in folgenden verwandten Themen: