Configurazione del client FTP

I client FTP effettuano connessioni ai server FTP.
Le
Librerie dei template
 contengono uno script di runtime e un widget che consentono di stabilire connessioni ai server FTP.

Pacchetti richiesti

Vedere Aggiungere pacchetti NuGet e installare una versione stabile di questo pacchetto NuGet richiesto: FluentFTP.

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.

Trasferimento periodico del file tramite FTP

Attenersi alla procedura seguente per combinare
FTPClientLogic
 e
PeriodicActionLogix
 per automatizzare il caricamento e il download di file e cartelle in modo periodico e non interattivo. È possibile utilizzare la configurazione di questo server FTP per automatizzare i trasferimenti di file e cartelle tra dispositivi.
  1. Creare la cartella
    C:/FtpServer
     e, all'interno di tale cartella, creare il file
    myDocument.txt
    .
  2. Impostare
    C:/FtpServer
     come cartella di avvio sul server FTP.
  3. Configurare i parametri del server FTP quali indirizzo IP, porta e utenti autorizzati.
  4. Avviare il server FTP.
Per utilizzare il server FTP esistente nelle
Librerie dei template
, vedere Configurazione del Server FTP. Sarà quindi necessario configurare i parametri di connessione al server FTP nello script
FTPClientLogic
.
I file e le cartelle da trasferire sono già configurati attraverso
FileTransferDownload
 e
FileTransferUpload
.
Le pagine nel progetto includono:
  • Configurazione del client FTP
    . Consente di modificare i parametri di configurazione del client FTP. L'interruttore
    OverwriteExistingItems
     definisce se un file esistente deve essere sovrascritto.
  • Trasferimento file
    . Mostra come connettersi e scollegare il client FTP utilizzando i metodi
    ConnectFTPClient
     e
    DisconnectFTPClient
     e come scaricare e caricare utilizzando i metodi
    DownloadItem
     e
    UploadItem
    .
  • Metodo di backup periodico
    . Consente di abilitare il download periodico di un dato file utilizzando lo script
    PeriodicActionLogic
    . Lo script viene configurato con
    Period
     impostato a 30 secondi e
    Action
     impostato su
    DownloadItem
    . Vedere Esempio di download.
Fornire un feedback
Hai domande o feedback su questa documentazione? invia il tuo feedback qui.