- 将文件从外部目录拉入到 知行之桥 工作流中。
- 将文件从 知行之桥 工作流导出到外部目录中。
核心功能
- 集成本地和网络文件系统,支持 UNC 路径
- 为受保护的网络位置提供可配置的身份验证(仅限 .NET 版本)
- 支持 Glob 模式匹配的高级过滤功能及递归目录查找
- 支持带暂存和重命名操作的临时文件处理,确保传输的可靠性
- 提供可选的缓存功能,确保仅下载新增或更新的文件
概览
每个 File 端口都需要配置磁盘路径,该路径决定了它将从哪个文件夹读取文件或向哪个文件夹写入文件。可以是本地磁盘路径,也可以是网络上其它文件位置的 UNC 路径。 当 File 端口从配置的路径接收到文件时,它会将接收到的文件传递给 知行之桥 工作流中的下一个端口,不会修改文件。这样,File 端口可用于轮询外部文件夹,以将文件拉入工作流。 当 知行之桥 工作流中的文件被 File 端口处理时,该文件将被写入到配置路径下的文件夹中。通过这种方式,File 端口可用于将已处理的文件放在应用程序外部的位置。 File 端口可以配置用户名/密码凭据,以提供对外部文件路径的访问,否则应用程序将无法访问这些路径。这允许 知行之桥 从受保护的文件夹位置提取文件,而不需要授予整个应用程序对受保护位置的访问权限。 File 端口中配置的路径可以使用宏动态填充。更多信息,请参见宏部分。端口配置
本节包含所有可配置的端口属性。设置
端口设置
与端口核心操作相关的设置。接收
与从外部文件路径提取文件相关的设置。认证
缓存
与缓存及多次下载之间文件比对相关的设置。知行之桥会自动清理资源缓存。此过程在每次接收周期的后台运行,删除远程服务器上已不存在的文件对应的过期缓存条目。这使得缓存大小始终保持在可管理范围内,无需任何手动操作。
默认情况下,文件保留 30 天,但您可以在高级选项卡的其他设置字段中使用 ResourceCacheRetentionDays 设置来调整保留时间以适应您的环境。例如,ResourceCacheRetentionDays=15 表示文件保留 15 天后将被删除。
TEST.TXT 和 test.txt。高级设置
高级设置
未包含在先前类别中的设置。消息
消息设置确定端口如何搜索消息并在处理后管理它们。
| 设置 | 描述 |
|---|---|
| 保存到已发送文件夹 | 选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。 |
| 已发送文件夹方案 | 端口根据选定的时间间隔对 已发送 文件夹中的文件进行分组。例如,Weekly 选项指示端口每周创建一个新的子文件夹,并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在 已发送 文件夹中。对于处理许多事务的端口,使用子文件夹可以帮助保持文件有序并提高性能。 |
日志
用于管理日志创建和存储的设置。
| 设置 | 描述 |
|---|---|
| 日志级别 | 指定要记录在端口日志目录中的信息类型:
|
| 日志文件夹结构 | 指示端口根据选定的时间间隔将日志文件夹中的文件分组。例如,Weekly 选项指示端口每周创建一个新的子文件夹,并将该周的所有日志存储在该文件夹中。空白设置告诉端口将所有日志直接保存在日志文件夹中。对于处理许多事务的端口,使用子文件夹有助于保持日志的有序性并提高性能。 |
| 保留消息副本 | 指示端口在日志目录中保存最新消息副本的切换。请注意,端口每个子文件夹只保留一个消息,并且端口在再次运行时会覆盖以前保存的消息。 |
其他设置
特殊设置适用于特定用例。
| 设置 | 描述 |
|---|---|
| 其他设置 | 允许在以分号分隔的列表中配置隐藏的端口设置,例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用这些设置。 |
自动化
自动化设置
与端口自动处理文件相关的设置。性能
与端口资源分配相关的设置。
| 设置 | 描述 |
|---|---|
| 最大工作线程数 | 此端口上处理文件时从线程池中消耗的最大工作线程数。如果设置,则会覆盖 高级设置 页面的 性能设置 部分的默认设置。 |
| 最大文件数 | 分配给端口的每个线程发送的最大文件数。如果设置,则会覆盖 高级设置 页面的 性能设置 部分的默认设置。 |
告警选项卡
SLA 选项卡
建立连接
File 端口必须具有适当的权限,才能从配置的路径读取/写入。当配置的路径是到网络上另一个服务器的 UNC 路径时,权限问题是主要关注的问题,但是当从本地磁盘上受保护的文件夹推送或提取文件时,也可能出现权限问题。 如果运行 知行之桥 的用户没有访问该路径的权限,请在设置选项卡的认证部分,将用户名、密码和域字段设置为具有相应权限的特定用户。发送/接收文件
发送文件
File 端口将文件从事务选项卡发送到路径中指定的外部文件夹。如果在自动化选项卡中启用了发送功能,文件将自动发送。接收文件
File 端口从路径中指定的外部文件夹接收文件,并将它们放置在端口的事务选项卡中。如果 File 端口连接到工作流中的另一个端口,则文件不会保留在此文件夹中,而是传递到下一个连接的端口。 如果在自动化选项卡中启用了接收功能,端口将自动轮询外部文件夹以接收文件。 端口将只提取与指定文件掩码匹配的文件。如果启用时间戳比对或启用文件大小比对已启用,端口将缓存从远程路径提取的文件名,并且仅接收以前未收到的文件或自上次收到后已修改的文件。子目录消息头
如果递归子目录设置为 True,File 端口从路径接收文件时:- 收到的文件消息将在其元数据中包含子目录消息头。
- 这个消息头包含子目录,其相对于配置的路径。
- 这个子目录消息头可以被其它支持该功能的发送端口所识别和支持。
- 文件将被放置在子目录消息头中指定的子目录(相对于 File 端口的路径设置)中。
- 如果有权限,子目录会被自动创建。