FTP 客户端配置

FTP 客户端与 FTP 服务器建立连接。
模板库
包含一个运行时脚本和一个允许连接到 FTP 服务器的小组件。

所需软件包

请参见添加 NuGet 软件包并安装下列必需 NuGet 软件包的稳定版本：FluentFTP。

FTP 客户端脚本

FTPClientLogic
 是一个用于公开 OPC UA 方法的运行时脚本，通过这些方法可执行文件列举并将文件传入 FTP 服务器或从 FTP 服务器传出文件。
可配置的参数包括：
  • FtpServerIPAddress
    。FTP 服务器的 IP 地址。
  • FtpServerPort
    。FTP 服务器端口。
  • FtpServerUsername
    。用于在 FTP 服务器上对用户进行身份验证的用户名。
  • FtpServerUserPassword
    。用于在 FTP 服务器上对用户进行身份验证的密码。
  • OverwriteFileIfExists
    。确定是否必须覆盖任何现有文件。
  • ClientCertificateFile
    。服务器公共证书文件，符合标准 X509v3，扩展名为 .der。它必须位于
    FTOptixApplication/ProjectFiles/PKI/Own/Certs
     文件夹中。如果指定该文件，还必须指定私钥。如果未指定该文件，在运行时，它将在
    FTOptixApplication/ApplicationFiles/PKI/Own/Certs
     文件夹中自动生成。
  • ClientPrivateKeyFile
    。服务器私钥文件，采用 ASCII Base64 编码，扩展名为 .pem。它必须位于
    FTOptixApplication/ProjectFiles/PKI/Own/Certs
     文件夹中。如果指定该文件，还必须指定证书。如果未指定该文件，在运行时，它将在
    FTOptixApplication/ApplicationFiles/PKI/Own/Certs
     文件夹中自动生成。
  • UseFtps
    。确定要使用的协议：FTP 或 FTPS。
以下参数将以只读形式使用，可公开客户端的内部状态：
  • FtpClientIsRunning
    。指示客户端是否与 FTP 服务器相连。
  • FtpClientOperationInProgress
    。指示客户端是否正在运行一些操作，例如文件列出或文件传输。
公开的方法包括：
  • ConnectFtpClient
    。连接到 FTP 服务器。
  • DisconnectFtpClient
     与 FTP 服务器断开连接。
  • DownloadItem
    。下载远程项，例如
    remoteItem
     参数中包含的文件或文件夹，该参数存在于
    LocalFolderPath
     文件夹中。  
    overwriteItemIfExists
     参数可用于确定是否应覆盖任何现有文件。
  • UploadItem
    。将
    localItemPath
     参数中包含的本地项（如文件或文件夹）上载到
    remoteFolderPath
     文件夹。
    overwriteItemIfExists
     参数可用于确定是否应覆盖任何现有文件。

FTP 客户端小组件

使用
FTPClientWidget
，可通过图形界面列出文件并将文件传入 FTP 服务器或从 FTP 服务器传出文件。
可配置的参数包括：
  • ServerIPAddress
    。FTP 服务器的 IP 地址。
  • FtpServerPort
    。FTP 服务器端口。
  • Username
    。要在 FTP 服务器上用于进行身份验证的用户名。
  • Password
    。要在 FTP 服务器上用于进行身份验证的用户的密码。
  • ClientCertificateFile
    。服务器公共证书文件，符合标准 X509v3，扩展名为
    .der
    。它必须位于
    FTOptixApplication/ProjectFiles/PKI/Own/Certs
     文件夹中。如果指定该文件，还必须指定私钥。如果未指定该文件，在运行时，它将在
    FTOptixApplication/ApplicationFiles/PKI/Own/Certs
     文件夹中自动生成。
  • ClientPrivateKeyFile
    。服务器私钥文件，采用 ASCII Base64 编码，扩展名为
    .pem
    。它必须位于
    FTOptixApplication/ProjectFiles/PKI/Own/Certs
     文件夹中。如果指定该文件，还必须指定证书。如果未指定该文件，在运行时，它将在
    FTOptixApplication/ApplicationFiles/PKI/Own/Certs
     文件夹中自动生成。
  • UseFtps
    。确定要使用的协议：FTP 或 FTPS。
  • ExtensionFilter
    。设置一个或多个筛选器，以便仅查看具有特定扩展名的文件。要指定多个扩展名，请用
    ;
     分隔不同的扩展名。例如，使用
    .txt;.csv
     将仅显示具有
    .txt
     和
    .csv
     扩展名的文件。使用
    .
     将显示具有所有扩展名的文件。
  • ShowHiddenFiles
    。指定是否显示处于隐藏状态的文件。此设置不适用于 Windows FTP 服务器的远程文件系统。
  • StartLocalFilesystemPath
    。指定用于浏览本地文件系统的起始文件夹。
  • AccessFullFilesystem
    。确定是否允许浏览完整的文件系统。仅 Windows 和 Ubuntu 系统支持此选项。您可以从 Windows 上的磁盘根目录和 Linux 上的
    /
     (root) 文件夹浏览。
  • AccessLocalNetworkDrives
    。显示借助于此设置映射的网络驱动器，但前提是在 Windows 操作系统中启用了
    AccessFullFilesystem
    。

通过 FTP 定期进行文件传输

通过以下步骤，结合使用
FTPClientLogic
 和
PeriodicActionLogix
，自动按定期和非交互方式上载和下载文件和文件夹。可以使用此 FTP 服务器配置来自动在设备之间传输文件和文件夹。
  1. 创建
    C:/FtpServer
     文件夹，然后在该文件夹内创建
    myDocument.txt
     文件。
  2. 在 FTP 服务器上将
    C:/FtpServer
     设置为起始文件夹。
  3. 配置 FTP 服务器参数，如 IP 地址、端口和授权用户。
  4. 启动 FTP 服务器。
要使用位于
模板库
中的 FTP 服务器，请参见FTP 服务器配置。然后，必须在
FTPClientLogic
 脚本中配置 FTP 服务器的连接参数。
要传输的文件和文件夹已通过
FileTransferDownload
 和
FileTransferUpload
 进行配置。
项目中的页面包括：
  • FTP 客户端配置
    。可用于更改 FTP 客户端的配置参数。
    OverwriteExistingItems
     开关定义是否必须覆盖现有文件。
  • 传输文件
    。显示如何使用
    ConnectFTPClient
     和
    DisconnectFTPClient
     方法连接和断开 FTP 客户端，以及如何使用
    DownloadItem
     和
    UploadItem
     方法进行下载和上载。
  • 定期备份方法
    。用于通过
    PeriodicActionLogic
     脚本定期下载给定文件。此脚本中配置的
    Period
     设置为 30 秒，
    Action
     设置为
    DownloadItem
    。请参见下载示例。
提供反馈
对本文档有问题或反馈吗？ 请在这里提交您的反馈 。