Configuración de cliente FTP

Los clientes FTP realizan conexiones con servidores FTP.
Bibliotecas de plantillas
 contiene un script en tiempo de ejecución y un widget que permite establecer conexiones con servidores FTP.

Paquetes requeridos

Consulte Agregar paquetes NuGet e instale una versión estable de este paquete NuGet requerido: FluentFTP.

Script de cliente FTP

FTPClientLogic
 es un script en tiempo de ejecución que expone métodos OPC UA para realizar el listado de archivos y transferir a y desde un servidor FTP.
Los parámetros configurables son:
  • FtpServerIPAddress
    . Dirección IP del servidor FTP.
  • FtpServerPort
    . Puerto del servidor FTP.
  • FtpServerUsername
    . Nombre de usuario utilizado para autenticar al usuario en el servidor FTP.
  • FtpServerUserPassword
    . Contraseña utilizada para autenticar al usuario en el servidor FTP.
  • OverwriteFileIfExists
    . Determina si los archivos existentes deben o no sobrescribirse.
  • ClientCertificateFile
    . Archivo de certificado público del servidor, según el estándar X509v3 y con extensión .der. Se encuentra en la carpeta
    FTOptixApplication/ProjectFiles/PKI/Own/Certs
    . Si se especifica, también se debe especificar la clave privada. Si no se especifica, se genera automáticamente en tiempo de ejecución en la carpeta
    FTOptixApplication/ApplicationFiles/PKI/Own/Certs
    .
  • ClientPrivateKeyFile
    . Archivo de clave privada del servidor, con extensión .pem y codificación ASCII Base64. Se encuentra en la carpeta
    FTOptixApplication/ProjectFiles/PKI/Own/Certs
    . Si se especifica, también se debe especificar el certificado. Si no se especifica, se genera automáticamente en tiempo de ejecución en la carpeta
    FTOptixApplication/ApplicationFiles/PKI/Own/Certs
    .
  • UseFtps
    . Determine el protocolo que se utilizará, FTP o FTPS.
Los siguientes parámetros, que se utilizarán como de solo lectura, exponen el estado interno del cliente:
  • FtpClientIsRunning
    . Indica si el cliente está conectado a un servidor FTP.
  • FtpClientOperationInProgress
    . Indica si el cliente está ejecutando algunas operaciones, como el listado de archivos o la transferencia de archivos.
Entre los métodos expuestos se incluyen:
  • ConnectFtpClient
    . Se conecta al servidor FTP.
  • DisconnectFtpClient
     se desconecta del servidor FTP.
  • DownloadItem
    . Descarga un elemento remoto, como un archivo o carpeta, que está contenido en el parámetro
    remoteItem
     que existe en la carpeta
    LocalFolderPath
    .  A través del parámetro
    overwriteItemIfExists
     se puede determinar si se sobrescribe o no cualquier archivo existente.
  • UploadItem
    . Carga el elemento local, como un archivo o carpeta, que está contenido en el parámetro
    localItemPath
    , a la carpeta
    remoteFolderPath
    . A través del parámetro
    overwriteItemIfExists
     se puede determinar si se sobrescribe o no cualquier archivo existente.

Widget de cliente FTP

FTPClientWidget
 permite hacer un listado y transferir archivos a y desde un servidor FTP a través de una interfaz gráfica.
Los parámetros configurables son:
  • ServerIPAddress
    . Dirección IP del servidor FTP.
  • FtpServerPort
    . Puerto del servidor FTP.
  • Username
    . Nombre de usuario para autenticar en el servidor FTP.
  • Password
    . Contraseña del usuario para autenticar en el servidor FTP.
  • ClientCertificateFile
    . Archivo de certificado público del servidor, según el estándar X509v3 y con extensión
    .der
    . Se encuentra en la carpeta
    FTOptixApplication/ProjectFiles/PKI/Own/Certs
    . Si se especifica, también se debe especificar la clave privada. Si no se especifica, se genera automáticamente en tiempo de ejecución en la carpeta
    FTOptixApplication/ApplicationFiles/PKI/Own/Certs
    .
  • ClientPrivateKeyFile
    . Archivo de clave privada del servidor, con codificación ASCII Base64 y extensión
    .pem
    . Se encuentra en la carpeta
    FTOptixApplication/ProjectFiles/PKI/Own/Certs
    . Si se especifica, también se debe especificar el certificado. Si no se especifica, se genera automáticamente en tiempo de ejecución en la carpeta
    FTOptixApplication/ApplicationFiles/PKI/Own/Certs
    .
  • UseFtps
    . Determine el protocolo que se utilizará, FTP o FTPS.
  • ExtensionFilter
    . Establezca uno o más filtros para ver únicamente los archivos con ciertas extensiones. Para especificar más de una extensión, separe la extensión con
    ;
    . Por ejemplo, utilice
    .txt;.csv
     para mostrar solo archivos con extensiones
    .txt
     y
    .csv
    . Utilice
    .
     para mostrar los archivos que tengan cualquier extensión.
  • ShowHiddenFiles
    . Especifica si se deben mostrar los archivos ocultos. Esta configuración no se aplica a los sistemas de archivos remotos de los servidores FTP de Windows.
  • StartLocalFilesystemPath
    . Especifica la carpeta inicial para examinar el sistema de archivos locales.
  • AccessFullFilesystem
    . Determina si se permite examinar todo el sistema de archivos. Esta opción solo es compatible con sistemas Windows y Ubuntu. Puede navegar desde la raíz de los discos en Windows y desde la carpeta
    /
     (root) en Linux.
  • AccessLocalNetworkDrives
    . Muestra las unidades de red asignadas utilizando este ajuste cuando
    AccessFullFilesystem
     está habilitado en el sistema operativo Windows.

Transferencia periódica de archivos a través de FTP

Siga estos pasos para combinar
FTPClientLogic
 y
PeriodicActionLogix
 para automatizar la carga y la descarga de archivos y carpetas de una manera periódica y no interactiva. Puede utilizar esta configuración del servidor FTP para automatizar las transferencias de archivos y carpetas entre dispositivos.
  1. Cree la carpeta
    C:/FtpServer
     y dentro de esa carpeta cree el archivo
    myDocument.txt
    .
  2. Establezca
    C:/FtpServer
     como carpeta inicial en el servidor FTP.
  3. Configure los parámetros del servidor FTP, como la dirección IP, el puerto y los usuarios autorizados.
  4. Inicie el servidor FTP.
Para usar el servidor FTP que existe en
Bibliotecas de plantillas
, consulte Configuración del servidor FTP. A continuación, deberá configurar los parámetros de conexión con el servidor FTP en el script
FTPClientLogic
.
Los archivos y carpetas que se van a transferir ya están configurados a través de
FileTransferDownload
 y
FileTransferUpload
.
Las páginas del proyecto incluyen:
  • Configuración de cliente FTP
    . Permite cambiar los parámetros de configuración del cliente FTP. El interruptor
    OverwriteExistingItems
     define si debe sobrescribirse un archivo existente.
  • Transferir archivos
    . Muestra cómo conectar y desconectar el cliente FTP mediante los métodos
    ConnectFTPClient
     y
    DisconnectFTPClient
     así como cómo descargar y cargar mediante los métodos
    DownloadItem
     y
    UploadItem
    .
  • Método de copia de seguridad periódica
    . Le permite habilitar la descarga periódica de un archivo determinado mediante el script
    PeriodicActionLogic
    . El script se configura con
    Period
     establecido en 30 segundos y
    Action
     establecido en
    DownloadItem
    . Consulte el ejemplo de descarga.
Entregue su opinión
¿Tiene dudas o comentarios acerca de esta documentación? Por favor deje su opinión aquí.