EXPORT TEXT

4D - Documentation   Français   English   German   Spanish   Japanese   4D Programmiersprache, Befehle nach Themen   4D Programmiersprache, Befehle alphabetisch   4D Programmiersprache, Konstanten nach Themen   Back   Previous   Next

Version 11 (Geändert)


EXPORT TEXT ({Tabelle; }Dokument)

ParameterTypBeschreibung
TabelleTabelleTabelle, aus der Daten exportiert werden
sollen, oder Haupttabelle ohne Angabe
DokumentStringTextdokument für Empfangen der Daten

Beschreibung

Der Befehl EXPORT TEXT exportiert die aktuelle Auswahl der Tabelle Tabelle im aktuellen Ausgabeformular. Die Daten werden in das Dokument Dokument geschrieben.

Der Parameter Tabelle 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.

Dokument 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 Dokument ein leerer Text, erscheint der Standarddialog zum Öffnen von Dokumenten. Sie können nun das zu exportierende Dokument auswählen. In diesem Fall können Sie durch die Systemvariable Document den Namen des exportierten 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 Export ab. Die Systemvariable OK erhält ebenfalls den Wert 0. Bereits exportierte 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 Export-Operation die ASCII-Tabelle der ausführenden Plattform, außer Sie rufen vor dem Export den Befehl USE CHARACTER SET auf.

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. Sie sind vom Typ lange Ganzzahl. Sie sollten hier nicht zwei gleiche ASCII-Codes benutzen.

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.

Beispiel

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:

   OUTPUT FORM([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"

Referenz

EXPORT DIF, EXPORT SYLK, IMPORT TEXT, USE CHARACTER SET.

Systemvariablen und Mengen

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


4D - Documentation   Français   English   German   Spanish   Japanese   4D Programmiersprache, Befehle nach Themen   4D Programmiersprache, Befehle alphabetisch   4D Programmiersprache, Konstanten nach Themen   Back   Previous   Next