EXPORT_CSV
|
Syntax: |
EXPORT_CSV(<Indexdateiname>,<Schlüsselnummer>,<CSV-Dateiname>,<Spaltenüberschriften>,
<Feldnummern>,<Trennzeichen>,<Datumsformat>,<Hochkomma>
[,<Makroname>])
|
||||||||||||||||||
|
|
|
||||||||||||||||||
|
Bedeutung: |
Exportiert
Datensätze aus der Indexdatei <Indexdateiname> in eine CSV-Datei. <Schlüsselnummer>
legt die Nummer des Schlüssels fest (0 = Primärkey, 1,... = Sekundärkey) über
den die Indexdatei gelesen wird. Zuerst wird ein START
bzw. ein c in der Indexdatei mit dem Schlüssel
= <Schlüsselnummer> ausgeführt. Deshalb müssen vor dem Aufruf von
EXPORT_CSV die Schlüsselfelder mit den Werten des ersten zu exportierenden
Datensatzes belegt werden. Über READ-NEXT
bzw. READS-NEXT werden die weiteren
Datensätze der Indexdatei gelesen. Als <Schlüsselnummer> kann eine
Variable oder ein numerischer Ausdruck angegeben werden. Ist
<Schlüsselnummer> < 0, so wird die Indexdatei nicht über START / START und READ-NEXT / READS-NEXT,
sondern über GET_FIRST_RECORD und GET_NEXT_RECORD gelesen. Das geht deutlich schneller. Es
werden dann aber alle Datensätze der Indexdatei exportiert. Bei Angabe
einer <Schlüsselnummer> >= 0 kann dagegen an einer beliebigen Stelle
in der Indexdatei aufgesetzt werden. Ist
<Schlüsselnummer> > 0 und der Schlüssel existiert nicht, so liefert
EXPORT_CSV als Ergebnis –5. <CSV-Dateiname>
enthält den Namen der CSV-Datei, in die die Datensätze exportiert werden. <Spaltenüberschriften>
enthält durch <Trennzeichen> getrennt die Spaltenüberschriften, die in
die erste Zeile der CSV-Datei geschrieben werden. Ist
<Spaltenüberschriften> der Leerstring ²², so werden als
Spaltenüberschriften die Feldnamen ausgegeben. Besteht
<Spaltenüberschriften> nur aus Leerzeichen (ein oder mehrere Blanks),
so wird keine Überschriftszeile in die CSV-Datei geschrieben. <Feldnummern>
enthält durch Strichpunkt ; getrennt die Nummern der Felder, die exportiert
werden sollen. Wenn <Feldnummern> der Leerstring ²² ist, werden alle Felder der Indexdatei
exportiert. Achtung: <Feldnummern> darf keine Leerzeichen
enthalten! <Trennzeichen>
legt das Trennzeichen in der CSV-Datei fest. Ist <Trennzeichen> der
Leerstring ²², so wird als Trennzeichen
der Strichpunkt ; verwendet. <Datumsformat>
legt fest, in welchem Format Datumsfelder exportiert werden (z.B. TT.MM.JJJJ
oder MM-TT-JJJJ). Ist <Datumsformat> der Leerstring ²², so werden die Daten im Format JJJJMMTT
exportiert. Ist
<Hochkomma> <> 0, so werden die einzelnen Datenfelder in
Hochkommas ²...² eingeschlossen. Wird
ein <Makroname> angegeben, so wird der Makro vor jedem zu
exportierenden Datensatz ausgeführt. Wenn im Makro EBUS_DATA = 0 gesetzt wird, wird der aktuelle
Datensatz nicht exportiert, die Verarbeitung wird mit dem nächsten Datensatz
fortgesetzt. Wird EBUS_DATA = 99 gesetzt, so
wird der aktuelle Datensatz nicht exportiert und die Verarbeitung wird
beendet. EXPORT_CSV
liefert folgende Ergebniswerte:
|
||||||||||||||||||
|
Parameter: |
|
||||||||||||||||||
|
Beispiel: |
// Alle Datensätze aller Indexdateien
exportieren FOR I%=1 TO EBUS_FILENAME_SIZE
DATEI$ = LOWER$(NOBLANK$(1,EBUS_FILENAME$(I%)))
INITIALIZE DATEI$
H% = EXPORT_CSV(DATEI$,0,DATEI$+".csv","","",CHR$(9),"TT.MM.JJJJ",0)
IF H% <>
1
THEN ERRORMES = "Fehler " + STR$(H%) + " bei Datei " +
DATEI$ + ": " + ERRORTEXT$
ENDIF ENDLOOP |
||||||||||||||||||
|
Siehe
auch: |