Configuration du client FTP

Les clients FTP établissent des connexions aux serveurs FTP.
Les
Bibliothèques de modèles
 contiennent un script d'exécution et un widget qui vous permettent d'établir des connexions aux serveurs FTP.

Packages requis

Consultez la rubrique Ajouter des packages NuGet et installez une version stable de ce package NuGet requis : FluentFTP.

Script client FTP

FTPClientLogic
 est un script d’exécution qui expose les méthodes OPC UA permettant de répertorier/transférer des fichiers de et vers un serveur FTP.
Les paramètres configurables sont les suivants :
  • FtpServerIPAddress
    . Adresse IP du serveur FTP.
  • FtpServerPort
    . Port du serveur FTP.
  • FtpServerUsername
    . Nom d'utilisateur employé pour authentifier l'utilisateur sur le serveur FTP.
  • FtpServerUserPassword
    . Mot de passe employé pour authentifier l'utilisateur sur le serveur FTP.
  • OverwriteFileIfExists
    . Détermine si des fichiers existants doivent être écrasés ou non.
  • ClientCertificateFile
    . Fichier de certificat public serveur, selon la norme X509v3 et avec l’extension .der. Il doit se trouver dans le dossier
    FTOptixApplication/ProjectFiles/PKI/Own/Certs
    . S'il est spécifié, la clé privée doit également être spécifiée. S’il n’est pas spécifié, il est automatiquement généré lors de l’exécution dans le dossier
    FTOptixApplication/ApplicationFiles/PKI/Own/Certs
    .
  • ClientPrivateKeyFile
    . Fichier de clé privée du serveur, avec codage ASCII Base64 et extension .pem. Il doit se trouver dans le dossier
    FTOptixApplication/ProjectFiles/PKI/Own/Certs
    . S’il est spécifié, le certificat doit également être spécifié. S’il n’est pas spécifié, il est automatiquement généré lors de l’exécution dans le dossier
    FTOptixApplication/ApplicationFiles/PKI/Own/Certs
    .
  • UseFtps
    . Détermine le protocole à utiliser, FTP ou FTPS.
Les paramètres suivants, à utiliser en lecture seule, exposent l'état interne du client :
  • FtpClientIsRunning
    . Indique si le client est connecté à un serveur FTP.
  • FtpClientOperationInProgress
    . Indique si le client exécute certaines opérations, telles que répertorier les fichiers ou les transférer.
Les méthodes exposées sont les suivantes :
  • ConnectFtpClient
    . Se connecte au serveur FTP.
  • DisconnectFtpClient
     Se déconnecte du serveur FTP.
  • DownloadItem
    . Télécharge un élément distant, tel qu'un fichier ou un dossier contenu dans le paramètre
    remoteItem
     qui existe dans le dossier
    LocalFolderPath
    .  Grâce au paramètre
    overwriteItemIfExists
    , il est possible de déterminer si des fichiers existants doivent être écrasés ou non.
  • UploadItem
    . Envoie l’élément local, tel qu’un fichier ou un dossier, contenu dans le paramètre
    localItemPath
     du dossier
    remoteFolderPath
    . Grâce au paramètre
    overwriteItemIfExists
    , il est possible de déterminer si des fichiers existants doivent être écrasés ou non.

Widget du client FTP

FTPClientWidget
 vous permet de répertorier et de transférer des fichiers vers et depuis un serveur FTP via une interface graphique.
Les paramètres configurables sont les suivants :
  • ServerIPAddress
    . Adresse IP du serveur FTP.
  • FtpServerPort
    . Port du serveur FTP.
  • Username
    . Nom d'utilisateur permettant de s'authentifier sur le serveur FTP.
  • Password
    . Mot de passe de l'utilisateur permettant de s'authentifier sur le serveur FTP.
  • ClientCertificateFile
    . Fichier de certificat public serveur, selon la norme X509v3 et avec l’extension
    .der
    . Il doit se trouver dans le dossier
    FTOptixApplication/ProjectFiles/PKI/Own/Certs
    . S'il est spécifié, la clé privée doit également être spécifiée. S’il n’est pas spécifié, il est automatiquement généré lors de l’exécution dans le dossier
    FTOptixApplication/ApplicationFiles/PKI/Own/Certs
    .
  • ClientPrivateKeyFile
    . Fichier de clé privée du serveur, avec codage ASCII Base64 et extension
    .pem
    . Il doit se trouver dans le dossier
    FTOptixApplication/ProjectFiles/PKI/Own/Certs
    . S’il est spécifié, le certificat doit également être spécifié. S’il n’est pas spécifié, il est automatiquement généré lors de l’exécution dans le dossier
    FTOptixApplication/ApplicationFiles/PKI/Own/Certs
    .
  • UseFtps
    . Détermine le protocole à utiliser, FTP ou FTPS.
  • ExtensionFilter
    . Définissez un ou plusieurs filtres pour afficher uniquement les fichiers portant certaines extensions. Pour spécifier plusieurs extensions, séparez-les par
    ;
    . Par exemple, utilisez
    .txt;.csv
     pour afficher uniquement les fichiers portant les extensions
    .txt
     et
    .csv
    . Utilisez
    .
     pour afficher les fichiers de toutes les extensions.
  • ShowHiddenFiles
    . Spécifie si les fichiers masqués doivent être affichés. Ce paramètre ne s'applique pas sur les systèmes de fichiers distants des serveurs FTP Windows.
  • StartLocalFilesystemPath
    . Spécifie le dossier de démarrage dans lequel parcourir le système de fichiers local.
  • AccessFullFilesystem
    . Détermine l'autorisation de parcourir un système de fichiers complet. Cette option n’est prise en charge que pour les systèmes Windows et Ubuntu. Vous pouvez naviguer à partir de la racine des lecteurs sous Windows et à partir du dossier
    /
     (racine) sous Linux.
  • AccessLocalNetworkDrives
    . Affiche les lecteurs réseau mappés à l’aide de ce paramètre lorsque
    AccessFullFilesystem
     est activé dans le système d’exploitation Windows.

Transfert périodique de fichiers via FTP

Procédez comme suit pour combiner
FTPClientLogic
 et
PeriodicActionLogix
 afin d’automatiser le chargement et le téléchargement de fichiers et de dossiers de manière périodique et non interactive. Vous pouvez utiliser cette configuration de serveur FTP pour automatiser les transferts de fichiers et de dossiers entre les dispositifs.
  1. Créez le dossier
    C:/FtpServer
     et, à l’intérieur de ce dossier, créez le fichier
    myDocument.txt
    .
  2. Définissez
    C:/FtpServer
     comme dossier de démarrage sur le serveur FTP.
  3. Configurez les paramètres du serveur FTP tels que l'adresse IP, le port et les utilisateurs autorisés.
  4. Démarrez le serveur FTP.
Pour utiliser le serveur FTP qui existe dans
Bibliothèques de modèles
, consultez la rubrique Configuration du serveur FTP. Ensuite, vous devez configurer les paramètres de connexion sur le serveur FTP dans le script
FTPClientLogic
.
Les fichiers et dossiers à transférer sont déjà configurés via
FileTransferDownload
 et
FileTransferUpload
.
Les pages du projet comprennent :
  • Configuration du client FTP
    . Permet de modifier les paramètres de configuration du client FTP. Le commutateur
    OverwriteExistingItems
     définit si un fichier existant doit être écrasé.
  • Transfert de fichiers
    . Indique comment connecter et déconnecter le client FTP à l’aide des méthodes
    ConnectFTPClient
     et
    DisconnectFTPClient
     et comment télécharger et envoyer à l’aide des méthodes
    DownloadItem
     et
    UploadItem
    .
  • Méthode de sauvegarde périodique
    . Vous permet d’activer le téléchargement périodique d’un fichier donné à l’aide du script
    PeriodicActionLogic
    . Le script est configuré avec la valeur
    Period
     définie sur 30 secondes et
    Action
     définie sur
    DownloadItem
    . Consultez la rubrique Exemple de téléchargement.
Fournir une réponse
Vous avez des questions ou des commentaires sur cette documentation ? Veuillez envoyer vos commentaires ici.