Write to Variable Format File

„Write to Variable Format File“ schreibt Datensätze mit variablem Layout in eine Datei.

Dateien mit variablem Format haben diese Merkmale:

Datensätze in der Datei können unterschiedliche Felder und eine unterschiedliche Anzahl von Feldern enthalten.
Jeder Datensatz muss ein Tag (gewöhnlich eine Zahl) enthalten, das den Typ des Datensatzes angibt.
Hierarchische Beziehungen werden unterstützt.

Beispiel für eine Datei mit variablem Format

Dieses Beispiel zeigt eine Datei mit variablem Format, die Informationen zur Girokontoaktivität für zwei Kunden, Joe Smith und Anne Johnson, enthält. In diesem Beispiel ist die Datei eine durch Trennzeichen getrennte Datei, in der ein Komma als Feldtrennzeichen verwendet wird.

001   Joe,Smith,M,100 Main St,555-234-1290
100   CHK12904567,12/2/2007,6/1/2012,CHK
200   1000567,1/5/2012,Fashion Shoes,323.12
001   Anne,Johnson,F,1202 Lake St,555-222-4932
100   CHK238193875,1/21/2001,4/12/2012,CHK
200   1000232,3/5/2012,Blue Goose Grocery,132.11
200   1000232,3/8/2012,Trailway Bikes,540.00

Das erste Feld in jedem Datensatz enthält das Tag, das den Typ des Datensatzes und damit sein Format angibt:

001: Kundendatensatz
100: Kontodatensatz
200: Kontotransaktionsdatensatz

Bei durch Trennzeichen getrennten Dateien ist es häufig so, dass der Tagwert (001, 100, 200) in einer festen Anzahl von Byte am Beginn des Datensatzes steht (siehe das obige Beispiel).

Jeder Datensatz hat ein eigenes Format:

001: FirstName,LastName,Gender,Address,PhoneNumber
100: AccountID,DateOpened,ExpirationDate,TypeOfAccount
200: TransactionID,DateOfTransaction,Vendor,Amount

Das Datensatzformat 100 (Kontodatensatz) ist ein untergeordnetes Element des vorherigen 001-Datensatzes und das Datensatzformat 200 (Kontotransaktionsdatensatz) ein untergeordnetes Element des vorherigen 100-Datensatzes (Kontodatensatz). In der Beispieldatei gab es im Konto von Joe Smith, CHK12904567, am 05.01.2012 eine Transaktion mit dem Betrag 323,12 bei Fashion Shoes. Im Konto von Anne Johnson, CHK238193875, wiederum gab es zwei Transaktionen, eine am 05.03.2012 bei Blue Goose Grocery und eine am 08.03.2012 bei Trailway Bikes.

Registerkarte „Dateieigenschaften“

Name der Option	Beschreibung
Servername	Dies gibt an, ob sich die von Ihnen als Eingabe ausgewählte Datei auf dem Computer mit dem Enterprise Designer oder auf dem Spectrum™ Technology Platform-Server befindet. Wenn Sie eine Datei auf dem lokalen Computer auswählen, lautet der Servername „Arbeitsplatz“. Wenn Sie eine Datei auf dem Server auswählen, lautet der Servername Spectrum™ Technology Platform.
Dateiname	Gibt den Pfad zur Datei 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.
Root-Tag-Name	Das Tag, das für Datensätze verwendet werden soll, die ein übergeordnetes Element anderer Datensatztypen sind. Wenn Sie beispielsweise die drei Datensatztypen 001, 100 und 200 haben und die Datensatztypen 100 und 200 untergeordnete Elemente des Datensatztyps 001 sind, dann ist 001 das Root-Tag.
Tags mit fester Breite verwenden	Gibt an, ob ein fester Bereich am Beginn jedes Datensatzes zugeordnet werden soll, an dem das Datensatz-Tag eingefügt wird. Das folgende Beispiel zeigt eine Datei mit den Tags 001, 100, und 200 in einem Feld mit fester Breite: `001 Joe,Smith,M,100 Main St,555-234-1290 100 CHK12904567,12/2/2007,6/1/2012,CHK 200 1000567,1/5/2012,Mike's Shoes,323.12`
Tag-Breite	Wenn Sie das Kästchen Tags mit fester Breite verwenden aktivieren, gibt diese Option die Anzahl von Leerzeichen an, die für Tags am Beginn jedes Datensatzes zugeordnet werden sollen. Wenn Sie beispielsweise 7 angeben, dann werden die ersten sieben Stellen in jedem Datensatz für das Tag vorgesehen. Der angegebene Wert muss größer oder gleich groß wie der längste Tag-Name in Zeichen sein. Informationen zu Tag-Namen finden Sie unter Tag-Namen in Dateien mit variablem Format. Der Wert im Feld Tag-Breite wird automatisch erhöht, wenn Sie auf der Registerkarte Felder Felder hinzufügen, die einen Namen haben, der länger als der angegebene Wert ist. Die maximale Tag-Breite ist 1024.
Numerisches Tag-Präfix entfernen	Löscht den Teil „NumericTag_“ des Feldnamens, bevor das Tag in die Datei geschrieben wird. Das Präfix „NumericTag_“ wird Tag-Namen, die mit einer Zahl beginnen, durch den Schritt „Read from Variable Format File“ hinzugefügt. Dies deshalb, weil der Tag-Name als Name eines Listendatenflussfeldes verwendet wird, das die Daten im Datensatz enthält, und Datenflussfeldnamen nicht mit einer Zahl beginnen dürfen. So würde beispielsweise das Tag 100 in das Listenfeld namens „NumericTag_100“ geändert. Wenn Sie diese Option aktivieren, würde dieses Feld als Datensatz mit einem Tag „100“ statt „NumericTag_100“ in die Ausgabedatei geschrieben.
Zeichencodierung	Dies ist die Codierung der Textdatei. Wählen Sie eine der folgenden Optionen: UTF-8 Die Datei unterstützt alle Unicode-Zeichen und ist abwärtskompatibel mit ASCII. Weitere Informationen zu UTF finden Sie unter unicode.org/faq/utf_bom.html. UTF-16 Die Datei unterstützt alle Unicode-Zeichen, ist aber nicht abwärtskompatibel mit ASCII. Weitere Informationen zu UTF finden Sie unter unicode.org/faq/utf_bom.html. US-ASCII Die Zeichencodierung basiert auf der Reihenfolge des englischen Alphabets. UTF-16BE Die Datei ist UTF-16-codiert mit Big-Endian-Reihenfolge (höchstwertiges Byte zuerst). UTF-16LE Die Datei ist UTF-16-codiert mit Little-Endian-Reihenfolge (niedrigstwertiges Byte zuerst). ISO-8859-1 Dies ist eine ASCII-Zeichencodierung, die normalerweise für westeuropäische Sprachen verwendet wird. Sie ist auch bekannt als Latin-1. ISO-8859-3 Dies ist eine ASCII-Zeichencodierung, die normalerweise für südeuropäische Sprachen verwendet wird. Sie ist auch bekannt als Latin-3. ISO-8859-9 Dies ist eine ASCII-Zeichencodierung, die normalerweise für Türkisch verwendet wird. Sie ist auch bekannt als Latin-5. CP850 Dies ist eine ASCII-Codeseite, die für westeuropäische Sprachen verwendet wird. CP500 Dies ist eine EBCDIC-Codeseite, die für westeuropäische Sprachen verwendet wird. Shift_JIS Dies ist eine Zeichencodierung für Japanisch. MS932 Dies ist eine Shift_JIS-Erweiterung von Microsoft, die besondere NEC-Zeichen, eine NEC-Auswahl aus IBM-Erweiterungen und IBM-Erweiterungen einschließt. CP1047 Dies ist eine EBCDIC-Codeseite mit dem vollständigen Latin-1-Zeichensatz.
Feldtrennzeichen	Gibt das Zeichen an, das zum Trennen von Feldern in einer Datei mit Begrenzungszeichen verwendet wird. Im folgenden Beispiel wird ein Pipe-Zeichen ( \| ) im Datensatz als Feldtrennzeichen verwendet: `7200 13TH ST\|MIAMI\|FL\|33144` Die folgenden Zeichen stehen zur Definition als Feldtrennzeichen zur Verfügung: Leerzeichen Tabulator Komma Punkt Semikolon Pipe Wenn in der Datei ein anderes Zeichen als Feldtrennzeichen verwendet wird, klicken Sie auf die Ellipsenschaltfläche, um ein anderes Zeichen als Begrenzungszeichen auszuwählen.
Tag-Trennzeichen	Gibt das Zeichen an, das sich hinter dem Tag-Feld befindet, um in einer Datei mit Begrenzungszeichen das Identifizierungsfeld für jeden Datensatz abzugrenzen. Ein Tag-Trennzeichen muss ein einzelnen Zeichen sein. Standardmäßig stehen die folgenden Zeichen zur Definition als Tag-Trennzeichen zur Verfügung: Leerzeichen Tabulator Komma Punkt Semikolon Pipe Wenn in der Datei ein anderes Zeichen als Tag-Trennzeichen verwendet wird, klicken Sie auf die Ellipsenschaltfläche, um ein benutzerdefiniertes Tag-Trennzeichen hinzuzufügen und auszuwählen. Anmerkung: Standardmäßig ist das Datensatz-Trennzeichen dasselbe Zeichen wie das ausgewählte Feldtrennzeichen. Um dieses Feld zu aktivieren und ein anderes Zeichen auszuwählen, deaktivieren Sie das Kästchen Wie Feldtrennzeichen.
Wie Feldtrennzeichen	Dies zeigt an, ob das Tag-Trennzeichen dasselbe ist wie das Feldtrennzeichen. Deaktivieren Sie dieses Kästchen, um ein anderes Zeichen als Tag-Trennzeichen auszuwählen. Anmerkung: Standardmäßig ist dieses Kästchen aktiviert und das Feld Tag-Trennzeichen deaktiviert.
Textbegrenzungszeichen	Dies ist das Zeichen, das in einer Datei mit Begrenzungszeichen Textwerte umschließt. Im folgenden Beispiel werden im Datensatz doppelte Anführungszeichen (") als Textbegrenzungszeichen verwendet. `"7200 13TH ST"\|"MIAMI"\|"FL"\|"33144"` Die folgenden Zeichen stehen zur Definition als Textbegrenzungszeichen zur Verfügung: einfaches Anführungszeichen ( ' ) doppeltes Anführungszeichen ( " ) Wenn in der Datei ein anderes Textbegrenzungszeichen verwendet wird, klicken Sie auf die Ellipsenschaltfläche, um ein anderes Zeichen als Textbegrenzungszeichen auszuwählen.
Datensatz-Trennzeichen	Gibt das Zeichen an, das zum Trennen von Datensätzen in einer zeilensequenziellen Datei oder einer Datei mit Begrenzungszeichen verwendet wird. Dieses Feld ist nicht verfügbar, wenn Sie das Kästchen Standard-Zeilenende verwenden aktivieren. Die verfügbaren Einstellungen für Datensatz-Trennzeichen sind: Unix (U+000A) Die Datensätze sind durch ein Zeilenvorschubzeichen getrennt. Dies ist bei Unix-Systemen das standardmäßige Datensatz-Trennzeichen. Macintosh (U+000D) Die Datensätze sind durch ein Zeilenumbruchzeichen getrennt. Dies ist bei Macintosh-Systemen das standardmäßige Datensatz-Trennzeichen. Windows (U+000D U+000A) Die Datensätze sind durch ein Zeilenumbruchzeichen gefolgt von einem Zeilenvorschubzeichen getrennt. Dies ist bei Windows-Systemen das standardmäßige Datensatz-Trennzeichen. Wenn in der Datei ein anderes Datensatz-Trennzeichen verwendet wird, klicken Sie auf die Ellipsenschaltfläche, um ein anderes Zeichen als Datensatz-Trennzeichen auszuwählen.
Standard-Zeilenende verwenden	Gibt an, dass das standardmäßige Zeilenendzeichen (EOL) des Betriebssystems, auf dem der Spectrum™ Technology Platform-Server läuft, als Datensatz-Trennzeichen der Datei verwendet wird. Wählen Sie diese Option nicht aus, wenn in der Datei ein Zeilenendzeichen verwendet wird, das sich vom standardmäßigen Zeilenendzeichen des Betriebssystems des Servers unterscheidet. Wenn in der Datei beispielsweise ein Windows-Zeilenendzeichen verwendet wird, der Server aber auf Linux läuft, aktivieren Sie diese Option nicht. Wählen Sie stattdessen im Feld Datensatz-Trennzeichen die Option „Windows“ aus.

Registerkarte „Felder“

Die Registerkarte Felder steuert, welche Felder vom Datenfluss in die Ausgabedatei eingeschlossen werden.

Name der Option	Beschreibung
Hinzufügen	Klicken Sie darauf, um der Ausgabe ein Feld hinzuzufügen. Informationen zum Erstellen von Datenflussfeldern für „Write to Variable Format File“ finden Sie unter Schreiben von flachen Daten in eine Datei mit variablem Format.
Ändern	Klicken Sie darauf, um den Namen des Tags zu ändern. Diese Schaltfläche ist nur aktiviert, wenn ein Tag ausgewählt ist. Falls die Option Tags mit fester Breite verwenden auf der Registerkarte Dateieigenschaften aktiviert ist, wird die Tag-Breite automatisch angepasst, wenn Sie einen längeren Tag-Namen eingeben. Anmerkung: Wenn Sie mit dieser Schaltfläche den Root-Tag-Namen ändern, hat das denselben Effekt wie eine Änderung des Wertes im Feld Root-Tag-Name auf der Registerkarte Dateieigenschaften.
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.
xx Alle entfernen	Entfernt alle Felder aus der Ausgabe.
Nach oben/Nach unten	Ordnet das ausgewählte Feld neu an.

Registerkarte „Laufzeit“

Name der Option	Beschreibung
Dateiname	Zeigt die auf der Registerkarte Dateieigenschaften definierte Datei an.
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 direkt einem Root-Tag zugeordneten Elemente einfachen Typs im Dateipfadfeld aufgelistet werden. Dieses Feld ist nur aktiviert, wenn Sie die Option Mehrere Dateien generieren auswählen.
Schreibmodus	Gibt an, ob die Ausgabe des Datenflusses am Ende der Datei hinzugefügt oder ob die in der Datei vorhandenen Daten vor dem Schreiben der Ausgabe gelöscht werden sollen. Zur Auswahl stehen: Überschreiben Ersetzt die vorhandenen Daten in der Ausgabedatei jedes Mal, wenn der Datenfluss ausgeführt wird. Anfügen Fügt die Ausgabe des Datenflusses am Ende der Datei hinzu, ohne die vorhandenen Daten der Datei zu löschen.