跳转到主要内容
FTP 端口可与远程 FTP 服务器传输文件。

核心功能

  • 支持 FTPS (FTP over TLS/SSL) 和传统 FTP 文件传输协议
  • 支持主动和被动模式,具备完善的防火墙兼容性
  • 支持断点续传功能,适用于中断的上传和下载任务
  • 提供高级身份验证,包括基于证书的客户端身份验证
  • 支持连接池和临时文件处理,确保传输的可靠性
  • 提供可选的缓存功能,确保仅下载新增或更新的文件

概述

每个 FTP 端口连接上传文件到指定的文件夹,并从远程 FTP 服务器上的一组文件夹下载。 在 知行之桥 工作流中到达 FTP 端口的文件被上传到上传目标文件夹,在下载目标文件夹中找到的文件被下载并输入到 知行之桥 工作流中。端口支持上传和下载过滤规则,仅发送和接收指定的文件名和/或文件扩展名。

端口配置

本节包含所有可配置的端口属性。

设置

主机配置

与建立到远程 FTP 主机的连接相关的设置。

客户端验证

与向 FTP 服务器进行身份验证相关的设置。

服务器验证

与验证 FTP 服务器身份相关的设置。

上传

与文件上传到 FTP 服务器相关的设置。

下载

与从 FTP 服务器下载相关的设置。

缓存

与缓存及多次下载之间文件比对相关的设置。

知行之桥会自动清理资源缓存。此过程在每次接收周期的后台运行,删除远程服务器上已不存在的文件对应的过期缓存条目。这使得缓存大小始终保持在可管理范围内,无需任何手动操作。

默认情况下,文件保留 30 天,但您可以在高级选项卡的其他设置字段中使用 ResourceCacheRetentionDays 设置来调整保留时间以适应您的环境。例如,ResourceCacheRetentionDays=15 表示文件保留 15 天后将被删除。

启用缓存后,文件名不区分大小写。例如,端口无法区分 TEST.TXT 和 test.txt。

高级设置

TLS 客户端认证

需要双向 TLS 身份验证时与客户端身份验证相关的设置。

服务器命令

高级设置

先前类别中未包含的设置。

代理设置

这是一组用于识别连接所经代理并对其进行身份验证的设置。默认情况下,本节使用 安全设置 页面的 代理设置 部分中的全局设置。清除此复选框可为您的端口提供特定的设置。

设置描述
代理类型基于代理的防火墙使用的协议。
代理主机基于代理的防火墙的名称或 IP 地址。
代理端口基于代理的防火墙的 TCP 端口。
代理用户用于通过基于代理的防火墙进行身份验证的用户名。
代理密码用于对基于代理的防火墙进行身份验证的密码。
身份验证方案保留默认值 None 或选择以下身份验证方案之一:Basic、Digest、Proprietary 或 NTLM。

消息

消息设置确定端口如何搜索消息并在处理后管理它们。

设置描述
保存到已发送文件夹选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。
已发送文件夹方案端口根据选定的时间间隔对 已发送 文件夹中的文件进行分组。例如,Weekly 选项指示端口每周创建一个新的子文件夹,并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在 已发送 文件夹中。对于处理许多事务的端口,使用子文件夹可以帮助保持文件有序并提高性能。

日志

用于管理日志创建和存储的设置。

设置描述
日志级别指定要记录在端口日志目录中的信息类型:
  • None - 不创建任何日志。
  • Error - 仅当端口遇到错误时才创建日志。
  • Warning - 仅当端口发出警告时才创建日志。
  • Info - 记录工作流的一般信息,包括任何错误和警告(如果适用)。
  • Debug - 记录成功和失败工作流的详细调试信息。
  • Trace - 记录成功和失败工作流的详细跟踪信息。
请注意:Debug 和 Trace 级别的日志可能会记录敏感信息,包括消息内容和 SSL 证书。尽管连接属性(例如密码)被屏蔽了,但在与您的组织外部共享它们之前,请查看此级别的日志以避免泄漏敏感信息。
日志文件夹结构指示端口根据选定的时间间隔将日志文件夹中的文件分组。例如,Weekly 选项指示端口每周创建一个新的子文件夹,并将该周的所有日志存储在该文件夹中。空白设置告诉端口将所有日志直接保存在日志文件夹中。对于处理许多事务的端口,使用子文件夹有助于保持日志的有序性并提高性能。
保留消息副本指示端口在日志目录中保存最新消息副本的切换。请注意,端口每个子文件夹只保留一个消息,并且端口在再次运行时会覆盖以前保存的消息。

其他设置

特殊设置适用于特定用例。

设置描述
其他设置允许在以分号分隔的列表中配置隐藏的端口设置,例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用这些设置。

自动化

自动化设置

与端口自动处理文件相关的设置。

性能

与端口资源分配相关的设置。

设置描述
最大工作线程数此端口上处理文件时从线程池中消耗的最大工作线程数。如果设置,则会覆盖 高级设置 页面的 性能设置 部分的默认设置。
最大文件数分配给端口的每个线程发送的最大文件数。如果设置,则会覆盖 高级设置 页面的 性能设置 部分的默认设置。

告警选项卡

SLA 选项卡

建立一个连接

连接到远程 FTP 服务器需要以下设置:
  • 远程主机
  • TLS 类型
  • 远程主机端口
  • 用户名
  • 密码
在高级选项卡下,FTP 服务器可能还需要服务器公钥证书和 TLS 客户端认证。

上传文件

FTP 端口从事务选项卡上传文件。如果端口中启用了上传自动化功能,文件将自动上传到 FTP 服务器。 远程目录应设置为远程 FTP 服务器上应上传文件的文件夹。登录到服务器后,应用程序会将目录更改到指定的文件夹。可以在高级选项卡中设置临时上传扩展名、前缀或路径,以确保文件在远程目录文件夹中结束之前已被完全传输。 如果有任何文件无法上传,端口会在重试间隔分钟后尝试发送它们。此过程一直持续,直到达到最大重试次数设置,之后端口将引发错误,文件将不再自动发送。

下载文件

下载的文件显示在端口的事务选项卡中,或者传递给工作流中的下一个端口。如果端口中启用了下载自动化功能,文件将自动从 FTP 服务器上下载,并且可以通过单击事务选项卡中的接收文件按钮手动下载。 远程目录应设置为远程 FTP 服务器上的文件夹,文件应从该文件夹下载。登录到服务器后,应用程序将目录更改到指定的文件夹。文件掩码属性过滤文件,以便只从服务器下载与全局模式匹配的文件名。可以在高级选项卡中设置临时下载扩展名或前缀,以确保文件在事务选项卡中结束之前已被完全传输。 **删除文件(下载后)**设置可用于在成功下载文件后删除远程服务器上的文件。 完成配置后,文件将会根据自动下载的配置下载,或者在事务选项卡上手动点击接收文件按钮。

子目录消息头

如果递归被选择,FTP 端口从远程目录接收文件时:
  • 收到的文件消息将在其元数据中包含子目录消息头。
  • 这个消息头包含子目录,其相对于配置的远程目录。
  • 这个子目录消息头可以被其它支持该功能的发送端口所识别和支持。
当发送文件时,如果发送到 FTP 端口远程目录的消息中存在子目录消息头:
  • 文件将被放置在子目录(相对于 FTP 端口远程目录设置)中,该子目录在子目录消息头中指定。
  • 如果有权限,子目录会被自动创建。

宏

示例