4D v14.3

IMPORT DATA

Home

 
4D v14.3
IMPORT DATA

IMPORT DATA 


 

IMPORT DATA ( DateiName {; Projekt {; *}} ) 
Parameter Typ   Beschreibung
DateiName  String in Zugriffspfad und Name der Importdatei
Projekt  Textvariable, BLOB Variable in Inhalt des Importprojekts
in Neuer Inhalt des Importprojekts (wenn der Parameter * übergeben wurde)
Operator in Zeigt das Dialogfenster für den Import und aktualisiert das Projekt

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

Übergeben Sie in DateiName einen leeren String, zeigt IMPORT DATA den Standarddialog zum Öffnen an. Hier kann der Benutzer Name, Typ und Ort der Importdatei 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 Importieren der Daten verwenden. Damit wird der Import direkt ausgeführt, ohne Eingreifen des Benutzers (außer mit der Option *, siehe unten) Übergeben Sie den optionalen Parameter Projekt nicht, wird das Dialogfenster für Import angezeigt. Der Benutzer kann die Importparameter selbst festlegen oder ein bestehendes Importprojekt laden.

Ein Importprojekt enthält alle Importparameter wie die Tabellen und Felder, in die importiert wird, 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 Importdialog definiert wurden. Im 2. Fall haben Sie dafür zwei Möglichkeiten:

  • Sie verwenden den Befehl IMPORT 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 Importprojekte in XML codiert. 4D kann Importprojekte, 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 Importdateien Variablen vom Typ Text zu verwenden.

Ist der optionale Parameter * angegeben, wird das Dialogfenster für den Import 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 Import die Parameter des "neuen" Projekts. Sie können dann das neue Projekt in einem BLOB Feld, auf der Festplatte, etc. speichern.

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

Hinweis: Unter dem Befehl EXPORT DATA finden Sie ein Beispiel zum Definieren eines leeren Projekts.

Klickt der Benutzer im Standarddialog für Sichern bzw. im Dialogfenster für den Import auf die Schaltfläche Abbrechen, hat die Systemvariable OK den Wert 0 (Null). War der Import erfolgreich, hat die Systemvariable OK den Wert 1.

 
EIGENSCHAFTEN 

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

Dieser Befehl ändert die Systemvariable OK

 
GESCHICHTE 

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

 
SIEHE AUCH 

EXPORT DATA
IMPORT DIF
IMPORT SYLK
IMPORT TEXT

 
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 : IMPORT DATA ( 4D v11 SQL Release 6)