<<

Inhaltsverzeichnis

Suchen

>>

 

COPY_FILE_TO_CLIENT

 

 

Funktion

 

 

Syntax:

COPY_FILE_TO_CLIENT(<Quelle>,<Ziel>)

 

<Quelle>

= <STRING-AUSDRUCK>

<Ziel>

= <STRING-AUSDRUCK>

 

 

Bedeutung:

Diese Funktion kopiert im Java-2T-Programm die Datei <Quelle> vom Server zur Datei <Ziel> auf dem Client.

 

Ist das Programm kein 2T-Programm, so ist COPY_FILE_TO_CLIENT identisch mit COPY_FILE.

 

Bei Html-Programmen muss der Browser die Datei auf dem Clientrechner speichern. Aus Sicherheitsgründen ist es nicht möglich, mit Javascript eine Datei auf dem Clientrechner direkt zu speichern. Deshalb erscheint ein Dialog, auf dem der Anwender durch aktives Anklicken des Dateinamens die Datei speichern kann.

 

Beispiel: Die Datei daten.dat soll vom Webserver aus dem Verzeichnis d:\daten in das Verzeichnis c:\temp des Clientrechners kopiert werden. Dies entspricht folgendem Funktionsaufruf im Makro:

 

RET% = COPY_FILE_TO_CLIENT("d:\daten\daten.dat","c:\temp\daten.dat")

 

Im Browser erscheint dann folgender Dialog:

 

 

Der Anwender muss jetzt selbst aktiv werden, damit die Datei gespeichert werden kann. Dazu muss er mit der rechten Maustaste auf daten.dat klicken, 'Ziel speichern unter' anklicken und dann das Verzeichnis c:\temp auswählen.

 

Achtung: Es kann nicht festgestellt werden, ob der Anwender die Datei wirklich gespeichert hat. Es wird auch dann als Ergebnis 0 geliefert, wenn der Anwender die Datei nicht oder in einem anderen Verzeichnis oder unter einem anderen Namen gespeichert hat.

 

COPY_FILE_TO_CLIENT liefert folgende Ergebniswerte:

 

Ergebnis

Bedeutung

0

Datei wurde erfolgreich kopiert.

-1

ERRORTEXT$ enthält die Fehlermeldung.

1

Quelldatei existiert nicht oder ist Verzeichnis.

2

Zieldatei kann nicht erzeugt werden.

1080

ERRORTEXT$ enthält die Fehlermeldung.

 

Parameter:

Quelle

Dateiname Quelle

Ziel

Dateiname Ziel

 

Beispiel:

RET% = COPY_FILE_TO_CLIENT("test.dat","/media/floppy/test.dat")

IF RET% <> 0

THEN ERRORMES = "Fehler: " + ERRORTEXT$

ENDIF

 

Siehe auch:

COPY_FILE

GET_FILE_FROM_CLIENT$

COPY_FILE_FROM_CLIENT