COPY DOCUMENT

4D v20 R7

COPY DOCUMENT


COPY DOCUMENT ( nomFuente ; nomDest {; nuevNombre} {; *} )

Parámetro	Tipo	Descripción
nomFuente	Cadena	Nombre del documento a copiar
nomDest	Cadena	Nombre del documento copiado
nuevNombre	Cadena	Nuevo nombre del archivo o carpeta copiado
*	Operador	Reemplazar documento existente si lo hay

Descripción

El comando COPY DOCUMENT copia el documento especificado por nomFuente en la ubicación especificada por nomDest.

Copia de archivo
En este caso, el parámetro nomFuente debe contener una ruta de acceso completa del archivo, expresada con respecto a la raíz del volumen.
El parámetro nomDest puede contener varios tipos de lugares:
- una ruta de acceso completa del archivo expresada con respecto a la raíz del volumen: el archivo se copia en esta ubicación
- un nombre de archivo o una ruta de acceso del archivo relativa: el archivo se copia en la carpeta de la base (las subcarpetas ya deben existir)
- una ruta de acceso completa de la carpeta o una ruta relativa a la carpeta de la base (nomDest debe terminar con el separador de carpeta de la plataforma): el archivo se copia en la carpeta designada. Estas carpetas ya deben existir en el disco, no se crean.
Se generará un error si ya hay un documento llamado nomDest a menos que haya especificado el parámetro opcional * que le indica a COPY DOCUMENT que borre y remplace el documento en la ubicación de destino en este caso.

Copia de carpeta
Para indicar que se designa una carpeta, las cadenas pasadas en nomFuente y nomDest deben terminar con un separador de carpetas de la plataforma. Por ejemplo, en Windows "C: \\Element\\" designa una carpeta y "C:\\Element" designa un archivo.
Para copiar una carpeta, pase su ruta de acceso completa en nomFuente. Esta carpeta debe existir en el disco. Cuando una carpeta se define en el parámetro nomFuente, una carpeta también deberá designarse en el parámetro nomDest. Debe pasar una ruta de acceso completa de carpeta (cada elemento ya debe existir en el disco).
Si ya existe una carpeta con el mismo nombre de la carpeta designada por el parámetro nomFuente en la ubicación definida por el parámetro nomDest y no está vacía, 4D verifica su contenido antes de copiar los elementos. Un error se genera cuando ya existe un archivo con el mismo nombre, a menos que haya pasado el parámetro opcional *, que indica al comando borrar y remplazar el archivo en la ubicación de destino.

Note que puede pasar un archivo en el parámetro nomFuente y una carpeta en el parámetro nomDest, para copiar un archivo en una carpeta.

El parámetro opcional nuevoNombre, si se pasa, permite renombrar el documento copiado a su ubicación de destino (archivo o carpeta). Cuando se pasa en el contexto de una copia de archivo, este parámetro remplaza el nombre (si lo hay) pasado en el parámetro nomDest.

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

  //crea el archivo "folder2/name1"

 

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

  //crea el archivo "folder2/new"

 

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

  //crea el archivo "folder2/name2"

 

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

  //crea el archivo "folder2/new" (name2 se ignora)

 

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

  //crea la carpeta "folder2/folder1/"

 

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

  //crea la carpeta "folder2/new/"

Ver también

Documentos del sistema
MOVE DOCUMENT

COPY DOCUMENT

Descripción

Ejemplo 1

Ejemplo 2

Ejemplo 3

Ejemplo 4

Ejemplo 5

Ejemplo 6

Ejemplo 7

Ejemplo 8