4D v14.3

EXPORT TEXT

Home

 
4D v14.3
EXPORT TEXT

EXPORT TEXT 


 

EXPORT TEXT ( {Tabellenname ;} Dokumentname ) 
Parameter Typ   Beschreibung
Tabellenname  Tabelle in Tabelle, aus der Daten exportiert werden sollen
Ohne Angabe Haupttabelle
Dokumentname  String in Textdokument für Empfangen der Daten

Der Befehl EXPORT TEXT exportiert die aktuelle Auswahl der Tabelle Tabellenname im aktuellen Ausgabeformular. Die Daten werden in das Dokument Dokumentname geschrieben. Tabellenname ist optional. Geben Sie ihn nicht an, wird die aktuelle Auswahl der Haupttabelle exportiert.

EXPORT TEXT exportiert die Felder und Variablen des aktuellen Ausgabeformulars gemäß ihrer Eingabereihenfolge. Die Datenfelder des aktuellen Ausgabeformulars 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 Export enthält. Legen Sie keine Schaltflächen oder andere Objekttypen in das Exportdokument. Objekte aus Unterformularen werden nicht exportiert.

Für jeden exportierten Datensatz wird ein Ereignis On Load zur Formularmethode gesendet. Verwenden Sie dieses Ereignis für Variablen im Exportdokument.

Dokumentname kann den Pfadnamen für das zu exportierende Dokument enthalten. Gibt es bereits ein Dokument mit demselben Namen, wird sein Inhalt gelöscht und mit dem neuen Inhalt überschrieben. Ist Dokumentname ein leerer Text, erscheint der Standarddialog zum Sichern von Dokumenten. Annulliert der Benutzer diesen Dialog, wird der Export abgebrochen und die Systemvariable auf OK auf 0 gesetzt.

Während dem Export erscheint ein Ablaufbalken. Der Benutzer kann auf die Schaltfläche Stop klicken, um den Export abzubrechen. Bereits importierte Datensätze werden jedoch nicht entfernt. Wurde der Export 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. Um diesen zu ändern, verwenden Sie den Befehl USE CHARACTER SET.

EXPORT TEXT exportiert 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. Der Benutzer kann die Standardeinstellung im Exportdialog ändern. Da Textfelder Zeilenschaltungen enthalten können, verwenden Sie die Zeilenschaltung beim Export von Textfeldern mit der nötigen Vorsicht.

Folgendes Beispiel exportiert Daten in ein Textdokument. Die Methode legt zuerst das Ausgabeformular an, so dass die Daten in korrekter Form exportiert werden, ändert die 4D Variablen für Trennzeichen und zeigt dann den Export an:

 FORM SET OUTPUT([People];"Export")
 FldDelimit:=27 ` Setze Trennzeichen für Datenfeld auf Escape
 RecDelimit:=10 ` Setze Trennzeichen für Datensatz auf Line Feed
 EXPORT TEXT([People];"NewPeople.txt") ` Exportiere in Dokument "NewPeople.txt"

OK hat den Wert 1, wenn der Export erfolgreich abgeschlossen wurde; tritt ein Fehler auf, hat OK den Wert 0.

 
EIGENSCHAFTEN 

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

Dieser Befehl ändert die Systemvariable OKDer Unicode Modus betrifft diesen Befehl

 
GESCHICHTE 

Geändert: 4D v11 SQL

 
SIEHE AUCH 

EXPORT DIF
EXPORT SYLK
IMPORT TEXT
USE CHARACTER SET

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)

Geerbt von : EXPORT TEXT ( 4D v12.4)