Freigeben über

Vorgehensweise: Konvertieren eines Textdokuments in XML und Routing an einen Dateispeicherort mithilfe eines programmablaufbasierten Verteilers

  • Artikel

Zielsetzung

Der Abschnitt veranschaulicht, wie Sie eine Pipeline erstellen, die ein Textdokument in XML konvertiert, dann die entsprechende Reiseroute auswählt und die Nachricht an einen FILE-Speicherort weitergibt.

In diesem How-to-Thema führen Sie die folgenden Schritte aus:

  • Verwenden Sie eine Pipeline, um ein Flatfiledokument zu empfangen und in XML zu konvertieren.

  • Konfigurieren Sie die Pipelinekomponente Programmablaufauswahl, um den entsprechenden Verteiler aufzulösen.

  • Erstellen Sie eine On-Ramp, die die benutzerdefinierte Pipeline verwendet.

  • Testen des routingbasierten Routings einer Flatfilenachricht.

Voraussetzungen

Die Verfahren in diesem How-to-Thema erfordern den Abschluss der Voraussetzungen für die Entwicklungsaktivitäten.

Vorbereitungen

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

  • Stellen Sie die DataFormatTransformation-Reiseroute bereit.

  • Erstellen Sie die Testnachricht.

    In den folgenden Verfahren wird beschrieben, wie sie jeweils ausgeführt werden.

So stellen Sie die DataFormatTransformation-Reiseroute bereit

  1. Öffnen Sie in Visual Studio C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation\DataFormatTransformation.sln.

  2. Doppelklicken Sie in Projektmappen-Explorer im Projekt Itinerary.Library auf DataFormatTransformation.itinerary, um es im Designer Itinerary zu öffnen.

  3. Klicken Sie in Visual Studio auf die Entwurfsoberfläche von DataFormatTransformation.itinerary. Konfigurieren Sie im Eigenschaftenfenster DataFormatTransformation.itinerary die folgenden Eigenschaften:

    1. Klicken Sie in der Dropdownliste Reiseverlaufsstatus auf Bereitgestellt.

    2. Klicken Sie in der Dropdownliste Modellexporter auf Datenbankroutenexporter.

    3. Klicken Sie neben der Eigenschaft Itinerary Database auf die Schaltfläche mit den Auslassungspunkten (...).

    4. Wählen Sie im Dialogfeld Verbindungseigenschaften die SQL Server aus, die die Repositorydatenbank der Reiseroute hostet, und geben Sie dann den Namen der Datenbank an (der Standardname lautet EsbItineraryDb).

  4. Speichern Sie alle Projektartefakte.

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

So erstellen Sie die Empfangspipeline

  1. Klicken Sie in Visual Studio mit der rechten Maustaste auf DataFormatTransformation.Schemas, und klicken Sie dann auf Eigenschaften. Klicken Sie auf Anwendung, und geben Sie globalBank.ESB.DataFormatTransformation.Schemas in das Feld Assemblyname ein.

  2. Klicken Sie mit der rechten Maustaste auf DataFormatTransformation.Schemas, und klicken Sie dann auf Eigenschaften. Klicken Sie auf Signieren, und vergewissern Sie sich dann, dass das Kontrollkästchen Assembly signieren aktiviert ist und dass der Assemblyspeicherort auf .\. verweist. \.. \.. \.. \.. \keys\Microsoft.Practices.ESB.snk.

  3. Klicken Sie mit der rechten Maustaste auf DataFormatTransformation.Pipelines, und klicken Sie dann auf Entfernen.

  4. Klicken Sie mit der rechten Maustaste auf DataFormatTransformation, zeigen Sie auf Hinzufügen, und klicken Sie dann auf Neues Projekt. Klicken Sie auf Biztalk-Projekte und dann auf Leeres Biztalk Server-Projekt. Geben Sie im Feld Nameden Namen DataFormatTransformationReceive.Pipeline ein.

  5. Klicken Sie mit der rechten Maustaste auf DataFormatTransformationReceive.Pipeline, und klicken Sie dann auf Eigenschaften. Klicken Sie auf Signieren, und überprüfen Sie dann, ob das Kontrollkästchen Assembly signieren aktiviert ist und der Assemblyspeicherort auf C:\projects\Microsoft.Practices.ESB\keys\Microsoft.Practices.ESB.snk verweist.

  6. Klicken Sie mit der rechten Maustaste auf DataFormatTransformationReceive.Pipeline, zeigen Sie auf Hinzufügen, und klicken Sie dann auf Neues Element.

  7. Klicken Sie im Dialogfeld Neues Element hinzufügen im Bereich Vorlagen auf Empfangspipeline . Geben Sie im Feld Nameden Namen ItinerarySelectReceiveFF ein, und klicken Sie dann auf Hinzufügen.

  8. Klicken Sie mit der rechten Maustaste auf Verweise für das Projekt DataFormatTransformationReceive.Pipeline, und klicken Sie dann auf Verweis hinzufügen. Klicken Sie auf die Registerkarte Projekte und dann auf DataFormatTransformation.Schemas. Klicken Sie auf OK , um den Verweis hinzuzufügen.

  9. Ziehen Sie aus der Toolbox eine Pipelinekomponente des Flatfile-Disassemblers in die Disassemblierungsphase der Pipeline.

  10. Klicken Sie im Eigenschaftenfenster für die Flatfile-Disassemblierung in der Dropdownliste Dokumentschema auf DataModelTransformation.Schemas.NAOrderDocFF.

  11. Ziehen Sie aus der Toolbox eine Pipelinekomponente der ESB-Programmplanungsauswahl in die Phase Partei auflösen der Pipeline.

  12. Ziehen Sie aus der Toolbox eine ESB Dispatcher-Pipelinekomponente in die Phase Partei auflösen der Pipeline, und platzieren Sie sie dann unter der Pipelinekomponente ESB-Programmablaufauswahl .

  13. Speichern Sie alle Projektartefakte.

So erstellen Sie die Testnachricht

  1. Klicken Sie einmal in die Schemadatei NAOrderDocFF.xsd des Projekts DataFormatTransformation.Schemas. Ändern Sie im Bereich Eigenschaften von Visual Studio die folgenden beiden Eigenschaften:

    • Generieren des Instanzausgabetyps. Klicken Sie auf die Dropdownliste für diese Eigenschaft, um sie in nativ zu ändern.

    • Dateiname der Ausgabeinstanz. Klicken Sie für diese Eigenschaft auf die Schaltfläche mit den Auslassungspunkten (...), und übernehmen Sie den Standardpfad C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation. Geben Sie im Feld Dateiname den NamenNAOrderDocFF ein, und klicken Sie dann auf Speichern.

  2. Klicken Sie mit der rechten Maustaste unter DataFormatTransformation.Schemas auf NAOrderDocFF.xsd, und klicken Sie dann auf Instanz generieren. An diesem Punkt sollte eine neue Datei im Verzeichnis C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation generiert werden.

  3. Kopieren Sie die Datei NAOrderDocFF.txt aus C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation nach C:\HowTos.

    Hinweis

    Dies ist die Nachricht, die Sie erhalten und in XML konvertieren. Dieses Dokument stellt eine Flatfileversion des North American Order-Dokuments dar.

Schritte

So stellen Sie die Empfangspipeline und das Schema bereit

  1. Klicken Sie mit der rechten Maustaste auf DataFormatTransformationReceive.Pipeline, und klicken Sie dann auf Eigenschaften. Klicken Sie auf Bereitstellung, und geben Sie dann Microsoft.Practices.ESB in das Feld Anwendungsname ein.

  2. Klicken Sie mit der rechten Maustaste auf das Projekt DataFormatTransformation.Schemas , und klicken Sie dann auf Eigenschaften. Klicken Sie auf Bereitstellung, und geben Sie dann Microsoft.Practices.ESB in das Feld Anwendungsname ein.

  3. Schließen Sie die Eigenschaftenbereiche für DataFormatTransformationReceive.Pipeline und DataFormatTransformation.Schemas.

  4. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf das Projekt DataFormatTransformation, und klicken Sie dann auf Projektmappe bereitstellen.

So erstellen und konfigurieren Sie eine ESB-Einrichtung

  1. Klicken Sie auf der Taskleiste auf Start, zeigen Sie auf Alle Programme, zeigen Sie auf BizTalk Server, und klicken Sie dann auf BizTalk Server Verwaltung.

  2. Erweitern Sie in der BizTalk Server Verwaltungskonsole die Option BizTalk-Gruppe, erweitern Sie Anwendungen, und klicken Sie dann auf Microsoft.Practices.ESB.

  3. Klicken Sie mit der rechten Maustaste auf Empfangsspeicherorte, zeigen Sie auf Neu, und klicken Sie dann auf Unidirektionale Empfangsadresse.

  4. Klicken Sie im Dialogfeld Empfangsport auswählen auf OnRamp.Itinerary, und klicken Sie dann auf OK.

  5. Geben Sie im Dialogfeld Eigenschaften des Empfangsspeicherorts im Feld Nameden Namen OnRamp.Itinerary.FlatFile.FILE ein.

  6. Klicken Sie in der Dropdownliste Typ auf DATEI, und klicken Sie dann auf Konfigurieren.

  7. Geben Sie im Dialogfeld Dateitransporteigenschaften im Feld Empfangsordnerden Wert C:\HowTos\DropFolder ein.

  8. Geben Sie im Dialogfeld Dateitransporteigenschaften im Feld Dateiformat*.txtein, und klicken Sie dann auf OK.

So konfigurieren Sie die Pipelinekomponente "Programmablaufauswahl"

  1. Klicken Sie im Dialogfeld Eigenschaften des Empfangsspeicherorts in der Dropdownliste Empfangspipeline auf ItinerarySelectReceiveFF, und klicken Sie dann auf die Schaltfläche mit den Auslassungspunkten (...).

  2. Verwenden Sie das Dialogfeld Pipeline konfigurieren , um die folgenden Komponenteneigenschaften der Programmablaufauswahl zu konfigurieren:

    1. Klicken Sie auf die Eigenschaft ItineraryFactKey , und geben Sie Resolver.Itinerary ein.

    2. Klicken Sie auf die ResolverConnectionString-Eigenschaft , geben Sie ITINERARY:\\name=DataFormatTransformation ein, und klicken Sie dann auf OK.

  3. Klicken Sie auf OK , um das Dialogfeld Eigenschaften des Empfangsspeicherorts zu schließen.

  4. Klicken Sie in der BizTalk Server Verwaltungskonsole mit der rechten Maustaste auf den Empfangsspeicherort OnRamp.Itinerary.FlatFile.FILE, und klicken Sie dann auf Aktivieren.

So testen Sie das programmbasierte Routing einer Flatfilenachricht

  1. Navigieren Sie in Windows Explorer zu C:\HowTos.

  2. Kopieren (nicht verschieben) NAOrderDocFF.txt nach C:\HowTos\DropFolder.

  3. Navigieren Sie zu C:\HowTos\Out. Überprüfen Sie, ob die DFT%MessageID%.xml-Nachricht in das Verzeichnis geschrieben wurde.

  4. Klicken Sie in der BizTalk Server Verwaltungskonsole mit der rechten Maustaste auf den Empfangsspeicherort OnRamp.Itinerary.FlatFile.FILE, und klicken Sie dann auf Deaktivieren.

  5. Nachdem der Empfangsspeicherort OnRamp.Itinerary.FlatFile.FILE deaktiviert wurde, klicken Sie mit der rechten Maustaste darauf, und klicken Sie dann auf Löschen. Klicken Sie im Dialogfeld Löschspeicherort bestätigen auf Ja.

Weitere Ressourcen

Weitere Informationen finden Sie in folgenden verwandten Themen: