4D Doc Center : EXPORT DIF

Home

4D v14.3

EXPORT DIF


EXPORT DIF ( {Tabellenname ;} Dokumentname )

Parameter	Typ	Beschreibung
Tabellenname	Tabelle	Tabelle, deren Auswahl exportiert werden soll Ohne Angabe Haupttabelle
Dokumentname	String	Name des Exportdokuments

Beschreibung

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

EXPORT DIF 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. Setzen 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. Da Dokumente im DIF Format generell den Zeichensatz IBM437 verwenden, müssen Sie evtl. über den Befehl USE CHARACTER SET den passenden Zeichensatz angeben.

EXPORT DIF 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, indem 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, verwenden Sie die Zeilenschaltung als Trennzeichen mit der nötigen Vorsicht.

Beispiel

Folgendes Beispiel exportiert Daten in ein DIF Dokument. Die Methode legt zuerst das Ausgabeformular an, so dass die Daten in korrekter Form exportiert werden und zeigt dann den Export an:

 FORM SET OUTPUT([People];"Export")

 EXPORT DIF([People];"NewPeople") ` Export in das Dokument "NewPeople"

Systemvariablen und Mengen

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