4D v14.3

EXPORT DATA

Home

 
4D v14.3
EXPORT DATA

EXPORT DATA 


 

EXPORT DATA ( DateiName {; Projekt {; *}} ) 
Parameter Typ   Beschreibung
DateiName  String in Kompletter Pfadname der Exportdatei
Projekt  Textvariable, BLOB Variable in Inhalt des Exportprojekts
in Neuer Inhalt des Exportprojekts (wenn Parameter * übergeben wurde)
Operator in Zeigt Exportdialog und aktualisiert das Projekt

Der Befehl EXPORT DATA exportiert Daten in die Datei DateiName. 4D kann Daten in folgenden Formaten exportieren: Text, Text mit fester Länge, XML, SYLK, DIF, DBF (dBase) und 4D.

Übergeben Sie in DateiName einen leeren String, zeigt EXPORT DATA den Standarddialog zum Sichern an. Hier kann der Benutzer Name, Typ und Ort der Exportdatei festlegen. Nach Bestätigen dieses Dialogs enthält die Systemvariable Document den Zugriffspfad und den Namen der Datei. Klickt der Benutzer auf die Schaltfläche Abbrechen, wird die Ausführung des Befehls gestoppt. Die Systemvariable OK hat dann den Wert 0 (Null).

Mit dem optionalen Parameter Projekt können Sie ein Projekt zum Exportieren der Daten verwenden. Damit wird der Export direkt ausgeführt, d.h. ohne Eingreifen des Benutzers (außer Sie verwenden die Option *, siehe unten). Übergeben Sie den optionalen Parameter Projekt nicht, wird das Dialogfenster für Export angezeigt. Der Benutzer kann die Exportparameter selbst festlegen oder ein bestehendes Exportprojekt laden.

Ein Exportprojekt enthält alle Exportparameter wie die Tabellen und Felder zum Exportieren, die Begrenzer, etc. Im Parameter Projekt können Sie entweder eine Textvariable mit XML oder mit einer Referenz auf ein zuvor vorhandenes DOM Element, bzw. ein BLOB übergeben. Projekte lassen sich per Programmierung (nur im XML Format) erstellen oder durch Laden der Parameter, die zuvor im Exportdialog definiert wurden. Im 2. Fall haben Sie dafür zwei Möglichkeiten:

  • Sie verwenden den Befehl EXPORT DATA mit einem leeren Parameter Projekt und dem optionalen Parameter *. Dann speichern Sie den Parameter Projekt in ein Feld vom Typ Text oder BLOB (siehe unten). Auf diese Weise können Sie das Projekt mit der Datendatei sichern.
  • Sie sichern das Projekt auf die Festplatte, laden es dann z.B. über die Funktion DOM Parse XML source und übergeben seine Referenz im Parameter Projekt.
Hinweis zur Kompatibilität: Ab 4D Version 12 werden Exportprojekte in XML codiert. 4D kann Exportprojekte, die mit einer früheren 4D Version im BLOB Format erstellt wurden, öffnen. Mit v12 erstellte Projekte lassen sich dagegen nicht mit Version 11 oder älter öffnen. Wir empfehlen deshalb zum Verwalten der Exportdateien Variablen vom Typ Text zu verwenden.

Ist der optionale Parameter * angegeben, wird das Dialogfenster für den Export mit den Parametern des Projekts angezeigt. So können Sie ein vordefiniertes Projekt einsetzen, und trotzdem einen bzw. mehrere Parameter ändern. Außerdem enthält der Parameter Projekt nach Schließen des Dialogfensters für den Export die Parameter des "neuen" Projekts. Sie können dann das neue Projekt in einem BLOB Feld, auf der Festplatte, etc. speichern.

War der Export erfolgreich, hat die Systemvariable OK den Wert 1.

Dieses Beispiel zeigt die Verwendung des Befehls EXPORT DATA, um Daten im binären Format zu exportieren.

  • Diese Methode macht eine Schleife in alle Tabellen der Datenbank und ruft die Methode ExportBinary auf:

 C_TEXT($ExportPath)
 C_LONGINT($i)
 $ExportPath:=Select folder("Wählen Sie den Export Ordner:")
 If(Ok=1)
    For($i;1;Get last table number
       If(Is table number valid($i))
          ExportBinary(Table($i);$ExportPath+Table name($i);True)
       End if
    End for
 End if

  • Hier ist der Code für die Methode ExportBinary:

 C_POINTER($1//Tabelle
 C_TEXT($2//Pfad der Zieldatei
 C_BOOLEAN($3//exportiere alle Datensätze
 C_LONGINT($i)
 C_TEXT($ref)
 $ref:=DOM Create XML Ref("Einstellungen-Import-Export")
  // Exportiere die Tabelle "$1" in '4D' binäres Format, alle Datensätze oder nur die aktuelle Auswahl
 DOM SET XML ATTRIBUTE($ref;"table_no";Table($1);"format";"4D";"all_records";$3)
  // Definition der Felder zum Exportieren
 For($i;1;Get last field number($1))
    If(Is field number valid($1;$i))
       $elt:=DOM Create XML element($ref;"field";"table_no";Table($1);"field_no";$i)
    End if
 End for
 EXPORT DATA($2;$ref)
 If(Ok=0)
    ALERT("Fehler während Export der Tabelle"+Table name($1))
 End if
 DOM CLOSE XML($ref)

Dieses Beispiel erstellt ein leeres Projekt und speichert die vom Benutzer gesetzten Parameter im Dialogfenster für den Export:

 C_TEXT($exportParams)
 EXPORT DATA("DocExport.txt";$exportParams;*) //Anzeige des Dialogfensters für den Export

Klickt der Benutzer im Standarddialog für Öffnen oder im Dialog für Export auf die Schaltfläche Abbrechen, hat die Systemvariable OK den Wert 0 (Null). War der Export erfolgreich, hat die Systemvariable OK den Wert 1.

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Import und Export
Nummer: 666

Dieser Befehl ändert die Systemvariable OKDieser Befehl ändert die Systemvariable Document

 
GESCHICHTE 

Geändert: 4D 2003
Geändert: 4D v12

 
SIEHE AUCH 

EXPORT DIF
EXPORT SYLK
EXPORT TEXT
IMPORT DATA

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v12.4)
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v13.5)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)

Geerbt von : EXPORT DATA ( 4D v11 SQL Release 6)