EXPORT DIF

Version 3

EXPORT DIF ({Tabellenname; }Dokumentname)

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 Ö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.

Während des Exports wird die Standard-ASCII-Tabelle der jeweils eingesetzten Plattform benutzt. Wollen Sie zum Beispiel Sonderzeichen ausfiltern oder Daten von einer Plattform mit einer anderen ASCII-Tabelle zuerst konvertieren, rufen Sie vor dem Import den Befehl USE ASCII MAP auf.

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:

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

EXPORT SYLK, EXPORT TEXT, IMPORT DIF, USE ASCII MAP.

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