Version 11 (Geändert)
IMPORT TEXT ({Tabelle; }Dokument)
Parameter | Typ | Beschreibung | |
Tabelle | Tabelle | Tabelle, in die importiert werden soll, oder | |
Haupttabelle ohne Angabe | |||
Dokument | String | Textdokument, aus dem Daten importiert werden |
Beschreibung
Der Befehl IMPORT TEXT importiert die Daten des Dokumentes Dokument, ein Windows oder Macintosh Textdokument und liest sie in neu erstellte Datensätze der Tabelle Tabelle ein.
Der Parameter Tabelle ist optional. Geben Sie ihn nicht an, wird die aktuelle Auswahl der Haupttabelle importiert.
IMPORT TEXT 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. Legen Sie keine Schaltflächen oder andere Objekttypen in das 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.
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.
Dokument kann den Pfadnamen für das zu importierende Dokument enthalten. Ist Dokument ein leerer Text, erscheint der Standarddialog zum Öffnen von Dokumenten. Sie können nun das zu importierende Dokument auswählen. In diesem Fall können Sie durch die Systemvariable Document den Namen des importierten Dokumentes erhalten. Klicken Sie auf die Schaltfläche Öffnen, nimmt die Systemvariable OK den Wert 1 an. Trat ein Fehler auf, hat sie den Wert 0. Haben Sie den Befehl MESSAGES OFF nicht aufgerufen, erscheint die Ablaufanzeige auf dem Bildschirm. Mit der Schaltfläche Stop brechen Sie den Import ab. Die Systemvariable OK erhält ebenfalls den Wert 0. Bereits importierte Datensätze werden jedoch nicht entfernt.
Im Unicode Modus (Standardmodus) verwendet der Befehl standardmäßig den Zeichensatz UTF-8. Um diesen zu ändern, verwenden Sie den Befehl USE CHARACTER SET.
Im ASCII-Kompatibilitätsmodus verwendet die Importoperation die Standard-ASCII-Tabelle der jeweils eingesetzten Plattform, außer Sie rufen vor dem Import den Befehl USE CHARACTER SET auf.
IMPORT TEXT importiert die Daten mit 2 Trennzeichen:
Mit dem Tabulator (Code 9) als Trennung für Felder.
Mit der Zeilenschaltung (Code 13) als Trennung für Datensätze.
Sie können diese beiden Trennzeichen ändern, indem Sie die zwei Systemvariablen FldDelimit (Trennung für Felder) und RecDelimit (Trennung für Datensätze) ändern. Sie sind vom Typ lange Ganzzahl. Sie sollten hier nicht zwei gleiche ASCII-Codes benutzen.
Der Benutzer kann die Standardeinstellung im Importdialog ändern. Da Textfelder Zeilenschaltungen enthalten können, verwenden Sie die Zeilenschaltung als Trennzeichen mit der nötigen Vorsicht.
Beispiel
Folgendes Beispiel importiert Daten aus einem Textdokument. Die Methode legt zuerst das Eingabeformular an, so dass die Daten in korrekter Form importiert werden, ändert die 4D Variablen für Trennzeichen und zeigt dann den Import an:
INPUT FORM([People]; "Import") FldDelimit:=27 ` Setze Trennung für Felder auf Escape RecDelimit:=10 ` Setze Trennung für Datensatz auf Line Feed IMPORT TEXT([People];"NewPeople.txt") ` Importiere aus Dokument "NewPeople.txt"
Referenz
EXPORT TEXT, IMPORT DIF, IMPORT SYLK, USE CHARACTER SET.
Systemvariablen und Mengen
OK hat den Wert 1, wenn der Import erfolgreich war. Tritt ein Fehler auf, hat OK den Wert 0.