<<

Inhaltsverzeichnis

Suchen

>>

 

EXPORT_CSV

 

 

Funktion

 

 

Syntax:

EXPORT_CSV(<Indexdateiname>,<Schlüsselnummer>,<CSV-Dateiname>,<Spaltenüberschriften>,           <Feldnummern>,<Trennzeichen>,<Datumsformat>,<Hochkomma> [,<Makroname>])

 

<Indexdateiname>

= <INDEXDATEI>

<Schlüsselnummer>

= <NUM-AUSDRUCK>

<CSV-Dateiname>

= <STRING-AUSDRUCK>

<Spaltenüberschriften>

= <STRING-AUSDRUCK>

<Feldnummern>

= <STRING-AUSDRUCK>

<Trennzeichen>

= <STRING-AUSDRUCK>

<Datumsformat>

= <STRING-AUSDRUCK>

<Hochkomma>

= <NUM-AUSDRUCK>

<Makroname>

= <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:

 

Ergebnis

Bedeutung

1

Kein Fehler

-1

Die Indexdatei existiert nicht.

-2

Keine zu exportierenden Daten gefunden.

-3

Die Indexdatei ist fehlerhaft.

-4

Fehler beim Öffnen der CSV-Datei. OK enthält die Fehlernummer, ERRORTEXT$ enthält den Fehlertext.

-5

Der Schlüssel <Schlüsselnummer> existiert nicht.

 

Parameter:

Indexdateiname

Name der Indexdatei

Schlüsselnummer

Nummer des Schlüssels (0 = Primärkey, 1,... = Sekundärkey)

CSV-Dateiname

Name der CSV-Datei

Spaltenüberschriften

Enthält durch Strichpunkt getrennt die Spaltenüberschriften.

Feldnummern

Enthält die Nummern der Felder, die exportiert werden sollen.

Trennzeichen

Enthält das Trennzeichen in der CSV-Datei.

Datumsformat

Enthält das Format, in dem Datumsfelder exportiert werden.

Hochkomma

Legt fest, ob die einzelnen Feldwerte in Hochkommas ²...² eingeschlossen werden.

0 = Keine Hochkommas

sonst = Alle Feldwerte werden in Hochkommas eingeschlossen.

Makroname

Name des Makros, der vor jedem zu exportierenden Datensatz aufgerufen wird.

 

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:

COPY_JDBC_INDEXFILE_TO_EBUS

COPY_EBUS_INDEXFILE_TO_JDBC

EBUS_DATA

GET_FIRST_RECORD

GET_NEXT_RECORD