4D v16.3
COPIER DOCUMENT
- 4D - Langage
-
- Documents système
-
- Présentation des documents système
- Ajouter a document
- ASSOCIER TYPES FICHIER
- CHANGER CREATEUR DOCUMENT
- CHANGER POSITION DANS DOCUMENT
- CHANGER PROPRIETES DOCUMENT
- CHANGER TAILLE DOCUMENT
- CHANGER TYPE DOCUMENT
- Convertir chemin POSIX vers systeme
- Convertir chemin systeme vers POSIX
- COPIER DOCUMENT
- Createur document
- CREER ALIAS
- Creer document
- CREER DOSSIER
- DEPLACER DOCUMENT
- Document vers texte
- FERMER DOCUMENT
- Lire chemin document localise
- LIRE ICONE DOCUMENT
- LISTE DES DOCUMENTS
- LISTE DES DOSSIERS
- LISTE DES VOLUMES
- MONTRER SUR DISQUE
- Ouvrir document
- Position dans document
- PROPRIETES DOCUMENT
- PROPRIETES DU VOLUME
- RESOUDRE ALIAS
- Selectionner document
- Selectionner dossier
- SUPPRIMER DOCUMENT
- SUPPRIMER DOSSIER
- Taille document
- Tester chemin acces
- TEXTE VERS DOCUMENT
- Type document
COPIER DOCUMENT
| COPIER DOCUMENT ( nomSource ; nomDest {; nouvNom} {; *} ) | ||||||||
| Paramètre | Type | Description | ||||||
| nomSource | Chaîne |
|
Chemin d’accès du fichier ou du dossier à copier | |||||
| nomDest | Chaîne |
|
Nom ou chemin d’accès du fichier ou du dossier copié | |||||
| nouvNom | Chaîne |
|
Nouveau nom du fichier ou du dossier copié | |||||
| * | Opérateur |
|
Remplacer le document existant le cas échéant | |||||
La commande COPIER DOCUMENT copie le fichier ou dossier désigné par nomSource à l'emplacement désigné par nomDest et le renomme optionnellement.
- Copie de fichier
Dans ce cas, le paramètre nomSource peut contenir :- soit un chemin d'accès complet de fichier, exprimé par rapport à la racine du volume,
- soit un chemin d'accès relatif au dossier de la base.
- un chemin d'accès complet de fichier exprimé par rapport à la racine du volume : le fichier est recopié à cet emplacement
- un nom de fichier ou un chemin d'accès de fichier relatif au dossier de la base : le fichier est recopié dans le dossier de la base (les sous-dossiers doivent exister)
- un chemin d'accès de dossier complet ou relatif au dossier de la base (nomDest doit se terminer par un séparateur de dossier de la plate-forme) : le fichier est recopié dans le dossier désigné. Les dossiers doivent déjà exister sur le disque, il ne sont pas pas créés.
- Copie de dossier
Pour indiquer que vous désignez un dossier, les chaînes passées dans nomSource et nomDest doivent se terminer par un séparateur de dossier de la plate-forme. Par exemple, sous Windows "C:\\Element\\" désigne un dossier et "C:\\Element" désigne un fichier.
Pour recopier un dossier, passez son chemin d’accès complet dans nomSource. Ce dossier doit exister sur le disque.
Lorsqu’un dossier est défini dans le paramètre nomSource, un dossier doit également être désigné dans le paramètre nomDest. Vous devez passer un chemin d’accès complet de dossier (dont chaque élément doit déjà exister sur le disque).
Si un dossier du même nom que celui désigné par le paramètre nomSource existe déjà à l’emplacement défini par nomDest et n’est pas vide, 4D vérifie son contenu avant de copier les éléments. Une erreur est générée si un fichier du même nom existe déjà, à moins que vous n’ayez spécifié le paramètre optionnel *, qui indique à la commande de supprimer et de remplacer le document à l’emplacement de destination dans ce cas.
A noter que vous pouvez passer un fichier dans le paramètre nomSource et un dossier dans le paramètre nomDest, afin de copier un fichier dans un dossier.
Le paramètre optionnel nouvNom, s'il est passé, permet de renommer le document copié à son emplacement de destination (fichier ou dossier). Lorsqu’il est passé dans le contexte d’une copie de fichier, ce paramètre remplace le nom éventuellement passé via le paramètre nomDest.
L'exemple suivant duplique un document dans son propre dossier :
COPIER DOCUMENT("C:\\DOSSIER\\LeDoc";"C:\\DOSSIER\\LeDoc2")L'exemple suivant copie un document dans le dossier de la base (dans la mesure où C:\\DOSSIER n'est pas le dossier de la base) :
COPIER DOCUMENT("C:\\DOSSIER\\LeDoc";"LeDoc")L'exemple suivant copie un document d'un volume vers un autre :
COPIER DOCUMENT("C:\\DOSSIER\\LeDoc";"F:\\Archives\\LeDoc.OLD")L'exemple suivant duplique un document dans son propre dossier, écrasant la précédente copie si elle existe :
COPIER DOCUMENT("C:\\DOSSIER\\LeDoc";"C:\\DOSSIER\\LeDoc2";*)Copie d’un fichier dans un dossier spécifique en conservant le même nom :
COPIER DOCUMENT("C:\\Projets\\NomDoc";"C:\\Projets\\")Copie d’un fichier dans un dossier spécifique en conservant le même nom et en remplaçant le document existant :
COPIER DOCUMENT("C:\\Projets\\NomDoc";"C:\\Projets\\"; *)Copie d’un dossier dans un autre dossier (les deux dossiers doivent exister sur le disque) :
COPIER DOCUMENT("C:\\Projets\\";"C\\Archives\\2011\\")Les exemples suivants créent différents fichiers et dossiers dans le dossier de la base (exemples Windows). Dans tous le cas, le dossier "dossier2" doit exister :
COPIER DOCUMENT("dossier1\\nom1";"dossier2\\")
//crée le fichier "dossier2/nom1"
COPIER DOCUMENT("dossier1\\nom1";"dossier2\\" ; "nouveauté")
//crée le fichier "dossier2/nouveauté"
COPIER DOCUMENT("dossier1\\nom1";"dossier2\\nom2")
//crée le fichier "dossier2/nom2"
COPIER DOCUMENT("dossier1\\nom1";"dossier2\\nom2";"nouveauté")
//crée le fichier "dossier2/nouveauté" (nom2 est ignoré)
COPIER DOCUMENT("dossier1\\" ; "dossier2\\")
//crée le dossier "dossier2/dossier1/"
COPIER DOCUMENT("dossier1\\" ; "dossier2\\" ; "nouveauté")
//crée le dossier "dossier2/nouveauté/"
Produit : 4D
Thème : Documents système
Numéro :
541
Nom intl. : COPY DOCUMENT
Créé : 4D v6
Modifié : 4D v13
Modifié : 4D v14
4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)
