1.4.1 StpExport – Exportieren von Datensätzen
StpExport(strBuf,nPath,strFile,strFileOpenMode,nFieldHandling,nMegasRecord);
Argumente
strBuf
Name des Buffers. Der BufferName ist einer Datenbankdatei zugeordnet.
 
nPath
Pfad, über den die Datei gelesen wird, muss den Werten aus StpPreSetKeys entsprechen.
 
strFile
Name und Pfad der Exportdatei.
 
strFileOpenMode
Die Art wie die Datei geöffnet wird:
„w“
Die Datei wird neu erstellt. Existiert sie bereits, wird der Inhalt überschrieben.
„a“
Existiert die Datei, werden die Daten am Ende der Datei angehängt, anderenfalls wird sie angelegt
 
nFieldHandling
Die Art wie Felder exportiert werden:
  • Die Länge der Felder bleibt erhalten und kein Feldtrenner wird gesetzt. Der Satz wird in die Exportdatei geschrieben, wie er aus der Datenbank gelesen wurde.
  • Die Länge der Felder bleibt erhalten. Die Felder werden mit einem Trenner abgegrenzt.
  • Die Leerzeichen der Felder werden auf beiden Seiten entfernt und die Felder mit Trennern versehen.
  • Analog 2, Die Felder werden zusätzlich gemäß infra-Standard formatiert. Wurden vor dem Aufruf von StpExport, mit Hilfe der Funktion StpPreDelimits Delimiter gesetzt, so werden die infra-Standarddelimiter ersetzt.
  • Die Daten werden analog der SQL-Replikation aufbereitet und in die ExportDatei geschrieben.
 
NInclMegasRecord
Behandlung des ersten Datensatzes der Datenbankdatei:
0
Der erste Satz der Datenbank, der Vorbelegungssatz, (MEGAS-Satz), wird nicht exportiert.
1
Der Vorbelegungssatz wird exportiert.
Rückgabewert
StpRc:
0
Ok
<>0
Fehler bei der Ausführung der Funktion
Beschreibung
Datensätze (alle oder ausgewählte) einer infra-Datei werden komplett oder feldweise in eine ASCII-Datei exportiert.
Der Export kann konfiguriert werden mit den Befehlen StpPreSetKeys (von/bis Schlüssel), StpPreSelectField/ StpPreSelectBuf (weitere Selektion über einen bestimmten Feld-/Pufferinhalt), StpPreValueField (Feldinhalt wird für den Export mit einer Konstante belegt) und StpPreFieldSubSet (nur bestimmte Feldauswahl wird exportiert).
Diese Konfigurationsbefehle (außer StpPreSetKeys) können mehrfach abgesetzt werden.
Ab infra-Version 7402:
Falls die Systemfelder vorhanden sind, werden die darin eventuell enthaltenen Binärzeichen beim Export durch eine Null „0“ ersetzt.
Funktionsart
STPFunktion
Beispiel
Siehe Beispielskript …\infra\SETUP\BEISPIELE\EXP_065.STP, Auszug:
StpExport("065",lPath,strFile,strFOM,lFH,lRec0);