Freigeben über

Exemplarische Vorgehensweise: Erstellen eines Flatfile-Schemas aus einer Dokumentinstanz

  • Artikel

In dieser exemplarischen Vorgehensweise wird veranschaulicht, wie Sie mithilfe des BizTalk Flatfile Schema-Assistenten auf der Grundlage der folgenden Beispielbestellung ein Flatfile-Schema aus einer Flatfile-Dokumentinstanz erstellen. Eine Einführung in den BizTalk-Flatfileschema-Assistenten finden Sie unter Verwenden des BizTalk-Flatfileschema-Assistenten.

Jede Zeile der Bestellung endet mit einem grün gekennzeichneten Wagenrücklauf/Zeilenvorschub (Carriage Return Line Feed, CRLF). Die Bestellung beginnt mit einem rot dargestellten PO-Tag gefolgt von einem Datum. Zwei wiederholte Felder mit fester Breite in Violett enthalten Kundeninformationen. Auf das Kommentarfeld folgt ein wiederholtes Feld, das mit einem ITEMS-Tag beginnt und mehrere durch Kommas (,) getrennte Datensätze und durch senkrechte Striche (|) getrennte Datenwerte enthält, die in Blau dargestellt sind.

Voraussetzungen

Bevor Sie diese exemplarische Vorgehensweise nachvollziehen, sollten Sie sich vergewissern, dass folgende Programme und Komponenten auf Ihrem Server installiert und konfiguriert sind:

  • Microsoft Visual Studio

  • Microsoft BizTalk Server mit installiertem Entwicklungstools

    Um das Dokument instance für die exemplarische Vorgehensweise vorzubereiten, kopieren Sie Folgendes in einen Text-Editor, und speichern Sie es als Textdatei. Achten Sie darauf, alle Zeilenzuleitungen und Wagenrückläufe zu kopieren.

PO1999-10-20
US        Alice Smith         123 Maple Street    Mill Valley    CA 90952
US        Robert Smith        8 Oak Avenue        Old Town       PA 95819
ITEMS,ITEM872-AA|Lawnmower|1|148.95|Confirm this is electric,ITEM926-AA|Baby Monitor|1|39.98|Confirm this is electric

Starten des Assistenten

  1. Öffnen Sie in Visual Studio die Projektmappen-Explorer.

  2. Um das neue Flatfileschema hinzuzufügen, klicken Sie mit der rechten Maustaste auf das Projekt, und wählen Sie Hinzufügen aus. Wählen Sie Neues Element aus.

  3. Führen Sie im Fenster Neues Element hinzufügen die folgenden Schritte aus:

    1. Wählen Sie im Abschnitt Kategorien die Option Schemadateien aus.

    2. Wählen Sie im Abschnitt Vorlagen die Option Flatfileschema-Assistent aus.

    3. Geben Sie im Feld Name den Namen PurchaseOrder.xsd für das neue Schema ein.

    4. Klicken Sie auf Hinzufügen.

  4. Beim Start des BizTalk Flatfile Schema-Assistenten wird die Willkommensseite angezeigt.
    Um diesen Bildschirm beim zukünftigen Ausführen des Assistenten zu überspringen, wählen Sie das Feld Diese Einführungsseite nicht erneut anzeigen aus. Klicken Sie auf zum Fortfahren auf Weiter.

Auswählen der bestellungs-instance

  • Wählen Sie im Bildschirm Flatfile-Schemainformationen die Instanz aus, und geben Sie die folgenden Informationen ein. Klicken Sie abschließend auf Weiter, um fortzufahren.

    • Instanzdatei: Klicken Sie auf die Schaltfläche Durchsuchen, um die Flatfile zu suchen, anhand derer das Schema erstellt wird. Navigieren Sie zu dem Ordner mit der Textdatei, die Sie im Abschnitt Voraussetzungen unter Exemplarische Vorgehensweise: Erstellen eines Flatfileschemas aus einer Dokumentinstanz erstellt haben.

    • Datensatzname: Geben Sie PO ein, da es sich um den Schemastammnamen handeln soll.

    • Zielnamespace: Geben Sie http://Flat_File_Project.PurchaseOrder für den Schemazielnamespace ein.

    • Codepage: Wählen Sie in der Dropdownliste die Option UTF-8 (65001) aus.

    • Anzahl der Positionen in Bytes: Aktivieren Sie dieses Kontrollkästchen, wenn Sie die Positionsdatenfelder nach Bytes zählen möchten. Standardmäßig werden diese Felder in Zeichen gezählt. Lassen Sie in dieser exemplarischen Vorgehensweise das Kontrollkästchen Positionen in Bytes zählen deaktiviert.

Auswählen von Bestelldaten

  • Im Bildschirm Dokumentdaten auswählen wird der Inhalt der Flatfile angezeigt. Wählen Sie die Daten aus, die zum Erstellen des Schemas erforderlich sind, und klicken Sie dann auf Weiter.

    Hinweis

    Wenn Sie das gesamte Dokument instance verwenden möchten, können Sie STRG-A drücken, um alle auszuwählen.

    Hinweis

    Aktivieren Sie das Kontrollkästchen Lange Zeilen umschließen, wenn Sie das gesamte Dokument instance Inhalt anzeigen möchten, der im gesamten Assistenten in das Bearbeitungsfeld eingeschlossen ist.

    Hinweis

    Wenn Sie das Schema aus einer Austauschinstanz erstellen, wählen Sie nur den Teil aus, der die Struktur des individuellen Dokuments darstellt.

Abgrenzung des Bestelldatensatzes

  • Da jede Zeile der Bestellung mit einem Wagenrücklaufvorschub (CRLF) endet, wählen Sie Nach Trennzeichensymbol aus, und klicken Sie dann auf dem Bildschirm Datensatzformat auswählen auf Weiter.

Angeben der Eigenschaft des Bestelldatensatzes

  • Geben Sie im Bildschirm Zeichengetrennter Datensatz Folgendes ein, um die erste Ebene des Schemas zu definieren, und klicken Sie zum Abschluss auf Weiter.

    • Untergeordnete Trennzeichen: Wählen Sie {CR}{LF}aus.

      Hinweis

      Die Eigenschaft Trennzeichen für untergeordnete Felder ist ein bearbeitbares Feld mit einer Dropdown-Auswahlliste, die eine Reihe von Standardwerten enthält. Das Trennzeichen für untergeordnete Felder kann als Zeichen oder als Hexadezimalwert angegeben werden. Beispiel: \{ oder {0x0D0A}.

    • Escapezeichen: Ein Escapezeichen ist ein einzelnes Zeichen, das verhindert, dass das nachfolgende Zeichen als Funktionszeichen interpretiert wird. Weitere Informationen finden Sie unter Escapezeichen . Für die exemplarische Vorgehensweise leer lassen.

      Hinweis

      Wenn Sie , {, und } für untergeordnete Trennzeichen oder Escapezeichen verwenden\, muss ein Schrägstrich verwendet werden. Beispiel: \\ und \{.

    • Aktivieren Sie das Kontrollkästchen Datensatz hat ein Tagbezeichnerfeld , und geben Sie PO in Tag ein. In einer Datei mit mehreren Datensätzen wird PO verwendet, um jeden einzelnen Datensatz zu identifizieren. Klicken Sie auf zum Fortfahren auf Weiter.

      FlatFileSchemaWizard_DelimitedRecord1

Definieren des Elements im Bestelldatensatz

  1. Der Assistent hat vier Elemente im Bestelldatensatz identifiziert; Sie müssen nun die Elementeigenschaft definieren. Führen Sie in der ersten Zeile die folgenden Schritte aus:

    1. Geben Sie datum für den Elementnamen ein.

    2. Wählen Sie für Elementtypdie Option Field-Element aus.

    3. Wählen Sie in der Dropdownliste das Datum für Datentyp aus.

  2. Wiederholen Sie die Schritte a bis c für die folgenden Elemente. Wenn Sie fertig sind, klicken Sie auf Weiter.

    Elementname Elementtyp Datentyp
    Kunde Wiederholter Datensatz
    Ignorieren
    items Datensatz

    FlatFileSchemaWizard_ChildElements untergeordneter Elemente

    Hinweis

    Sie können mehrere Zeilen auswählen und dann deren Elementtyp in einen einzigen Typ ändern, indem Sie bei gedrückter UMSCHALT- oder STRG-TASTE mit der Maus klicken.

    Hinweis

    Nachdem Sie im Bildschirm Untergeordnete Elemente auf Weiter geklickt haben, können Sie nicht auf Zurück klicken, um untergeordnete Elemente neu zu definieren oder zu ändern. Möglicherweise müssen Sie den Assistenten schließen und neu starten, um das Flatfile-Schema zu definieren.

  3. Nach Ausführung der Schritte in diesem Verfahren wird die erste Ebene des Schemas generiert, wie im folgenden Bildschirmabbild gezeigt. Es wurden drei eindeutige Elemente definiert, und Sie werden die untergeordneten Datensätze für die Elemente im Bestelldatensatz weiter definieren. Klicken Sie auf Weiter.

    Abbildung, die die erste Ebene des Schemas zeigt.

Definieren des Kundendatensatzes

  1. Da wir das Customer-Element als wiederholten Datensatztyp und das Element items als Record-Typ definiert haben, setzt der Assistent für BizTalk-Flatfileschemas diese beiden Elemente nun weiter fest. Wählen Sie auf dem Bildschirm Schemaansichtdie Option Kunde aus, und klicken Sie dann auf Weiter , um fortzufahren.

  2. Um mit dem Datensatz "customer" zu arbeiten, müssen Sie die Daten auswählen, die dieses Element darstellen. Da es sich um einen wiederholten Datensatz handelt, kann jede der Zeilen zum Definieren des Datensatzes verwendet werden. Wählen Sie die erste Zeile mit Kundendaten aus, und klicken Sie auf Weiter, um fortzufahren.

  3. Wählen Sie auf der Seite Datensatzformat auswählen die Option Nach relativen Positionen aus, und klicken Sie dann auf Weiter.

  4. Der Assistent stellt ein visuelles Tool für die Anzeige und Berechnung der Entfernung zwischen den Feldern bereit. Klicken Sie auf der Seite Positionsdatensatz mit der linken Maustaste auf die Positionsmarkierung 10, um darzustellen, wo das Feld name beginnt. Klicken Sie auf die folgenden Positionsmarkierungen, um die übrigen Datenfelder anzugeben:

    Feldname Positionsmarkierung
    street 30
    city 50
    state 65
    postalcode 68

    Klicken Sie auf zum Fortfahren auf Weiter.

    Bildschirm

  5. Auf der Seite Untergeordnete Elemente geben Sie die Eigenschaften der untergeordneten Elemente an. Wählen Sie die erste Zeile aus, und geben Sie land als Elementname ein. Behalten Sie in den übrigen Spalten die Standardwerte bei. Geben Sie die folgenden Werte für die anderen Eigenschaften für den Elementnamen ein:

    Elementname Wert
    customer_Child2 Fullname
    customer_Child3 Street
    customer_Child4 city
    customer_Child5 state
    customer_Child6 Postalcode

    Klicken Sie auf zum Fortfahren auf Weiter.

    Abbildung des Bildschirms

  6. Die untergeordneten Elemente des Kundendatensatzes werden erstellt, wie im folgenden Bildschirmabbild gezeigt. Klicken Sie auf Weiter, um die untergeordneten Elemente für den Datensatz "items" zu erstellen.

    Abbildung, die die untergeordneten Elemente des Kundendatensatzes zeigt.

Definieren des Elementdatensatzes

  1. Wählen Sie auf der Seite Schemaansicht das Element items aus, und klicken Sie dann auf Weiter.

  2. Wählen Sie auf der Seite Dokumentdaten auswählen die gesamte Zeile aus, die mit ITEMS beginnt, und klicken Sie dann auf Weiter , um die untergeordneten Elemente zu definieren.

  3. Wählen Sie auf der Seite Datensatzformat auswählen die Option Nach Trennzeichensymbol aus, und klicken Sie dann auf Weiter.

  4. Die einzelnen Elemente des Datensatzes "items" sind durch Kommas getrennt. Geben Sie daher auf der Seite Zeichengetrennter Datensatz Folgendes ein, um den Datensatz "items" zu definieren. Wenn Sie fertig sind, klicken Sie auf Weiter.

    • Wählen Sie in der Dropdown-Auswahlliste Trennzeichen für untergeordnete Felder den Eintrag , aus.

    • Lassen Sie das Textfeld Escapezeichen leer.

    • Wählen Sie Datensatz hat einen Tagbezeichner aus, und geben Sie ITEMS in Tag ein.

      In einem Datensatz mit mehreren Elementen wird ITEMS verwendet, um jeden einzelnen Datensatz zu identifizieren.

  5. Der Assistent identifiziert anhand der Werte auf der Seite Zeichengetrennter Datensatz zwei untergeordnete Elemente. Da eines der Elemente ein wiederholter Datensatz ist, wählen Sie das erste Element aus, und geben Sie item als Elementnamen ein, und wählen Sie dann Wiederholter Datensatz in der Dropdown-Auswahlliste Elementtyp aus. Behalten Sie die restlichen Standardwerte in den Spalten bei. Wählen Sie die zweite Zeile aus, und wählen Sie Ignorieren in der Liste Elementtyp aus. Wenn Sie auf Weiter klicken, wird die nächste Ebene für den Datensatz "items" im Schema erstellt. Sie fahren fort und definieren den letzten Teil des Bestellschemas.

  6. Wählen Sie element aus, und klicken Sie dann auf Weiter , um auf der Seite Schemaansicht fortzufahren.

  7. Wählen Sie auf der Seite Dokumentdaten auswählen den Eintrag ITEM872-AA|Lawnmower|1|148.95|Confirm this is electric aus. Klicken Sie auf zum Fortfahren auf Weiter.

  8. Wählen Sie auf der Seite Datensatzformat auswählen die Option Nach Trennzeichensymbol aus, da die einzelnen Elemente durch einen senkrechten Strich (|) getrennt werden.

  9. Geben Sie auf der Seite Zeichengetrennter Datensatz Folgendes ein, um den Datensatz "item" zu definieren. Wenn Sie fertig sind, klicken Sie auf Weiter.

    • Wählen Sie aus der Dropdownliste Untergeordnete Trennzeichen die Option | aus.

    • Lassen Sie das Textfeld Escapezeichen leer.

  10. Auf der Seite Untergeordnete Elemente hat der Assistent fünf untergeordnete Elemente identifiziert. Wählen Sie die erste Zeile aus, und geben Sie productCode als Elementname ein. Behalten Sie in den restlichen Spalten die Standardwerte bei. Geben Sie für die restlichen Eigenschaften des Elementnamens Folgendes ein:

    Elementname Wert
    item_Child2 description
    item_Child3 quantity
    item_Child4 Einzelpreis
    item_Child5 Notizen

    Klicken Sie auf zum Fortfahren auf Weiter.

  11. Sie haben alle Knoten für das Bestellschema definiert. Klicken Sie auf der Seite Schemaansicht auf Fertig stellen.

  12. Sie können nun das fertige Bestellschema anzeigen. Im BizTalk Schema-Editor können Sie das Schema außerdem optimieren. Weitere Informationen finden Sie unter Tabelle mit Flatfileeigenschaftennamen und Eigenschaftentabellen in Schemaknoteneigenschaften. Weitere Details zu dieser Eigenschaft finden Sie in der Referenz zu Benutzeroberflächenleitfaden und API-Namespaces für Entwickler.

Zusammenfassung

In dieser exemplarischen Vorgehensweise haben Sie gelernt, wie Sie mithilfe des BizTalk Flatfile Schema-Assistenten ein Flatfile-Schema aus einer Dokumentinstanz erstellen.

Nächste Schritte

Überprüfen der PO-Instanz

Um sicherzustellen, dass die PO-Instanz vom Schema "PurchaseOrder.xsd" korrekt analysiert werden kann, führen Sie folgende Schritte aus:

  1. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf PurchaseOrder.xsd, und wählen Sie dann Eigenschaften aus.

  2. Stellen Sie in den Eigenschaftenseiten sicher, dass das Feld Dateiname der Eingabeinstanz auf den Speicherort der PO-instance verweist, die Sie im Abschnitt Voraussetzungen von Exemplarische Vorgehensweise: Erstellen eines Flatfileschemas aus einer Dokumentinstanz erstellt haben. Klicken Sie auf OK, um das Dialogfeld zu schließen.

  3. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf PurchaseOrder.xsd, und wählen Sie dann Instanz überprüfen aus. Die Überprüfungskomponente wird geöffnet.

  4. Nach Abschluss der Überprüfung wird eine Verknüpfung zur Anzeige der XML-Ausgabe bereitgestellt, basierend auf dem Ergebnis der Analyse der PO-Instanz mithilfe des Schemas "PurchaseOrder.xsd". Zum Anzeigen der XML-Ausgabe drücken Sie STRG und klicken auf die Verknüpfung.

Erstellen von Pipelines für das Schema

Nun können Sie eine Empfangs- oder Sendepipeline auf Basis des Schemas "PurchaseOrder.xsd" zur Verwendung in Ihrer BizTalk-Anwendung erstellen.

Informationen zum Erstellen einer neuen Pipeline finden Sie unter Erstellen einer neuen Pipeline. Informationen zum Konfigurieren der Flatfilepipelinekomponenten finden Sie unter Konfigurieren der Pipelinekomponente des Flatfile-Assemblers und Konfigurieren der Pipelinekomponente für flatfile Disassembler.

Weitere Informationen

Verwenden des BizTalk Flatfile Schema-Assistenten
Erstellen von Schemas mithilfe des BizTalk Flatfile Schema-Assistenten