4D Doc Center : COPY DOCUMENT

4D v14.3

COPY DOCUMENT


COPY DOCUMENT ( nomFonte ; nomDest {; newName} {; *} )

Parâmetro	Tipo	Descrição
nomFonte	cadeia	Nome do documento a copiar
nomDest	cadeia	Nome do documento copiado
newName	cadeia	New name of copied file or folder
*	Operador	Substituir documento existente, se houver

Descrição

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.
Será gerado 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. Deve passar uma rota de acesso completa de pasta (cada elemento já deve existir no disco).
Se yá existir uma pasta com o mesmo nome da pasta designada pelo parâmetro nomFonte na localização definida pelo parâmetro nomDest e não está vazia, 4D verifica seu conteúdo antes de copiar os elementos. Um erro é gerado quando já existe um arquivo com o mesmo nome, a menos que tenha passado o parâmetro opcional *, que indica ao comando excluir e substituir o arquivo no lugar de destino.

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 parâmetro opcional novoNome, se passar, permite renomear o documento copiado a sua localização de destino (arquivo ou pasta). Quando se passa no contexto de uma cópia de arquivo, este parâmetro substitui o nome (se existir) passado no parâmetro nomDest.

Exemplo 1

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

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

Exemplo 2

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")

Exemplo 3

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

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

Exemplo 4

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

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

Exemplo 5

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

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

Exemplo 6

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\\"; *)

Exemplo 7

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

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

Exemplo 8

Os seguintes exemplos criam diferentes arquivos e pastas na pasta da base (exemplos em Windows). Em cada caso, a pasta "folder2" deve existir:

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

  //Cria o arquivo "folder2/name1"

 

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

  //Cria o arquivo "folder2/new"

 

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

  //Cria o arquivo "folder2/name2"

 

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

  //Cria o arquivo "folder2/new" (name2 se ignora)

 

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

  //Cria a pasta "folder2/folder1/"

 

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

  //Cria a pasta "folder2/new/"