4D Doc Center : COPY DOCUMENT

4D v13.4

COPY DOCUMENT


COPY DOCUMENT ( nomFonte ; nomDest {; *} )

Parâmetro	Tipo	Descrição
nomFonte	cadeia	Nome do documento a copiar
nomDest	cadeia	Nome do documento copiado
*	Operador	Substituir documento existente, se houver

O comando COPY DOCUMENT copia o documento especificado por nomFonte na localização especificada por nomDest.

Cópia de arquivos
Este caso, o parâmetro nomFonte deve conter um caminho de arquivo completo, expressa em relação à raiz do volume.
O parâmetro nomDest pode conter vários tipos de locais:
- um caminho de arquivo completo expressa com relação à raiz do volume: o arquivo é copiado para este local
- um nome de arquivo ou caminho do arquivo relativo: o arquivo é copiado para a pasta de banco de dados (as subpastas já deve existir)
- um caminho de pasta completo ou um caminho relativo para a pasta base de dados (nomDest deve terminar com o separador de pasta para a plataforma): o arquivo é copiado para a pasta designada. Essas pastas já devem existir no disco, não são criadas.
Se gerará um erro se já houver um documento chamado nomDest a menos que tenha especificado o parâmetro opcional * que lhe indica a COPY DOCUMENT que apague e substitua o documento existente pelo documento de destino.

Cópia de pastas
Para indicar que você está designando uma pasta, as sequências passadas em nomFonte e nomDest deve terminar com um separador de pasta para a plataforma. Por exemplo, no Windows "C:\\Element\\" designa uma pasta e "C:\\Element" designa um arquivo.
Para copiar uma pasta, passe o seu caminho completo em nomFonte. Esta pasta já deve existir no disco. Quando uma pasta é definida no parâmetro nomFonte, a pasta deve também ser designada no parâmetro nomDest (caminho completo). As pastas designadas pelo nomDest já deve existir no disco, não são criadas.
Atenção: o conteúdo existente da pasta nomDest são sempre excluídas antes de iniciar a cópia. Neste caso, o parâmetro * é ignorada quando ele é passado.

Note que você pode passar um arquivo no parâmetro nomFonte e uma pasta no parâmetro nomDest, a fim de copiar um arquivo em uma pasta.

O exemplo abaixo duplica um documento em sua própria pasta:

COPY DOCUMENT("C:\\PASTA\\DocNome";"C:\\PASTA\\DocNome2")

O exemplo abaixo copia um documento na pasta do banco (sempre e quando C:\\PASTA não seja a pasta do banco):

COPY DOCUMENT("C:\\PASTA \\DocNome";"DocNome")

O exemplo abaixo copia um documento de um volume a outro:

COPY DOCUMENT("C:\\PASTA \\DocNome";"F:\\Arquivos\\DocNome.OLD")

O exemplo abaixo duplica um documento em sua própria pasta, substituindo uma cópia existente:

COPY DOCUMENT("C:\\PASTA \\DocNome";"C:\\PASTA \\DocNome2";*)

Cópia de um arquivo em uma pasta específica, mantendo o mesmo nome:

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

Cópia de um arquivo em uma pasta específica, mantendo o mesmo nome e substituir o documento existente:

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

Copia de uma pasta para outra pasta (ambas as pastas já devem estar presentes no disco):

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