Freigeben über

Anleitung: Eine einzelne Nachricht an mehrere Empfänger mithilfe eines Routenplanungszettels weiterleiten

Ziel

In diesem Abschnitt wird die Verwendung der domänenspezifischen Designer-Sprache (DSL) zum Erstellen einer Reiseroute veranschaulicht, die eine Nachricht mithilfe eines statischen Resolvers und des BizTalk Server FILE-Adapters an drei unterschiedliche Empfänger weitergibt.

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

  • Erstellen Sie eine Reiseroute mit drei statischen Resolvern, um Nachrichten an mehrere Empfänger weiterzuleiten.

  • Testen Sie die Reiseroute mithilfe der Beispielanwendung "Routey Test Client".

Voraussetzungen

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

Schritte

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 "ItineraryLibrary", zeigen Sie auf "Hinzufügen", und klicken Sie dann auf "Neues Reiseprogramm".

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

  4. Geben Sie im Feld "Name" "RecipientList" 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 RecipientList.itinerary. Konfigurieren Sie im Fenster "RecipientList-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\RecipientList" 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 Extender“.

    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 RouteToThreeRecipients ein.

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

      Hinweis

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

    3. Erweitern Sie in der Dropdownliste Container den Eintrag ReceiveNaOrderDoc, und klicken Sie dann auf Empfangshandler.

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

  3. Klicken Sie mit der rechten Maustaste auf die Resolver-Auflistung des RouteToThrecipients-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 "FirstResolver" 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\First%MessageID%.xml ein.

      Hinweis

      Sie haben den ersten von drei Resolvern für diesen Reiseplandienst hinzugefügt. Sie fügen nun zwei weitere Resolver hinzu, um die Nachricht an weitere Empfänger weiterzuleiten.

  4. Klicken Sie mit der rechten Maustaste auf die Resolver-Auflistung des RouteToThrecipients-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 SecondResolver 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\Second%MessageID%.xml ein.

  5. Klicken Sie mit der rechten Maustaste auf die Resolver-Auflistung des RouteToThrecipients-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 " ThirdResolver" 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\Third%MessageID%.xml ein.

  6. Klicken Sie in der Toolbox auf "Verbinder". Ziehen Sie eine Verbindung aus dem ReceiveNAOrder-Modellelement in das RouteToThreeRecipients-Modellelement .

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

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

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

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

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

  8. Ziehen Sie aus der Toolbox ein Modellelement des Reiseroutendiensts auf die Entwurfsoberfläche, und platzieren Sie es dann zwischen dem Modellelement RouteToThreeRecipients und dem SendThreeMessages-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 "Itinerary Service Extender" auf Off-Ramp Extender.

    3. In der Dropdownliste Off-Ramp erweitern Sie SendThreeMessages, und klicken Sie dann auf Handler senden.

  9. Klicken Sie in der Toolbox auf "Verbinder". Ziehen Sie eine Verbindung vom Modellelement RouteToThreeRecipients zum SendPortFilter-Modellelement.

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

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 RecipientList-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 then notice the creation of your itinerary XML (RecipientList.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 RecipientList.xmlaus, und klicken Sie dann auf "Öffnen ", um die Reiseroute zu laden.

  4. Klicken Sie auf 'OK ', um die Meldung "Reiseroute erfolgreich geladen: Nachricht" 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:\Patterns". 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\". Stellen Sie sicher, dass die folgenden Nachrichten in das Verzeichnis geschrieben wurden:

    • Erster%MessageID%.xml

    • Zweite%MessageID%.xml

    • Dritte%MessageID%.xml

Zusätzliche Ressourcen

Weitere Informationen finden Sie in folgenden verwandten Themen: