4D Doc Center : FTP

4D Internet Commands v14

FTP_Send


FTP_Send ( ftp_ID ; cheminLocal ; cheminServeur ; progression ) -> Résultat

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.

Note : La longueur des noms des documents manipulés par les commandes FTP est limitée. Pour plus d'informations, reportez-vous à la section Transfert de fichiers, Présentation.

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.

Note : Des limitations spécifiques relatives à la longueur ou aux caractères utilisables dans les noms de fichiers peuvent être imposées par le serveur FTP.

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.

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/ventes_juillet";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)