4D Internet Commands v16

FTP_Send

Accueil

 
4D Internet Commands v16
FTP_Send

FTP_Send 


 

FTP_Send ( ftp_ID ; cheminLocal ; cheminServeur ; progression ) -> Résultat 
Paramètre Type   Description
ftp_ID  Entier long in Référence d'une connexion FTP
cheminLocal  Texte in Chemin d'accès local du document à envoyer
cheminServeur  Texte in Chemin d'accès du document sur le serveur FTP
progression  Entier in 1 = Montrer progression, 0 = Masquer progression
Résultat  Entier in Code d'erreur

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.

 $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.

 $erreur:=FTP_Send(vFTP_ID;"";"";1)



Voir aussi  

FTP_Progress
FTP_Receive

 
PROPRIÉTÉS 

Produit : 4D Internet Commands
Thème : IC File Transfer
Numéro : 88937
Nom intl. : FTP_Send

 
HISTORIQUE 

Créé : 4D Internet Commands 6.5

 
UTILISATION DE L'ARTICLE

4D Internet Commands ( 4D Internet Commands v16)