Note : en cas de transfert multi-plates-formes, il est préférable de zipper ou stuffiter vos fichiers.

Transcription

1 Téléchargement FTP avec 4D Par Steve HUSSEY, PDG Alto Stratus LLC Note technique 4D FR Version 1 Date 1 Février 2001 Résumé Cette note technique initie aux joies du téléchargement sur les sites FTP. Vous pourez, avec ce code simple envoyer et recevoir tout type de fichiers. Note : en cas de transfert multi-plates-formes, il est préférable de zipper ou stuffiter vos fichiers. 4D Notes techniques Copyright D SA - Tous droits réservés Tous les efforts ont été faits pour que le contenu de cette note technique présente le maximum de fiabilité possible. Néanmoins, les différents éléments composant cette note technique, et le cas échéant, le code, sont fournis sans garantie d'aucune sorte. L'auteur et 4D S.A. déclinent donc toute responsabilité quant à l'utilisation qui pourrait être faite de ces éléments, tant à l'égard de leurs utilisateurs que des tiers. Les informations contenues dans ce document peuvent faire l'objet de modifications sans préavis et ne sauraient en aucune manière engager 4D SA. La fourniture du logiciel décrit dans ce document est régie par un octroi de licence dont les termes sont précisés par ailleurs dans la licence électronique figurant sur le support dulogiciel et de la Documentation afférente. Le logiciel et sa documentation ne peuvent être utilisés, copiés oureproduits sur quelque support que ce soit et de quelque manière que ce soit, que conformément aux termes de cette licence. Aucune partie de ce document ne peut être reproduite ourecopiée de quelque manière que ce soit, électronique ou mécanique, y compris par photocopie, enregistrement, archivage ou tout autre procédé de stockage, de traitement et de récupération d'informations, pour d'autres buts que l'usage personnel de l'acheteur, et ce exclusivement aux conditions contractuelles, sans la permission explicite de 4D SA. 4D, 4D Calc, 4D Draw, 4D Write, 4D Insider, 4ème Dimension, 4D Server, 4D Compiler ainsi que les logos 4e Dimension, sont des marques enregistrées de 4D SA. Windows,Windows NT,Win 32s et Microsoft sont des marques enregistrées de Microsoft Corporation. Apple, Macintosh, Power Macintosh, LaserWriter, ImageWriter, QuickTime sont des marques enregistrées ou des noms commerciaux de Apple Computer,Inc. Mac2Win Software Copyright est un produit de Altura Software,Inc. 4D Write contient des éléments de "MacLink Plus file translation", un produit de DataViz, Inc,55 Corporate drive,trumbull,ct,usa. XTND Copyright D SA. Tous droits réservés. XTND Technology Copyright Claris Corporation.. Tous droits réservés ACROBAT Copyright , Secret Commercial Adobe Systems Inc.Tous droits réservés. ACROBAT est une marque enregistrée d'adobe Systems Inc. Tous les autres noms de produits ou appellations sont des marques déposées ou des noms commerciaux appartenant à leurs propriétaires respectifs. 1 / 12

2 Introduction Cette note technique expose la façon d utiliser les commandes FTP afin de créer un client et de lui permettre de se connecter à un site FTP ainsi que d'envoyer et de recevoir des fichiers avec une application 4D. Note : pour faire fonctionner la base de démonstration, vous devrez vous connecter à un site FTP avec des accès et des privilèges vous permettant de créer des répertoires et des fichiers pour les envois de fichier). Qu est ce que le FTP? Le Protocole FTP (File Transfert Protocol) permet de transférer des documents d'un ordinateur à un autre via Internet. Le contenu d'un site FTP peut être abordé par tous les systèmes d'exploitation (Unix, MacOS, Linux ou Windows). Les fichiers transférés seront compatibles avec ces plates-formes selon le format stocké sur le site FTP. Système requis - 4D v6.0.x avec le plug-in "4D Internet Toolkit" Chemin d accès Quand vous spécifiezle nom d accès dans une commande devant traiter un site FTP, vous devez considérer ce chemin d'accès comme un chemin d'accès Unix. Ceci étant valable quel que soit le système d'exploitation sous lequel le site FTP est publié. Note : Les chemins d'accès des fichiers et des répertoires sur le serveur FTP doivent suivre les conventions de la plate-forme sur lequel celui-ci est installé. Pourquoi Utilisez 4D pour des fichiers FTP? Avantages 4D -Stocker les noms et les chemins des documents ou des dossiers que vous pourriez ultérieurement vouloir télécharger. En utilisant 4D, il est possible de lancer un process automatisé qui vous connecte suivant vos besoins (par exemple, lancer un téléchargement à heure programmée sur des sites multiples). -Télécharger des fichiers d'un site FTP et les stocker dynamiquement dans une base de données. -Gérer les sites FTP : vous pouvez analyser le contenu d'un site et générer un catalogue de la hiérarchie des fichiers à télécharger. A la connexion suivante, il vous sera possible, de ce fait, d'exécuter une synchronisation des répertoires ou des fichiers devant être téléchargés ou mis à jour. 2 / 12

3 -Publipostages : la synchronisationde dossiers ou fichiers doit être effectuée vers différents sites FTP. Ceci, en pouvant gérer le moment de cette action. -Créer un client FTP avec une interface personnalisée. -Gestion de la sécurité : contrôler les accès de transfert à l'aide des mots de passe que vous pouvez maîtriser. -Réitération des procédures lorsque le réseau est saturé, sans l'intervention de l'utilisateur. Utilisation de la base Par défaut, à la création d'un nouveau data, un enregistrement sur la table préférence est créé avec les valeurs par défaut : - Nom d'utilisateur : anonymous - Mot de passe : mon_ @ma_societe.fr Réception de documents Après avoir sélectionné l'item test réception dans le menu Réception, vous obtenez la liste des sites FTP saisis, ou une fenêtre de création d'enregistrement (dans le cas d'un nouveau data). 1 - Création (ou ajout) d'un site. Vous entrez le nom du site FTP que vous voulez ajouter dans la première zone de saisie. Le nom d utilisateur et le mot de passe prennent les valeurs par défaut du dossier préférence. 3 / 12

4 Note : pour régler le mot de passe et le nom d'utilisateur par défaut, sélectionnez l'item préférence du menu Fichier afin de définir ces chaînes par défaut. 4 / 12

5 2 -Connexion à un site Que vous soyez dans le formulaire de création de site ou que vous ayez double-cliqué sur un site existant, en déclenchant la méthode du bouton Connexion, vous obtenez le formulaire suivant : Synoptique : - Le nom de la fenêtre est le nom du site FTP. - Le nom du répertoire et la liste des répertoires, pour le site. - La taille de chaque fichier - Le type de chaque objet de la liste autre qu un dossier ou un répertoire. - La date de la dernière modification pour chaque rubrique listée. Le bouton "Quitter" coupe la connexion au site et ferme le dialogue. - Le bouton "OK" a deux actions : - Si un dossier est sélectionné quand vous cliquerez sur "OK", il sera téléchargé sur votre ordinateur. 5 / 12

6 - Si un répertoire est sélectionné quand vous cliquerez sur "OK", vous déploierez le contenu de ce répertoire. - La liste déroulante de l'historique tient à jour le cheminement des répertoires explorés. Vous pouvez grâce à lui remonter dans l'historique de votre navigation. 3- Transmission L'envoi de fichiers s'exécute de cette façon : -Vérification des fichiers à transmettre. -Connexion au site. -Initialisation de la connexion METHODE FTP_Init -Ouverture connexion MÉTHODE FTP_CONNECT - Analyse du répertoire -Création de dossier (si nécessaire) -Envoi des fichiers -Déconnexion Note : sous MacOS, nous avons l'obligation d'initialiser les couches TCP, sous Windows, l'utilisateur doit s'assurer lui-même qu'une connexion TCP est activée (sous ce système, un dialogue de confirmation sera affiché). Explication de la base exemple Lorsque vous cliquez sur l'item Test transmission du menu transmission : -Si vous n'avez aucun fichier dans le dossier A envoyer, le message d'alerte suivant sera affiché : 6 / 12

7 7 / 12

8 -Si vous avez un ou plusieurs fichiers dans le dossier A envoyer : - vous devvez saisir le site FTP sur lequel vous voulez vous connecter (ftp.aci.fr par défaut) - vous devez saisir votre nom d'utilisateur (anonyme par défaut) - vous devez saisir votre mot de passe qui est votre adresse v(l'adresse d'anonyme par défaut) Ensuite, vous pourrez voir la progression du transfert de vos fichiers affichée par le plug-in 4DIC. 8 / 12

9 Méthodes Méthode FTP_Init $0:=0 PROPRIETES PLATE FORME($Platform) Au cas ou : ($Platform<=2) ` Mac OS $0:=IT_MacTCPInit : ($Platform>2) ` une connexion TCP a besoin d'être ouverte sous Windows text_alert_msg:="assurez vous d'avoir une connexion TCP/PPP ouverte Avant de continuer le test." WND_Cntr (240;160;5;"Alert";"WND_Cls") DIALOGUE([Application_Preference];"Alert_dlg") FERMER FENETRE Si (ok=1) $0:=0 Sinon $0:=1 Fin de cas Méthode FTP_Connect C_TEXTE($WelcomeText;$1;$2;$3;$FTP_Site;$FTP_Name;$FTP_Password) $FTP_Site:=$1 $FTP_Name:=$2 $FTP_Password:=$3 `connexion au site $0:=FTP_Login ($FTP_Site;$FTP_Name;$FTP_Passeword;FTP_ID;$WelcomeText) `FTP_ID reçoit le numéro de référence de la cession FTP `Tous les messages d'accueil sont retournés dans la variable $WelcomeText Méthode TRAN_Upload C_TEXTE($FTP_Site;$FTP_Name;$FTP_Password) TABLEAU TEXTE(names;0) TABLEAU ENTIER LONG(sizes;0) TABLEAU ENTIER(kinds;0) TABLEAU DATE(modDates;0) TABLEAU BOOLEEN(FTP_OK;0) 9 / 12

10 $FTP_Site:=Demander("Site FTP (ex. ftp.aci.fr)?") `entrer le nom d'accès du site ftp et du sous-dossier Si (ok=1) $FTP_Name:=Demander("Nom d'utilisateur (ou anonyme )?";"anonymous") Si (ok=1) $FTP_Password:=Demander("Mot de passe (ou adresse d'anonyme)") Si (ok=1) PROPRIETES PLATE FORME($Platform) ` Mac OS ou Windows? Au cas ou : ($Platform<=2) ` Mac OS $Delimiter:=":" : ($Platform>2) ` Windows $Delimiter:="/" Fin de cas $Struct:=Fichier structure $Path:=HFS_Extract_File_Name ($Struct;"path") $FullPath:=$Path+"A envoyer" $Err:=FTP_Init ` Charge les drivers TCP Mac Si ($Err=0) ` continuer s'il n'y a aucune erreur $Err:=FTP_Connect ($FTP_Site;$FTP_Name;$FTP_Password) Si ($Err=0) $TargetPath:="//Test_Upload/" $Err:=FTP_MakeDir (FTP_ID;$TargetPath) LISTE DES DOCUMENTS($FullPath;arytext_Documents) Boucle ($File;1;Taille tableau(arytext_documents)) $DocPath:=$Path+"Uploads"+$Delimiter+arytext_Documents{$File} $DestPath:=$TargetPath+"/"+arytext_Documents{$File} `délimiteur au format Unix! $Err:=FTP_Send (FTP_ID;$DocPath;$DestPath;1) ` Affiche le dialogue Si ($err=0) `déplacement des fichiers envoyéss vers le dossier Eléments Envoyés $MovePath:=$Path+"Eléments envoyés"+$delimiter DEPLACER DOCUMENT($DocPath;$MovePath) Fin de boucle $Err:=FTP_Logout (ftp_id) Sinon ALERTE("Erreur de connexion au site FTP.") Sinon ALERTE("Erreur d'initialisation des driverstcp/ppp.") 10 / 12

11 11 / 12

12 Méthode FTP_Get `$1 = "File" or "Dir" `$2 = Path C_TEXTE($Path) $Type:=$1 $Path:=$2 Au cas ou : ($Type="File") ` Fichier $Err:=FTP_Prgrs (arytextnames{arytextnames}) ` Installer le thermomètre $Err:=FTP_Receive (FTP_ID;$Path;$Path;1) ` Reception du fichier sélectionné Si ($Err=-48) ALERTE("Le fichier existe déjà (celui-ci a déjà été téléchargé)!") : ($Type="Dir") ` Répertoire $Err:=FTP_Dir_Get (FTP_ID;$Path) Fin de cas Note : le caractère délimiteur est défini suivant la plate-forme (MacOS, Windows) afin de définir le chemin d'accès des documents à transférer. Tout document transféré sera déplacé dans le dossier Eléments envoyés. 12 / 12