Configurazione del client FTP

Configurazione del client FTP

Per effettuare connessioni ai server FTP è necessario un client File Transfer Protocol (FTP) configurato.
Le
Librerie
contengono uno script di runtime e un widget che consentono di stabilire connessioni ai server FTP.

Pacchetti richiesti

È necessario installare una versione stabile del pacchetto NuGet richiesto: FluentFTP. Vedere Pacchetti NuGet.

Script client FTP

FTPClientLogic
è uno script di runtime che espone dei metodi OPC UA per ottenere l'elenco di file ed effettuare il trasferimento dei file da/a un server FTP.
I parametri configurabili includono:
  • FtpServerIPAddress
    . Indirizzo IP del server FTP.
  • FtpServerPort
    . Porta del server FTP.
  • FtpServerUsername
    . Nome utente utilizzato per autenticare l'utente sul server FTP.
  • FtpServerUserPassword
    . Password utilizzata per autenticare l'utente sul server FTP.
  • OverwriteFileIfExists
    . Determina se un file esistente deve essere sovrascritto o meno.
  • ClientCertificateFile
    . File di certificato pubblico del server, secondo standard X509v3 e con estensione .der. Deve essere presente nella cartella
    FTOptixApplication/ProjectFiles/PKI/Own/Certs
    . Se specificato, deve essere specificata anche la chiave privata. Se non specificato, viene generato automaticamente a runtime nella cartella
    FTOptixApplication/ApplicationFiles/PKI/Own/Certs
    .
  • ClientPrivateKeyFile
    . File di chiave privata del server, con codifica ASCII Base64 ed estensione .pem. Deve essere presente nella cartella
    FTOptixApplication/ProjectFiles/PKI/Own/Certs
    . Se specificato, deve essere specificato anche il certificato. Se non specificato, viene generato automaticamente a runtime nella cartella
    FTOptixApplication/ApplicationFiles/PKI/Own/Certs
    .
  • UseFtps
    . Determinare il protocollo da utilizzare, FTP o FTPS.
I seguenti parametri, da utilizzare come sola lettura, espongono lo stato interno del client:
  • FtpClientIsRunning
    . Indica se il client è attualmente connesso a un server FTP.
  • FtpClientOperationInProgress
    . Indica se il client sta eseguendo alcune operazioni, ad esempio l'elenco di file o il trasferimento di file.
I metodi esposti includono:
  • ConnectFtpClient
    . Si connette al server FTP.
  • DisconnectFtpClient
    Si disconnette dal server FTP.
  • DownloadItem
    . Scarica un elemento remoto, ad esempio un file o una cartella, contenuto nel parametro
    remoteItem
    esistente nella cartella
    LocalFolderPath
    .  Tramite il parametro
    overwriteItemIfExists
    è possibile determinare se eventuali file esistenti devono essere sovrascritti o meno.
  • UploadItem
    . Carica l'elemento locale, come un file o una cartella, contenuto nel parametro
    localItemPath
    nella cartella
    remoteFolderPath
    . Tramite il parametro
    overwriteItemIfExists
    è possibile determinare se eventuali file esistenti devono essere sovrascritti o meno.

Widget client FTP

FTPClientWidget
consente di elencare e trasferire file da e verso un server FTP mediante un'interfaccia grafica.
I parametri configurabili includono:
  • ServerIPAddress
    . Indirizzo IP del server FTP.
  • FtpServerPort
    . Porta del server FTP.
  • Username
    . Nome utente per l'autenticazione sul server FTP.
  • Password
    . Password dell'utente per l'autenticazione sul server FTP.
  • ClientCertificateFile
    . File di certificato pubblico del server, secondo standard X509v3 e con estensione
    .der
    . Deve essere presente nella cartella
    FTOptixApplication/ProjectFiles/PKI/Own/Certs
    . Se specificato, deve essere specificata anche la chiave privata. Se non specificato, viene generato automaticamente a runtime nella cartella
    FTOptixApplication/ApplicationFiles/PKI/Own/Certs
    .
  • ClientPrivateKeyFile
    . File di chiave privata del server, con codifica ASCII Base64 ed estensione
    .pem
    . Deve essere presente nella cartella
    FTOptixApplication/ProjectFiles/PKI/Own/Certs
    . Se specificato, deve essere specificato anche il certificato. Se non specificato, viene generato automaticamente a runtime nella cartella
    FTOptixApplication/ApplicationFiles/PKI/Own/Certs
    .
  • UseFtps
    . Determinare il protocollo da utilizzare, FTP o FTPS.
  • ExtensionFilter
    . Imposta uno o più filtri per visualizzare solo i file con determinate estensioni. Per specificare più di un'estensione, separare le estensioni con
    ;
    . Ad esempio, utilizzare
    .txt;.csv
    per visualizzare solo i file con estensioni
    .txt
    e
    .csv
    . Utilizzare
    .
    per visualizzare i file di tutte le estensioni.
  • ShowHiddenFiles
    . Consente di specificare se mostrare o meno i file nascosti. Questa impostazione non si applica sui file system remoti dei server FTP Windows.
  • StartLocalFilesystemPath
    . Specifica la cartella iniziale per navigazione nel file system locale.
  • AccessFullFilesystem
    . Determina se consentire di navigare in tutto il file system. Questa opzione è supportata solo per sistemi Windows e Ubuntu. In questi casi è possibile sfogliare a partire dalla cartella root dei dischi su Windows e dalla cartella
    /
    (root) su Linux.
  • AccessLocalNetworkDrives
    . Visualizza le unità di rete mappate utilizzando questa impostazione quando
    AccessFullFilesystem
    è abilitato nel sistema operativo Windows.
Fornire un feedback
Hai domande o feedback su questa documentazione? invia il tuo feedback qui.
Normal