4D Doc Center : IMPORT DATA

Home

4D v14.3

IMPORT DATA


IMPORT DATA ( DateiName {; Projekt {; *}} )

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

Beschreibung

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.

Systemvariablen und Mengen

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.