4D v14.3
COPY DOCUMENT
- 4D Programmiersprache
-
- Systemdokumente
-
- Einführung in Systemdokumente
- Append document
- CLOSE DOCUMENT
- Convert path POSIX to system
- Convert path system to POSIX
- COPY DOCUMENTUpd
- CREATE ALIAS
- Create document
- CREATE FOLDER
- DELETE DOCUMENT
- DELETE FOLDER
- Document creator
- DOCUMENT LIST
- Document to textNew
- FOLDER LIST
- GET DOCUMENT ICON
- Get document position
- GET DOCUMENT PROPERTIES
- Get document size
- Get localized document path
- MAP FILE TYPES
- MOVE DOCUMENT
- Open document
- RESOLVE ALIAS
- Select document
- Select folder
- SET DOCUMENT CREATOR
- SET DOCUMENT POSITION
- SET DOCUMENT PROPERTIES
- SET DOCUMENT SIZE
- SET DOCUMENT TYPE
- SHOW ON DISK
- Test path name
- TEXT TO DOCUMENTNew
- VOLUME ATTRIBUTES
- VOLUME LIST
- Document type
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 | |||||
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.
- 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.
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.
Folgendes Beispiel dupliziert ein Dokument in seinen eigenen Ordner:
COPY DOCUMENT("C:\\FOLDER\\DocName";"C:\\FOLDER\\DocName2")Folgendes Beispiel kopiert ein Dokument in den Datenbankordner (vorausgesetzt C:\\FOLDER ist nicht der Datenbankordner):
COPY DOCUMENT("C:\\FOLDER\\DocName";"DocName")Folgendes Beispiel kopiert ein Dokument von einem Volume zu einem anderen:
COPY DOCUMENT("C:\\FOLDER\\DocName";"F:\\Archives\\DocName.OLD")Folgendes Beispiel dupliziert ein Dokument in seinen eigenen Ordner und überschreibt die bereits vorhandene Kopie:
COPY DOCUMENT("C:\\FOLDER\\DocName";"C:\\FOLDER\\DocName2";*)Eine Datei in einen bestimmten Ordner kopieren, unter Beibehaltung des Namens:
COPY DOCUMENT("C:\\Projects\\DocName";"C:\\Projects\\")Eine Datei in einen bestimmten Ordner kopieren, unter Beibehaltung des Namens und mit Überschreiben des vorhandenen Dokuments:
COPY DOCUMENT("C:\\Projects\\DocName";"C:\\Projects\\"; *)Einen Ordner in einen anderen Ordner kopieren (beide Ordner müssen bereits auf der Festplatte vorhanden sein):
COPY DOCUMENT("C:\\Projects\\";"C\\Archives\\2011\\")Die folgenden Beispiele erstellen unterschiedliche Dateien und Ordner im Datenbankordner (Beispiele unter Windows). In allen Fällen muss der Ordner "folder2" vorhanden sein:
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/"
Produkt: 4D
Thema: Systemdokumente
Nummer:
541
Erstellt: 4D v6
Geändert: 4D v13
Geändert: 4D v14
Einführung in Systemdokumente
MOVE DOCUMENT
4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)
Geerbt von : COPY DOCUMENT ( 4D v13.5)
