Le module livré avec le RunTime Harmony YFTP.DHOP permet d’effectuer des transferts FTP. Ce module est arrivé avec Harmony 2018 et a été amélioré avec Harmony 2022.
Depuis la version X.7 de l’ERP, le module A5PMFTP.DHOP appelle des routines de YFtp en permettant en plus de l’encapsulation en utilisant un code FTP lié à la table WMTPARAMFTP, qui se chargera de transmettre les informations de connexion au serveur FTP, et les chemins locaux et distants.
Voici les méthodes du module YFTP :
 |  |  |
Voici les méthodes présentes dans A5PMFTP :
YTFP, et donc par extension A5PMFTP permettent entre autres
l'upload et download d’un fichier
un test de connexion
du download multiple (GET * .XML par exemle), avec un retour pour chaque fichier téléchargé
du upload multiple (PUT * .XML par exemple), avec un retour pour chaque fichier envoyé
la sélection d’un pattern, comme *.xml.
*.* prendra tous les fichiers avec extension
* prendra tous les fichiers y compris ceux sans extension. Attention, il tentera également de copier les dossiers qui seraient présents sur le FTP mais va échouer. Si vous avez la problématique de GET e fichiers sans extension, alors atention à ne pas avoir de dossier dans le chemin de travail distantde choisir d’effectuer une copie avec une extension intermédiaire (Fichier.xml (distant) ->fichier.xml.tmp (local) → fichier.xml (local)) ou l’inverse (Fichier.xml (local) ->fichier.xml.tmp (distant) → fichier.xml (distant))
Ceci permet de s’assurer la copie intégrale du fichier sur le serveur (local ou distant) avant qu’il soit traitable de part son extension par un scrutateur
L’extension utilisée par défaut est .tmp, mais elle est consultable et modifiable avec les méthodes FTP_Set_IntermediateExtension et FTP_Get_IntermediateExtension
L’argument IntermediateExtension est paramétrable sur la table WMPARAMFTP.
Contenu du recordDiva yftp.FtpResult
Champ | ||
|---|---|---|
Status | Contient soit le retour de FtpRequestGetError 0 pas d’erreur 1 ticket invalide Ou un retour de A5PMFTP : 4 Erreur sur le chemin local 5 Impossible de renommer localement le fichier 6 Erreur sur le fichier local 7 Erreur sur le fichier distant 8 FtpCod transmis incorrect 9 Serveur non renseigné | |
Retour | Message d'erreur produit par Harmony OU A5PMFTP | |
Desc | Texte de l'exception produit par la couche .Net. |
Outre le retour de la fonction appelée, vous pouvez obtenir plus de précisions en récupérant le dernier résultat par la méthode YFTP.FTP_get_lastFtpResult, renvoyant un recordDiva de type Yftp.FtpResult.
Cas des fonctions de copies multiples
Attention, en cas de de PUT/GET multiple, FTP_get_lastFtpResult ne donne le retour que du dernier fichier traité. Ceci ne traduit pas le retour pour chaque fichier traité.
Lors de l’appel aux méthodes suivantes,
YFTP.FtpDownloadMultipleFile
YFTP.FtpUploadMultipleFile
A5pmftp.A5_FtpDownloadMultipleFile_ParamFTP
A5pmftp.A5_FtpUploadMultipleFile_ParamFTP
Il convient pour chaque fichier de récupérer la liste des fichiers concernés et le retour par les méthodes FTP_get_ListDownloadedFile ou FTP_get_ListUploadedFile.
Cette méthode renvoie la liste des fichiers traités et le compte rendu du dernier appel à une des 4 méthodes *MultipleFile*.
Cette liste contient des éléments du recordDiva de type YFtp.FtpFileResult (FileName+ contenu d’un FtpResult vu plus haut).