Freigeben über

Wie man ein Textdokument in XML konvertiert und an einen Dateispeicherort mithilfe eines Itinerary Routing Slip weiterleitet.

Ziel

Im Abschnitt wird veranschaulicht, wie Sie eine Pipeline erstellen, die ein Textdokument in XML konvertiert und dann die entsprechende Reiseroute auswählt und die Nachricht an einen DATEI-Speicherort weiterleiten kann.

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

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

  • Konfigurieren Sie die Pipelinekomponente "Itinerary Selector", um den entsprechenden Laufzettel aufzulösen.

  • Erstellen Sie eine Rampe, die die benutzerdefinierte Pipeline verwendet.

  • Testen Sie das routenbasierte Routing einer Flachdateinachricht.

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:

  • Bereitstellen der DataFormatTransformation-Routenbeschreibung.

  • Erstellen Sie die Testnachricht.

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

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 im Projektmappen-Explorer im Projekt Itinerary.Library auf "DataFormatTransformation.itinerary", um sie im Itinerary-Designer zu öffnen.

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

    1. Klicken Sie in der Dropdownliste "Reiseroutenstatus" auf "Eingesetzt".

    2. Klicken Sie in der Dropdownliste "Modellexporteur " auf "Datenbankroutenexporteur".

    3. Klicken Sie auf die Schaltfläche mit den Auslassungspunkten (...) neben dem Feld „Reisedatenbank“.

    4. Wählen Sie im Dialogfeld "Verbindungseigenschaften " den SQL Server aus, der die Datenbank für das Routenrepository hostt, 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 dann "GlobalBank.ESB.DataFormatTransformation.Schemas" im Feld "Assemblyname " ein.

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

  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 klicken Sie dann auf Leeres Biztalk Server-Projekt. Geben Sie im Feld "Name"DataFormatTransformationReceive.Pipeline ein.

  5. Klicken Sie mit der rechten Maustaste auf DataFormatTransformationReceive.Pipeline, und klicken Sie dann auf "Eigenschaften". Klicken Sie auf " Signieren", und stellen Sie dann sicher, dass das Kontrollkästchen "Assembly signieren " aktiviert ist und dass 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. Im Dialogfeld "Neues Element hinzufügen" klicken Sie im Bereich "Vorlagen" auf "Empfangen-Pipeline". Geben Sie im Feld "Name""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 Flat-File-Disassembler-Pipelinekomponente in die Disassemblierungsphase der Pipeline.

  10. Klicken Sie im Fenster "Eigenschaften" für die Flache Dateidemontage in der Dropdownliste "Dokumentschema" auf "DataModelTransformation.Schemas.NAOrderDocFF".

  11. Ziehen Sie aus der Toolbox eine ESB Itinerary Selector-Pipelinekomponente in die Resolve Party-Phase der Pipeline.

  12. Ziehen Sie aus der Toolbox eine ESB Dispatcher-Pipelinekomponente in die Phase "Resolve Party" der Pipeline und platzieren Sie sie dann unter der ESB Itinerary Selector-Pipelinekomponente.

  13. Speichern Sie alle Projektartefakte.

So erstellen Sie die Testnachricht

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

    • Instanzausgabetyp generieren. Klicken Sie auf die Dropdownliste für diese Eigenschaft, um sie in "Native" zu ändern.

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

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

  3. Kopieren (nicht verschieben) Sie die NAOrderDocFF.txt Datei aus C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation in C:\HowTos.

    Hinweis

    Dies ist die Nachricht, die Sie empfangen und in XML konvertieren. Dieses Dokument stellt eine flache Dateiversion des nordamerikanischen Auftragsdokuments 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 im Projektmappen-Explorer mit der rechten Maustaste auf das DataFormatTransformation-Projekt, und klicken Sie dann auf Lösung bereitstellen.

So erstellen und konfigurieren Sie eine ESB-Einstiegsstelle

  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 Administration".

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

  3. Klicken Sie mit der rechten Maustaste auf "Empfangsorte", zeigen Sie auf "Neu", und klicken Sie dann auf "Unidirektionaler Empfangsort".

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

  5. Geben Sie im Dialogfeld Eigenschaften des Empfangsstandorts im Feld NameOnRamp.Itinerary.FlatFile.FILE ein.

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

  7. Geben Sie im Dialogfeld DATEItransporteigenschaften im Feld EingangsordnerC:\HowTos\DropFolder ein.

  8. Geben Sie im Dialogfeld DATEI-Transporteigenschaften, in das Feld Dateimaske*.txt ein, und klicken Sie dann auf OK.

So konfigurieren Sie die Pipelinekomponente "Routey Selector"

  1. Klicken Sie im Dialogfeld "Standorteigenschaften empfangen" 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 Eigenschaften der Reiseroutenauswahl zu konfigurieren:

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

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

  3. Klicken Sie auf OK, um das Dialogfeld Empfangsort-Einstellungen zu schließen.

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

So testen Sie das routenbasierte Routing einer Flachdateinachricht

  1. Navigieren Sie im Windows-Explorer zu "C:\HowTos".

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

  3. Navigieren Sie zu C:\HowTos\Out. Verify that the DFT%MessageID%.xml Nachricht wurde in das Verzeichnis geschrieben.

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

  5. Nachdem die Eingangsposition "OnRamp.Itinerary.FlatFile.FILE" deaktiviert wurde, klicken Sie mit der rechten Maustaste darauf und wählen Sie dann Löschen aus. Klicken Sie im Dialogfeld "Löschen des Empfangsorts bestätigen" auf Ja.

Zusätzliche Ressourcen

Weitere Informationen finden Sie in folgenden verwandten Themen: