Configuration du client FTP

Un client FTP (File Transfer Protocol) configuré est requis pour établir 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

Vous devez installer une version stable du package NuGet requis : FluentFTP. Consultez la rubrique Packages NuGet.

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 du 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.
Fournir une réponse
Vous avez des questions ou des commentaires sur cette documentation ? Veuillez envoyer vos commentaires ici.