COPY DOCUMENT

Home

4D v20 R7

COPY DOCUMENT


COPY DOCUMENT ( QuellName ; ZielName {; Neuer Name} {; *} )

Parameter	Typ	Beschreibung
QuellName	String	zu kopierender Pfadname der Datei oder des Ordners
ZielName	String	Name oder Pfadname der kopierten Datei bzw. des Ordners
Neuer Name	String	Neuer Name der kopierten Datei bzw. des Ordners
*	Operator	Überschreibe Dokument, wenn vorhanden

Beschreibung

Der Befehl COPY DOCUMENT kopiert die in QuellName angegebene Datei bzw. den Ordner an den in ZielName angegebenen Ort und benennt es um (optional).

Dateien kopieren
In diesem Fall muss der Parameter QuellName den kompletten Pfadnamen enthalten gemäß dem Ursprung des Volumes.
Der Parameter ZielName kann verschiedene Typen enthalten:
- Den kompletten Pfadnamen der Datei gemäß dem Ursprung des Volumes: Die Datei wird an diese Stelle kopiert.
- Einen Dateinamen oder relativen Pfadnamen der Datei: Die Datei wird in den Ordner der Datenbank kopiert (der Unterordner muss bereits vorhanden sein)
- Einen kompletten Pfadnamen des Ordners oder einen Pfadnamen in Bezug auf den Ordner der Datenbank (ZielName muss mit dem Trenner für Ordner der jeweiligen Plattform enden): Die Datei wird in den angegebenen Ordner kopiert. Diese Ordner müssen bereits auf der Festplatte vorhanden sein, sie werden nicht angelegt.
Gibt es bereits ein Dokument mit Namen ZielName, wird ein Fehler erzeugt, außer Sie geben den optionalen Parameter * an, der COPY DOCUMENT anweist, das am Zielort vorhandene Dokument zu löschen und zu ersetzen.

Ordner kopieren
Für einen Ordner müssen die Zeichenketten, übergeben in QuellName und ZielName, mit dem Trenner der jeweiligen Plattform enden. Unter Windows bezeichnet z.B. "C:\\Element\\" einen Ordner und "C:\\Element" eine Datei.
Um einen Ordner zu kopieren, übergeben Sie in QuellName den kompletten Pfadnamen. Dieser Ordner muss bereits auf der Festplatte vorhanden sein. Geben Sie im Parameter QuellName einen Ordner an, müssen Sie auch im Parameter ZielName einen Ordner angeben. Sie müssen den kompletten Pfadnamen übergeben, wobei jedes Element bereits auf der Festplatte vorhanden sein muss
Gibt es an der im Parameter ZielName angegebenen Stelle bereits einen Ordner mit demselben Namen wie im Parameter QuellName angegeben, und ist er nicht leer, prüft 4D vor dem Kopieren der Einträge seinen Inhalt. Existiert bereits eine Datei mit demselben Namen, wird ein Fehler erzeugt, außer der optionale Parameter * wurde übergeben. In diesem Fall wird die Datei an der in ZielName angegebenen Stelle gelöscht und ersetzt.

Wollen Sie eine Datei in einen Ordner kopieren, können Sie in QuellName eine Datei und in ZielName einen Ordner übergeben.
Ist der optionale Parameter NeuerName übergeben, benennt er das kopierte Dokument an seinem Zielort um (Datei oder Ordner). Wird er beim Kopieren einer Datei übergeben, ersetzt er den Namen (sofern vorhanden) im Parameter ZielName.

 COPY DOCUMENT("folder1\\name1";"folder2\\")

  //erstellt die Datei "folder2/name1"

 

 COPY DOCUMENT("folder1\\name1";"folder2\\" ; "new")

  //erstellt die Datei "folder2/new"

 

 COPY DOCUMENT("folder1\\name1";"folder2\\name2")

  //erstellt die Datei "folder2/name2"

 

 COPY DOCUMENT("folder1\\name1";"folder2\\name2";"new")

  //erstellt die Datei "folder2/new" (name2 wird ignoriert)

 

 COPY DOCUMENT("folder1\\" ; "folder2\\")

  //erstellt den Ordner "folder2/folder1/"

 

 COPY DOCUMENT("folder1\\" ; "folder2\\" ; "new")

  //erstellt den Ordner "folder2/new/"

Siehe auch

Einführung in Systemdokumente
MOVE DOCUMENT

COPY DOCUMENT

Beschreibung

Beispiel 1

Beispiel 2

Beispiel 3

Beispiel 4

Beispiel 5

Beispiel 6

Beispiel 7

Beispiel 8