跳转到主要内容
File 端口能够:
  • 将文件从外部目录拉入到 知行之桥 工作流中。
  • 将文件从 知行之桥 工作流导出到外部目录中。

核心功能

  • 集成本地和网络文件系统,支持 UNC 路径
  • 为受保护的网络位置提供可配置的身份验证(仅限 .NET 版本)
  • 支持 Glob 模式匹配的高级过滤功能及递归目录查找
  • 支持带暂存和重命名操作的临时文件处理,确保传输的可靠性
  • 提供可选的缓存功能,确保仅下载新增或更新的文件

概览

每个 File 端口都需要配置磁盘路径,该路径决定了它将从哪个文件夹读取文件或向哪个文件夹写入文件。可以是本地磁盘路径,也可以是网络上其它文件位置的 UNC 路径。 当 File 端口从配置的路径接收到文件时,它会将接收到的文件传递给 知行之桥 工作流中的下一个端口,不会修改文件。这样,File 端口可用于轮询外部文件夹,以将文件拉入工作流。 当 知行之桥 工作流中的文件被 File 端口处理时,该文件将被写入到配置路径下的文件夹中。通过这种方式,File 端口可用于将已处理的文件放在应用程序外部的位置。 File 端口可以配置用户名/密码凭据,以提供对外部文件路径的访问,否则应用程序将无法访问这些路径。这允许 知行之桥 从受保护的文件夹位置提取文件,而不需要授予整个应用程序对受保护位置的访问权限。 File 端口中配置的路径可以使用宏动态填充。更多信息,请参见宏部分。

端口配置

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

设置

端口设置

与端口核心操作相关的设置。

接收

与从外部文件路径提取文件相关的设置。

认证

缓存

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

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

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

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

高级设置

高级设置

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

消息

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

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

日志

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

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

其他设置

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

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

自动化

自动化设置

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

性能

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

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

告警选项卡

SLA 选项卡

建立连接

File 端口必须具有适当的权限,才能从配置的路径读取/写入。当配置的路径是到网络上另一个服务器的 UNC 路径时,权限问题是主要关注的问题,但是当从本地磁盘上受保护的文件夹推送或提取文件时,也可能出现权限问题。 如果运行 知行之桥 的用户没有访问该路径的权限,请在设置选项卡的认证部分,将用户名、密码和域字段设置为具有相应权限的特定用户。

发送/接收文件

发送文件

File 端口将文件从事务选项卡发送到路径中指定的外部文件夹。如果在自动化选项卡中启用了发送功能,文件将自动发送。

接收文件

File 端口从路径中指定的外部文件夹接收文件,并将它们放置在端口的事务选项卡中。如果 File 端口连接到工作流中的另一个端口,则文件不会保留在此文件夹中,而是传递到下一个连接的端口。 如果在自动化选项卡中启用了接收功能,端口将自动轮询外部文件夹以接收文件。 端口将只提取与指定文件掩码匹配的文件。如果启用时间戳比对或启用文件大小比对已启用,端口将缓存从远程路径提取的文件名,并且仅接收以前未收到的文件或自上次收到后已修改的文件。

子目录消息头

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

宏

示例