Write to XML

Der „Write to XML“-Schritt schreibt die Ausgabe eines Auftrags oder Unterflusses in eine XML-Datei.

Registerkarte „Dateieigenschaften“

Feldname	Beschreibung
Datendatei	Gibt den Pfad zur XML-Ausgabedatei an. Klicken Sie auf die Ellipsenschaltfläche (...), um die gewünschte Datei zu lokalisieren. Anmerkung: Falls der Spectrum™ Technology Platform-Server unter Unix oder Linux ausgeführt wird, berücksichtigen Sie, dass bei Dateinamen und Pfaden auf diesen Plattformen die Groß-/Kleinschreibung beachtet wird.
Tatsächliche Datei	Zeigt die auf der Registerkarte Felder angegebene Struktur an. Wenn Sie auf ein Element klicken und die im Feld Datendatei angegebene Datei das Element enthält, wird eine Vorschau der Daten angezeigt. Beachten Sie, dass nur Daten aus einfachen Elementen in der Vorschau angezeigt werden können.
Schema exportieren	Klicken Sie auf diese Schaltfläche, um eine XSD-Datei zu speichern, die das in der Ansicht „Tatsächliche Datei“ angezeigte Schema darstellt. Die Schemadatei wird sofort an dem von Ihnen angegebenen Speicherort gespeichert.

Registerkarte „Felder“

Die Registerkarte Felder definiert die Felder, die Sie in die XML-Ausgabedatei einbeziehen möchten. Beim Hinzufügen von Feldern werden diese in einer Baumstruktur angezeigt. Die Baumstruktur zeigt den Namen des Elements oder Attributs an, das in die XML-Datei geschrieben wird. In Klammern hinter dem Element-/Attributnamen steht der Name des Datenflussfeldes gefolgt vom Datentyp. Beispiel:

Dies gibt an, dass vier Elemente und ein Attribut in die XML-Datei geschrieben werden. Das Attribut wird durch ein rotes @-Zeichen angegeben.

Beachten Sie, dass das Element „Bundesland/Kanton“ die Daten aus dem Feld „StateProvince“ enthält, bei denen es sich um Zeichenfolgendaten handelt. Gleichermaßen enthält die Postleitzahl des Elements die Daten aus dem Feld „PostalCode“, bei denen es sich ebenfalls um Zeichenfolgendaten handelt. Die XML-Datei könnte wie folgt aussehen:

<XmlRoot>
    <Customer Status="0">
        <AddressLine1>7713 Mullen Dr</AddressLine1>
        <City>Austin</City>
        <State>TX</State>
        <ZIP>78757-1346</ZIP>
    </Customer>
    <Customer Status="0">
        <AddressLine1>1825B Kramer Ln</AddressLine1>
        <City>Austin</City>
        <State>TX</State>
        <ZIP>78758-4260</ZIP>
    </Customer>
</XmlRoot>

Anmerkung: Der Stammelementname (in diesem Beispiel <XmlRoot>) wird auf der Registerkarte Dateieigenschaften angegeben.

Die folgende Tabelle enthält die Optionen der Registerkarte Felder.

Name der Option	Beschreibung
Hinzufügen	Fügt der Ausgabe ein Feld hinzu.
Ändern	Ändert die Art, wie das Feld in die XML-Datei geschrieben wird. Sie können Folgendes angeben: Ausgabetyp Diese Option ist verfügbar, wenn Sie ein einfaches Feld ändern. Sie gibt an, ob das Datenflussfeld in ein XML-Element oder -Attribut geschrieben werden soll. Element Wählen Sie diese Option aus, um die Felddaten in ein XML-Element zu schreiben. Geben Sie den zu verwendenden Elementnamen in das Feld Elementname ein. Attribut Schreibt die Felddaten in ein Attribut des übergeordneten Elements. Geben Sie den zu verwendenden Attributnamen in das Feld Attributname ein. Elementname/Attributname Gibt den Namen des Elements oder Attributs an, das in die XML-Datei geschrieben werden soll. Der Standardname ist der Name des Datenflussfeldes. Alle untergeordneten Elemente ändern in Diese Option ist verfügbar, wenn Sie ein komplexes Element ändern. Sie gibt den XML-Typ an, den das komplexe Element enthalten soll. Zur Auswahl stehen: Keine Änderung Die untergeordneten Typen bleiben entsprechend ihrer aktuellen Definition unverändert: entweder Element oder Attribut. Sie können den Typ für jedes Feld einzeln angeben, indem Sie das Feld auswählen und auf Ändern klicken. Elemente Alle einfachen Felder unter dem Element werden als XML-Elemente geschrieben. Attribute Alle einfachen Felder unter dem Element werden als XML-Attribute geschrieben. Namespace Wenn Sie einen XML-Namespace angeben möchten, der für das Element oder Attribut verwendet werden soll, wählen Sie ihn hier aus. Sie können Namespaces auf der Registerkarte Felder im „Write to XML“-Schritt erstellen. Leere Felder einschließen Aktivieren Sie dieses Kästchen für eine Einbeziehung in die XML-Elemente der Ausgabedatei, die einen Nullwert oder keine Daten enthalten. Wenn Sie dieses Kästchen nicht aktivieren, werden leere Elemente nicht in die Ausgabe einbezogen. Wenn Sie beispielsweise ein Element mit dem Namen `<City>` definieren, es jedoch einen Datensatz gibt, der keine Daten im Feld „City“ enthält, enthält die XML-Ausgabe das Folgende, wenn Sie das Kästchen Leere Felder einschließen aktivieren: `<City xs:nil="true"></City>` Wenn Sie dieses Kästchen nicht aktivieren, wird das Element `<City>` nicht in die Ausgabedatei geschrieben. Anmerkung: Das Datenflussfeld zeigt das Feld an, dessen Daten in das Element oder Attribut geschrieben werden. Dies wird angezeigt, so dass Sie, wenn Sie den Namen des Elements oder Attributs ändern, dennoch sehen können, welche Felddaten im Element oder Attribut enthalten sind.
Entfernen	Entfernt das ausgewählte Feld aus der Ausgabe. Wenn Sie ein Listenfeld entfernen, werden alle untergeordneten Felder ebenfalls entfernt. Wenn Sie ein untergeordnetes Feld entfernen, wird nur das ausgewählte untergeordnete Feld aus dem Listenfeld entfernt.
Alle entfernen	Entfernt alle Felder aus der Ausgabe.
Nach oben/Nach unten	Ordnet das ausgewählte Feld neu an. Beachten Sie, dass Sie einfache Elemente nicht in komplexe Elemente verschieben können. Wenn Sie die Elemente in einem komplexen Element ändern möchten, müssen Sie den Aggregatorschritt des Datenflusses ändern, um die gewünschten Datenflussfelder in das komplexe Element einzubeziehen. Weitere Informationen finden Sie unter Erstellen von komplexem XML aus flachen Daten.
Erneut generieren	Ersetzt die Felder, die aktuell mit den Feldern aus dem Upstream-Kanal im „Write to XML“-Schritt definiert sind.

Registerkarte „Laufzeit“

Name der Option	Beschreibung
Mehrere Dateien generieren	Wählen Sie diese Option aus, um Datensätze in unterschiedliche Dateien zu schreiben (statt alle Datensätze in eine Datei). Die Datei, in die jeder Datensatz geschrieben wird, ist im Datensatz selbst angegeben. Jeder Datensatz muss ein Feld enthalten, das entweder den Namen oder den vollständigen Pfad zu der Datei angibt, in die der Datensatz geschrieben werden soll. Wenn Sie beispielsweise die Aktienkurse verschiedener Unternehmen (verschiedener Gruppen) allen Kunden gesondert senden möchten, schreibt dieses Feature die Aktienkurse der verschiedenen Unternehmen in separate Dateien, die Sie auf Wunsch jedem der Kunden senden können. Wenn Sie die Option Mehrere Dateien generieren aktivieren, müssen Sie eine Ausgabedatei entweder auf dem Spectrum™ Technology Platform-Server oder einem FTP-Server angeben. Wenn Sie Daten in eine Datei auf einem FTP-Server schreiben möchten, müssen Sie mit Management Console eine Verbindung zum Dateiserver definieren. Anmerkung: Die Datensätze in der im Dateipfadfeld ausgewählten Spalte müssen sortiert vorliegen. Verwenden Sie dieses Feature, wenn der Datensatz entweder den Namen oder den vollständigen Pfad der Datei enthält.
Dateipfadfeld	Wählt das Feld aus, das den Pfad (entweder ein Dateiname oder der vollständige Dateipfad) der Datei enthält, in die Sie den Datensatz schreiben möchten. Beachten Sie, dass nur die einfachen Elemente, die direkt einem Stamm zugewiesen sind, im Dateipfadfeld aufgelistet werden. Dieses Feld ist nur aktiviert, wenn Sie die Option Mehrere Dateien generieren auswählen.
Schema zur Laufzeit generieren	Wählen Sie diese Option aus, um ein XSD bei Laufzeit zu generieren und die Referenz `noNamespaceSchemaLocation` in das Schema der XML-Datei einzufügen. Der Wert des Attributs `noNamespaceSchemaLocation` ist der XSD-Dateiname in der XML-Datei. Wenn Sie das Schema während der Bearbeitung eines Datenflusses exportieren, gibt es keine Referenz zum XSD in der XML-Ausgabedatei, und der Benutzer muss sie manuell in die Referenz zum XSD hinzufügen.
Schemapfad	Gibt den Pfad zur Speicherung der XSD-Datei an, der das Schema der XML-Ausgabedatei enthält. Klicken Sie auf die Ellipsenschaltfläche (...), um die gewünschte Datei zu lokalisieren. Die Schemadatei wird an dem Speicherort gespeichert, den Sie bei der Ausführung des Datenflusses angeben.