|
|
|
|
|
|
|
|
|
|
version 6.5
FTP_Send (ftp_ID; cheminLocal; cheminServeur; progression) 
Entier
| Paramètre | Type | Description | |
| ftp_ID | Entier long | | Référence d'une connexion FTP |
| cheminLocal | Texte | | Chemin d'accès local du document à envoyer |
| cheminServeur | Texte | | Chemin d'accès du document sur le serveur FTP |
| progression | Entier | | 1 = Montrer progression, 0 = Masquer progression |
| Résultat | Entier |  | Code d'erreur |
Description
La commande FTP_Send envoie le document désigné par cheminLocal à l'emplacement désigné par cheminServeur. Si une erreur de statut de fichier FTP se produit, FTP_Send la retourne immédiatement.
ftp_ID est l'identifiant de la session FTP établie avec FTP_Login.
cheminLocal désigne le chemin d'accès local du document à envoyer. Si vous passez une chaîne vide, la boîte de dialogue standard d'ouverture de fichiers apparaît. Si vous passez un nom de fichier simple (sans chemin d'accès), la commande recherche ce fichier dans le dossier contenant le fichier de structure de la base de données (avec 4D monoposte) ou dans le dossier de 4D Client (avec 4D Server). Comme pour tous les chemins d'accès à des documents locaux, les noms des répertoires doivent être séparés par le délimiteur correspondant à la plate-forme. Pour plus d'informations sur ce point, reportez-vous à la section Glossaire et terminologie.
cheminServeur désigne le chemin d'accès complet au format Unix du document à créer, nom du fichier compris. Le cheminServeur indique le nouveau nom du fichier une fois reçu par le serveur FTP. Si cheminLocal est une chaîne vide permettant à l'utilisateur de sélectionner un fichier sur disque, cheminServeur peut alors aussi être une chaîne vide, auquel cas le nom du fichier sélectionné sera utilisé.
Vous pouvez passer dans cheminServeur un chemin d'accès Unix complet ou simplement un nom de fichier :
• Si vous passez un chemin d'accès complet, le fichier sera placé dans le répertoire défini, qui deviendra alors le répertoire de travail courant (CWD).
• Si vous passez uniquement un nom de fichier, ou si des chaînes vides sont passées dans les paramètres cheminLocal et cheminServeur, le fichier sera alors envoyé dans le répertoire de travail courant (CWD).
Si le paramètre cheminServeur ne peut pas être correctement interprété, ou si l'utilisateur n'a pas les droits d'accès requis pour envoyer un fichier dans le répertoire distant, la commande retourne une erreur. Comme pour tous les chemins d'accès des documents Unix, le chemin doit être défini à l'aide de barres obliques ("/"). Pour plus d'informations sur ce point, reportez-vous à la section Glossaire et terminologie.
Le paramètre progression vous permet de spécifier si le thermomètre de progression doit ou non être affiché. Passez 1 pour l'afficher et 0 (zéro) pour le masquer.
Exemples
• Exemple 1
$OK:=Faux
Au cas ou
: (FTP_Login ("ftp.4d.com";"anonymous";"dbody@aol.com";vFTP_ID;vTxt_Accueil)#0)
: (FTP_Progress (-1;-1;"Fenêtre de progression";"Réception du fichier demandé…";"Annuler")#0)
: (FTP_Send (vFTP_ID;"Mon disque dur:Documents:Rapport des ventes de juillet";"/pub/rapports/";1)#0)
: (FTP_Logout (vFTP_ID)#0)
Sinon
$OK:=Vrai `Toutes les commandes ont été exécutées sans erreur
Fin de cas
Note : Pour plus d'informations sur cet emploi particulier de la structure Au cas ou, reportez-vous à l'Annexe A, Conseils de programmation.
• Exemple 2
$erreur:=FTP_Send (vFTP_ID;"";"";1)
Référence
|
|
|
|
|
|
|
|
|
|