FTP 客户端配置

需要配置文件传输协议 (File Transfer Protocol, FTP) 客户端才能连接到 FTP 服务器。
模板库
包含一个运行时脚本和一个允许连接到 FTP 服务器的小组件。

所需软件包

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

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
    。
提供反馈
对本文档有问题或反馈吗？ 请在这里提交您的反馈 。