• Nouveauté SaaS
  La fonction FTPParamètre permet de modifier le comportement des fonctions FTP. Lors de l'utilisation d'une variable de type ftpConnexion :

  • Le mode de fonctionnement du FTP (constante ftpParamètreMode) est forcé à 1 : les fonctions de gestion du FTP utilisent une implémentation native du FTP et indépendante de Windows, avec le support d'UTF8.
  • Le mode de chiffrement (constante ftpesParamètreModeSécurisé) est déterminé par la propriété ModeFTPES de la variable de type ftpConnexion.
  • La constante ftpParamètreRéutiliseConnexion permettra de forcer ou non la réutilisation de la connexion vers un serveur FTP entre deux requêtes (par défaut, la connexion est réutilisée).
• Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable.

Propriétés spécifiques à la description des variables de type ftpConnexion

Nom de la propriété	Type manipulé	Effet
CléPrivée	Chaîne de caractères	Nom et chemin du fichier correspondant à la clé privée utilisée lors d'une connexion en mode SFTP. Ce fichier doit avoir été généré au format OpenSSH. Par défaut, la connexion sécurisée utilise une authentification par <Utilisateur> / <MotDePasse>.
DuréeNonRéponse	Entier	Nombre de secondes au bout desquelles la requête de connexion au serveur FTP est abandonnée (par défaut 20). Ce délai s'applique à toutes les opérations FTP réalisées sur cette connexion. Si aucune réponse du serveur n'est obtenue dans la durée spécifié, la connexion échoue. Cette propriété peut correspondre à : un entier correspondant au nombre de secondes, une variable de type Durée, l'indication directe de la durée (par exemple '1s').
Nouveauté SaaS IgnoreErreur	Constante de type Entier	Lors d'une connexion sécurisée, certaines erreurs de sécurité peuvent faire échouer la fonction. Il est possible de se connecter en ignorant ces erreurs grâce aux constantes suivantes : ftpIgnoreCertificatInvalide : Le certificat est ignoré. ftpIgnoreCertificatExpiré : La date du certificat est ignorée. ftpIgnoreNomCertificatInvalide : Le nom du site figurant dans le certificat est ignoré. ftpIgnoreDéprécié : Ignore les erreurs en lien avec l'utilisation d'algorithmes dépréciés (exemple : signature de certificat en SHA-1). ftpIgnoreRenégociationNonSecurisée : Ignore l'erreur stipulant que le serveur ne supporte pas la renégociation sécurisée (RFC 5746). ftpIgnoreRévocation : La révocation du certificat est ignorée. Ces erreurs sont ignorées uniquement pour l'instance de la connexion en cours. Attention : Cette propriété est disponible uniquement à partir de WINDEV Suite SaaS 2025 Update 2. Pour plus de détails, consultez Utiliser les nouveautés de WINDEV Suite SaaS 2025.
Nouveauté SaaS ModeFTPES	Constante de type Entier	Permet de modifier le chiffrement en FTPES. ftpSSLExigéSurToutes : le chiffrement s'applique aux données et aux commandes FTP. Ce mode correspond au mode de fonctionnement par défaut des fonctions en FTPES. ftpSSLExigéPourCommandes : le chiffrement SSL s'applique uniquement aux commandes FTP. Ce mode peut être requis pour certains serveurs FTPES. Attention : Cette propriété est disponible uniquement à partir de WINDEV Suite SaaS 2025 Update 2. Pour plus de détails, consultez Utiliser les nouveautés de WINDEV Suite SaaS 2025.
MotDePasse	Chaîne de caractères ou chaîne de caractères secrète	Mot de passe de l'utilisateur, permettant d'identifier l'utilisateur sur le serveur FTP. Ce mot de passe correspond : au <Mot de passe> spécifié si ce paramètre est différent d'une chaîne vide (""), à l'adresse email de l'utilisateur si le paramètre <Nom de l'utilisateur> n'est pas spécifié ou est égal à une chaîne vide (""), à une chaîne vide ("") si ce paramètre n'est pas spécifié et si le paramètre <Nom de l'utilisateur> est différent d'une chaîne vide (""). Remarque : Si le mot de passe contient des caractères spéciaux, il peut être nécessaire de le convertir en UTF8 en utilisant la fonction ChaîneVersUTF8. Nouveauté 2025 Utilisation de chaînes secrètes : Si vous utilisez le coffre-fort de chaînes secrètes, le type de la chaîne secrète utilisable pour ce paramètre doit être "Chaîne Ansi ou Unicode". Pour plus de détails sur les chaînes secrètes et l'utilisation du coffre-fort, consultez Coffre-fort de chaînes secrètes. Cette propriété est disponible en écriture uniquement.
MotDePasseCléPrivée	Chaîne de caractères ou chaîne de caractères secrète	Mot de passe du fichier contenant la clé privé utilisée lors d'une connexion en mode SFTP. Si l'utilisation des chaînes en exécution est en Unicode (onglet "Unicode" de la configuration courante), le mot de passe ne doit pas être donné entre guillemets. Il doit être contenu dans une variable de type chaîne déclarée en ANSI. Si ce paramètre n'est pas spécifié, la connexion sécurisée utilise une authentification par <Utilisateur> / <MotDePasse>. Nouveauté 2025 Utilisation de chaînes secrètes : Si vous utilisez le coffre-fort de chaînes secrètes, le type de la chaîne secrète utilisable pour ce paramètre doit être "Chaîne Ansi ou Unicode". Pour plus de détails sur les chaînes secrètes et l'utilisation du coffre-fort, consultez Coffre-fort de chaînes secrètes. Cette propriété est disponible en écriture uniquement.
NuméroPort	Entier	Numéro de port sur lequel le serveur doit être lancé. Ce paramètre est donné par le responsable du site FTP. Par défaut : pour une connexion non sécurisée, ce port est le port 21. pour une connexion sécurisée en mode FTPS, ce port est le port 990. pour une connexion sécurisée en mode FTPES, ce port est le port 21. pour une connexion sécurisée en mode SFTP, ce port est le port 22.
Nouveauté SaaS ProcédureTrace	Procédure	Nom de la procédure WLangage permettant de connaître les entêtes et les données envoyées et reçues. Cette procédure est de la forme : PROCÉDURE <Nom procédure>(<TypeInfo> est entier, <Data> est un Buffer) où : <TypeInfo> est une constante de type Entier correspondant au type de données tracées : httpTraceDonnéeEnvoyée : Données envoyées. httpTraceDonnéeRecue : Données reçues. httpTraceEntêteEnvoyé : Entête envoyé. httpTraceEntêteRecu : Entête reçu. httpTraceInfo : Informations détaillées sur l’exécution de la requête (erreur bas niveau de cURL/OpenSSL, étape en cours, avertissements, etc.). <Data> est un buffer contenant les informations. Exemple de procédure : PROCÉDURE ProcTrace(nTypeInfo est entier, ... bufByData est un Buffer) SELON nTypeInfo CAS httpTraceEntêteEnvoyé: Trace("Entête : ", ... UTF8VersChaîne(bufByData)) CAS httpTraceDonnéeEnvoyée: Trace("Données : ", ... bufByData) CAS httpTraceEntêteRecu: Trace("Entête reçu : ", ... UTF8VersChaîne(bufByData)) CAS httpTraceDonnéeRecue: Trace("Données reçues : ", ... bufByData) FIN Attention : Cette fonctionnalité est disponible uniquement à partir de WINDEV Suite SaaS 2025 Update 2. Pour plus de détails, consultez Utiliser les nouveautés de WINDEV Suite SaaS 2025.
Serveur	Chaîne de caractères	Nom du serveur FTP (par exemple "ftp.cdrom.com") ou adresse IP du serveur FTP (par exemple "192.54.12.8"). Cette propriété permet de définir le protocole utilisé : si le nom du serveur commence par "ftp://", la connexion est en mode non sécurisé. si le nom du serveur commence par "ftps://", la connexion est en mode sécurisé selon le protocole FTPS (FTP sécurisé par SSL avec chiffrement implicite). si le nom du serveur commence par "ftpes://", la connexion est en mode sécurisé selon le protocole FTPES (FTP sécurisé par SSL avec chiffrement explicite). si le nom du serveur commence par "sftp://", la connexion est en mode sécurisé par un tunnel SSH selon le protocole SFTP.
TypeConnexion	Entier	Type de connexion à effectuer : ftpModeActif : Connexion active au serveur FTP. Lors d'un transfert de fichiers, c'est le client qui prend l'initiative du transfert. Ce type de connexion peut être refusé par certains serveurs FTP protégés. Non disponible. ftpModePassif (Valeur par défaut) : Connexion passive au serveur FTP (mode PASV). Lors d'un transfert de fichiers, c'est le serveur qui prend l'initiative du transfert. Ce type de connexion permet de franchir certains "firewalls". Remarque : Si la connexion au serveur est en IPV6, alors la connexion se fera en mode passif étendu (car le mode passif ne supporte pas IPV6). ftpModePassifEtendu : Connexion passive étendue au serveur FTP (mode EPSV). Lors d'un transfert de fichiers, c'est le serveur qui prend l'initiative du transfert. Ce type de connexion permet de franchir certains "firewalls". Si le serveur ne supporte pas le mode passif étendu (la commande FEAT est envoyée au serveur pour connaître la capacité), la connexion est dégradée en mode passif simple. Limitation : Ce mode n'est pas supporté lors de l'utilisation du module "wininet" de Windows (voir fonction FTPParamètre) : la connexion est réalisée en mode ftpModePassif. ftpModePassifIgnoreIP : Connexion passive au serveur FTP (mode PASV). Lors d'un transfert de fichiers en mode passif le serveur donne le port et l'adresse IP pour le transfert des données. Avec ce paramètre, seul le port est pris en compte, l'adresse IP est ignorée. Ce type de connexion permet d'utiliser des serveurs FTP qui retournent des adresses IP non routables mais qui sont joignables par l'adresse IP de connexion. Limitation : Ce mode n'est pas supporté lors de l'utilisation du module "wininet" de Windows (voir fonction FTPParamètre) : la connexion est réalisée en mode ftpModePassif.
Utilisateur	Chaîne de caractères	Nom de l'utilisateur qui tente d'effectuer une connexion nominative (identification de l'utilisateur sur le serveur FTP). Si cette propriété correspond à une chaîne vide (""), la connexion sera anonyme.

• hDescriptionSauvegarde (Type de variable)
• Fonctions FTP Standard