Zahlen in Zeichenketten formatieren

Bei diesem Beispiel geht es darum, wie der FlowHeater standardmäßig Zahlen in Zeichenketten umwandelt und wie abweichend von der Standard Formatierung des WRITE Adapters Zahlen formatiert ausgegeben werden können.

Ausgangssituation

Das Beispiel verwendet den TestData Adapter zum generieren von zufälligen Testdaten, sowie den TextFile Adapter für die Ausgabe bzw. Anzeige. Mit dem Testdaten Adapter werden dabei dynamisch 1000 Test Datensätze erzeugt die als Input für den TextFile Adapter dienen. Mit dem gleichen Prinzip können auch Import/Export Textdateien (CSV, TXT, ASCII, ASC) für Datenbanken Formatiert werden. Für den Import bzw. Export in/von Datenbanken stehen Ihnen z.B. die Adapter Microsoft Access, MySQL, SQL-Server, Oracle sowie ODBC des FlowHeaters zur Verfügung.

Das Beispiel finden Sie unter Examples\DE\Common\format_number.fhd. Alle Beispiele sind im ZIP Archiv vom FlowHeater enthalten, hier geht´s zum Download.

Zahlen in Zeichenketten (Strings) formatieren

Nach dem öffnen des Beispiels sollte Ihr Bildschirm so ähnlich wie rechts gezeigt aussehen. Hier finden wir insgesamt 3 Format Heater, sowie einige Clone Heater. Die Clone Heater sind nur dazu da die Definition optisch etwas übersichtlicher gestalten zu können. Uns interessieren hier nur die Format Heater. Schauen Sie sich vorab die Eigenschaften der Format Heater an, über einen Doppelklick darauf öffnet sich der Eigenschaftendialog.

Starten Sie nun die Definition über den Ausführen Button (siehe rote Markierung). Es öffnet der Test und Ausführen Dialog vom FlowHeater. Belassen Sie die Standardeinstellungen und führen die Definition aus. Schauen Sie sich die (Daten) Ausgabe an, es wurden 1000 Test Datensätze generiert die im Text File Viewer des TextFile Adapter angezeigt werden. Bitte beachten Sie, dass hier noch keine Daten verändert bzw. geschrieben werden (außer hier eine temporäre Textdatei). Erst wenn Sie im Test bzw. Ausführen Dialog die Option Testlauf deaktivieren wird auch die Textdatei "format_number.txt" im gleichen Verzeichnis wie der Definitionsdatei geschrieben.

Beschreibung der Ausgabe, oder warum werden die Daten so formatiert?

Feldeigenschaften

Hinweis: Ist in der Beschreibung vom Feld Datentyp bzw. Feld Format die Rede, bezieht sich dies auf die Eigenschaften des jeweiligen Feldes vom WRITE Adapter (Rechte Seite). Zum anzeigen der Eigenschaften eines Feldes müssen Sie dies lediglich mit der Maus anklicken, danach erscheinen die Eigenschaften unterhalb des Adapters.
Mit Standard ist das Standard Gebietsschema gemeint. Das Gebietsschema wurde in diesem Beispiel auf Deutsch eingestellt!

• int Standard: Diese Formatierung kommt aus der Standardeinstellung des WRITE Adapters. Die Einstellungen dazu können Sie sich über den Configurator des WRITE Adapters ansehen.
• int ohne Format: Hier wurde die Feldeigenschaft Format auf "0" gesetzt.
• int Währung Dollar: Hier wurde eine Ganzzahl (int) in den Format Heater geschickt die dann als Währung (Currency) interpretiert werden soll. Der Format Heater wurde so konfiguriert, dass Währungen mit führenden Währungssymbol, 3 Nachkommastellen und mit einem Komma als Dezimaltrennzeichen formatiert werden. Das Gebietsschema ist "Englisch (USA)". Bitte beachten Sie, dass der Felddatentyp in diesem Fall String (Zeichenkette) sein muss. Wäre dies nicht der Fall würde der FlowHeater versuchen die gerade formatierte Zahl wieder umzuwandeln in eine FlowHeater Zahl.
• int Währung Euro: Hier wurde der Feld Datentyp auf "Currency" gesetzt, die Formatierung kommt aus den Standardeinstellungen des WRITE Adaptes.
• decimal Standard: siehe int Standard nur mit Datentyp "Decimal".
• decimal ohne Format: Hier wurde die Feldeigenschaft Format auf "0.000" gesetzt. Beachten Sie, dass dabei 3 Nachkommastellen erzeugt werden.
• decimal Währung Dänische Kronen :-) Hier wurde eine Zahl vom Typ "Decimal" in den Format Heater geschickt. Der Format Heater wurde so konfiguriert, dass als Gebietsschema "Dänisch (Dänemark)" zu verwenden ist. Bitte beachten Sie, dass der Felddatentyp in diesem Fall "String" = Zeichenfolge ist, siehe hierzu auch "int Währung Dollar".
• decimal Währung Euro: Dies ist wieder die Standardformatierung des WRITE Adapters.
• Rechtsbündig über Format Heater: Rechtsbündig formatierter Text über den Format Heater. Beachten Sie, dass hierbei der Felddatentyp "String" sein muss.
• Rechtsbündig über TextFileAdapter:Rechtsbündig formatierter Text über den TextFileAdapter.