4D Doc Center : COPY DOCUMENT

4D v13.4

COPY DOCUMENT


COPY DOCUMENT ( nomFuente ; nomDest {; *} )

Parámetro	Tipo	Descripción
nomFuente	Cadena	Nombre del documento a copiar
nomDest	Cadena	Nombre del documento copiado
*	Operador	Reemplazar documento existente si lo hay

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 siguiente ejemplo duplica un documento en su propia carpeta:

COPY DOCUMENT("C:\\CARPETA\\DocNombre";"C:\\CARPETA\\DocNombre2")

El siguiente ejemplo copia un documento en la carpeta de la base (siempre y cuando C:\\CARPETA no sea la carpeta de la base):

COPY DOCUMENT("C:\\CARPETA \\DocNombre";"DocNombre")

El siguiente ejemplo copia un documento de un volumen a otro:

COPY DOCUMENT("C:\\CARPETA \\DocNombre";"F:\\Archivos\\DocNombre.OLD")

El siguiente ejemplo duplica un documento en su propia carpeta, sobrescribiendo una copia existente:

COPY DOCUMENT("C:\\CARPETA \\DocNombre";"C:\\CARPETA \\DocNombre2";*)

Copia de un archivo en una carpeta específica conservando el mismo nombre:

COPY DOCUMENT("C:\\Projects\\DocName";"C:\\Projects\\")

Copiar un archivo en una carpeta específica conservando el mismo nombrey remplazando el documento existente:

COPY DOCUMENT("C:\\Projects\\DocName";"C:\\Projects\\"; *)

Copia de una carpeta en otra carpeta (ambas carpetas deben existir en el disco):

COPY DOCUMENT("C:\\Projects\\";"C\\Archives\\2011\\")