IMPORT SYLK

Der Befehl IMPORT SYLK importiert die Daten des Dokumentes Dokumentname im Format SYLK. Die so eingelesenen Daten werden in neuen Datensätzen der Tabelle Tabellenname gespeichert.
Der Parameter Tabellenname ist optional. Geben Sie ihn nicht an, wird die aktuelle Auswahl der Haupttabelle importiert.
IMPORT SYLK importiert die Felder und Variablen des aktuellen Eingabeformulars gemäß ihrer Eingabereihenfolge. Die Datenfelder des aktuellen Eingabeformulars werden in der Reihenfolge gefüllt, in der sie im Formular auftreten. Verwenden Sie ein Formular, das nur die Datenfelder oder eingebbaren Objekte für den Import enthält. Setzen Sie keine Schaltflächen oder andere Objekttypen im Importdokument. Objekte aus Unterformularen werden nicht importiert. Stimmt die Zahl der Felder oder Variablen nicht mit der Zahl der Datenfelder im Importdokument überein, ignoriert 4D alle zusätzlichen Werte.

Hinweis: Um sicherzustellen, dass die Daten in die korrekten Objekte importiert werden, wählen Sie das Objekt aus, in welches das erste Feld importiert werden soll, und setzen es nach vorne. Setzen Sie dann der Reihe nach Felder und Variablen nach vorne, um sicherzustellen, das Sie für jedes importierte Feld ein Feld oder eine Variable haben.

Für jeden importierten Datensatz wird ein Ereignis On Validate zur Formularmethode gesendet. Verwenden Sie im Eingabeformular Variablen, kopieren Sie über dieses Ereignis Daten von Variablen in Datenfelder.

Dokumentname kann den Pfadnamen für das zu importierende Dokument enthalten. Ist Dokumentname ein leerer Text, erscheint der Standarddialog zum Öffnen von Dokumenten. Annulliert der Benutzer diesen Dialog, wird der Import abgebrochen und die Systemvariable auf OK auf 0 gesetzt.

Während dem Import erscheint ein Ablaufbalken. Der Benutzer kann auf die Schaltfläche Stop klicken, um den Import abzubrechen. Bereits importierte Datensätze werden jedoch nicht entfernt. Wurde der Import erfolgreich ausgeführt, nimmt die Systemvariable OK den Wert 1 an. Trat ein Fehler auf oder wurde die Operation unterbrochen, hat sie den Wert 0. Über den Befehl MESSAGES OFF lässt sich die Ablaufanzeige ausblenden. 

Der Befehl verwendet standardmäßig den UTF-8 Zeichensatz. Da Dokumente im SYLK Format generell den Zeichensatz ISO-8859-1 nutzen, müssen Sie evtl. über den Befehl USE CHARACTER SET den passenden Zeichensatz angeben.

IMPORT SYLK verwendet standardmäßig den Tabulator (Code 9) als Trennung für Felder und die Zeilenschaltung (Code 13) als Trennung für Datensätze. Sie können diese beiden Trennzeichen ändern, wenn Sie den zwei Systemvariablen FldDelimit (Trennung für Felder) und RecDelimit (Trennung für Datensätze) andere Werte zuweisen. Der Benutzer kann die Standardeinstellung im Exportdialog ändern. Da Textfelder Zeilenschaltungen enthalten können, sollten Sie die Zeilenschaltung als Trennzeichen mit der nötigen Vorsicht verwenden.

Folgendes Beispiel importiert Daten aus einem SYLK Dokument. Die Methode legt zuerst das Eingabeformular an, so dass die Daten in korrekter Form importiert werden und zeigt dann den Import an:

OK hat den Wert 1, wenn der Import erfolgreich war. Trat ein Fehler auf, hat OK den Wert 0.