SFTP端口将文件传输到远程SFTP服务器或从远程服务器传输文件。
概览
每个SFTP端口将上传文件到指定文件夹,并从远程SFTP服务器上的一组文件夹中下载文件。
在知行EDI系统工作流中,到达SFTP端口的文件被上传到上传目标文件夹,并且将下载目标文件夹中的文件下载并输入到工作流中。 端口支持上传和下载过滤器,仅发送和接收指定的文件名和/或文件扩展名。
端口配置
本文包含所有可配置的端口属性。
主机配置
建立与远程SFTP主机的连接相关的设置。
主机 | SFTP服务器的主机名称或IP地址。 |
主机端口 | 连接到SFTP服务器的端口。 |
客户端认证
与认证SFTP服务器相关的设置。
身份验证模式 | SFTP服务器使用的身份验证类型。 |
用户名 | 登录SFTP服务器的用户名。 |
密码 | 登录SFTP服务器的密码。 |
客户端证书 | 公钥身份验证期间使用的带有私钥的证书。 |
证书密码 | 访问客户端证书所需的密码。 |
服务器认证
与验证SFTP服务器的身份有关的设置。
服务器指纹 | 标识SFTP服务器的证书指纹。这也可以设置为包含服务器公钥的证书文件。当测试连接时,端口将提示接受/信任服务器提供的指纹。 |
上传
与将文件上传到SFTP服务器相关的设置。
远程路径 | 端口已处理的文件将被上传到该指定的远程文件夹。 |
下载
与从SFTP服务器下载相关的设置。
远程路径 | 下载文件的远程文件夹。 可以在逗号分隔的列表中指定多个路径。 |
文件掩码 | 全局模式,该模式确定应下载远程路径中的哪些文件(例如* .txt)。 |
覆盖本地文件 | 应该下载(覆盖)还是跳过本地文件系统上已经存在的文件。 |
删除文件(下载后) | 之后是否应该从SFTP服务器删除成功下载的文件。 |
自动化
自动化配置
与端口自动处理文件有关的设置。
上传 | 到达端口的文件是否将自动上传。 |
重试间隔 | 重试上传失败交易的时间间隔。 |
最大重试次数 | 上传失败的最大次数。 |
下载 | 端口是否应自动轮询远程下载路径以下载文件。 |
下载间隔 | 尝试自动下载的时间间隔。 |
分 | 下载之前要等待的分钟数。 仅在“Receive Interval”设置为“Minute”时适用。 |
第几分钟/小时 | 分钟数按小时排定。 仅在“Receive Interval”设置为“Hourly”时适用。 例如,如果将此值设置为5,则自动化服务将以1:05、2:05、3:05等下载。 |
时间 | 在指定日期之内应该进行下载的时间。 仅在“Receive Interval”设置为“Daily”,“Weekly”或“Monthly”时适用。 |
天 | 下载应进行的日期。 仅在“Receive Interval”设置为“Weekly”或“Monthly”时适用。 |
时间表达式 | 时间表达式的任意字符串,用于确定何时应进行下载。 仅在“Receive Interval”设置为“Advanced”时适用。 |
高级配置
本地文件夹
决定端口下载后将在文件写入何处的配置。
输入文件夹(Send) | 端口上传的文件将放在此处。 如果使用了自动发送,端口将自动轮询此位置以供文件处理。 |
输出文件夹(Receive) | 端口下载的文件将放在此处。 如果该端口已连接到流程中的另一个端口,则文件将不会保留在此处,而是会发送到所连接端口的“输入(Send)”文件夹中。 |
已处理文件夹(Sent) | 处理文件后,如果使用了“保存到已发送文件夹”,端口将在此文件夹中放置已发送/已上传文件的副本。 |
服务器命令
一组任意的SFTP命令,可在端口执行期间的不同时间在远程服务器上执行:如在连接后,下载后,上传后,下载前以及上传前。
性能
与向端口分配资源有关的配置。
最大线程数 | 从工作池分配的最大线程数以便处理此端口上的文件。 如果配置了,则覆盖“个人配置->高级配置->性能”选项卡中的默认配置。 |
最大文件数 | 此端口分配的线程每次能处理的最大文件数。如果配置了,则覆盖“个人配置->高级配置->性能”选项卡中的默认配置。 |
代理配置
一组设置,用于标识和验证SFTP连接应通过的代理。
其他配置
先前类别中未包含的设置。
下载排除扩展名 | 端口将不会下载的文件扩展名的逗号分隔列表。 |
下载排除前缀 | 前缀的逗号分隔列表,指示端口不要下载以指定前缀开头的文件。 |
文件大小比较 | 是否缓存已下载文件的名称和大小; 如果为True,则仅在之前未下载文件或更改大小后才下载文件。 |
时间戳比较 | 是否缓存已下载的文件名和上次修改的时间戳; 如果为True,则仅在文件之前未下载或自下载以来已被修改的文件才下载。 |
下载过滤器 | 全局模式过滤器,用于确定应从远程存储区下载哪些文件(例如* .txt)。 负数模式可用于指示不应下载的文件(例如-*。tmp)。 当需要多个文件掩码模式时,应使用此设置。 多个模式可以用逗号分隔,后面的过滤器优先,除非找到完全匹配的内容。 |
上传过滤器 | 全局模式过滤器,以确定端口将上传Send文件夹中的哪些文件(例如* .txt)。 负模式可用于指示不应上传的文件(例如-*。tmp)。 多个模式可以用逗号分隔,后面的过滤器优先,除非找到完全匹配的内容。 |
本地文件方案 | 一种文件掩码,用于确定端口下载的本地文件名。以下宏可用于引用上下文信息: %ConnectorId%, %Filename%, %FilenameNoExt%, %Ext%, %ShortDate%, %LongDate%, %RegexFilename:%, %DateFormat:%, %ControlNumber%, %TransactionControlNumber%, %TransactionCode%, %StandardVersion%. 例如: %FilenameNoExt%_%ControlNumber%%Ext% |
记录调试信息 | 是否为端口启用增强日志记录。 请求支持时,建议生成调试日志并将其与支持请求一起提供。 |
最大文件下载数 | 一个轮询间隔内将从SFTP服务器下载的最大文件数。 如果设置为-1,则不应用限制。 |
监控文件增长 | 如果使用,端口将在轮询间隔之间存储远程文件的文件大小,并且只下载大小不变的文件。这可防止端口下载仍在服务器上写入的文件。 |
父端口 | 除非应在现有端口配置中明确覆盖设置,否则应从中继承设置的端口。 必须将其设置为与当前端口相同类型的端口。 |
递归子目录 | 是否下载目标远程路径的子文件夹中的文件。 |
恢复下载 | 如果为True,则在文件下载期间发生错误时,端口将存储文件的已下载部分,并在下次尝试下载时尝试下载文件的其余部分。 |
恢复上传 | 如果为True,则在文件上传期间发生错误时,连接器将记录已传输的字节数,并在下次尝试上传时尝试上传文件的其余部分。 |
SSH加密算法 | SSH加密期间要使用的逗号分隔的算法列表。默认情况下,所有算法都已启用。支持以下算法: aes256-ctr, aes256-cbc, aes192-ctr, aes192-cbc, aes128-ctr, aes128-cbc, 3des-ctr, 3des-cbc, cast128-cbc, blowfish-cbc, arcfour, arcfour128, arcfour256, aes128-gcm@openssh.com, aes256-gcm@openssh.com, chacha20-poly1305@openssh.com |
临时下载扩展名 | 传输过程中,临时文件扩展名将附加到在下载文件名中。 |
临时上传扩展名 | 传输过程中,临时文件扩展名将追加到在上传的文件名中。 |
临时上传路径 | 远程SFTP服务器上将文件上传到的临时路径。 传输完成后,文件将被移到指定远程路径中。 |
临时上传前缀 | 传输过程中,临时文件前缀将添加到文件上传之前。 |
超时 | 端口将在引发超时错误之前等待连接响应的持续时间。 |
保留消息副本 | 已处理文件的日志是否将包括文件本身的副本。 |
保存至Sent文件夹 | 端口已处理的文件是否应复制到端口的“Sent”文件夹。 |
建立连接
连接到远程SFTP服务器需要以下设置:
- 远程主机
- 远程端口
- 认证模式
- 用户名
- 密码或客户端证书/证书密码
- 服务器指纹
测试与服务器的连接时,端口将提示接受/信任服务器公钥的指纹。
上传文件
SFTP端口从“输入/Send”文件夹上传与“高级配置”选项卡中设置的“发送过滤器”匹配的文件。 如果在端口中启用了自动上传,则文件会自动上传到SFTP服务器。
远程路径应设置为远程SFTP服务器上应上传文件的文件夹。 登录服务器后,应用程序将目录更改为指定的文件夹。
如果无法上传任何文件,则端口将在“重试间隔”分钟过去之后尝试发送这些文件。 此过程将继续进行,直到达到“重试最大尝试次数”设置为止,此后端口将引发错误,并且文件将不再自动上传。
下载文件
下载的文件显示在端口的“输出/Receive”文件夹中,或发送到流程中的下一个端口。如果在端口中启用了“自动下载”,则会从SFTP服务器自动下载文件,并且可以通过单击“输出”选项卡中的“接收”按钮来手动下载文件。
远程路径应设置为远程SFTP服务器上的文件夹,应从该文件夹下载文件。登录服务器后,应用程序将目录更改为指定的文件夹。 “文件掩码”属性过滤器,以便仅从服务器下载与全局模式匹配的文件名。
“覆盖本地文件”设置控制是否应覆盖“输出/Receive”中已经存在的文件。成功下载文件后,“删除文件(下载后)”设置可用于删除远程服务器上的文件。在“输出”选项卡中,单击“接收”以测试这些设置并从服务器检索匹配的文件。
注:文案部分图片及内容来源于网络,版权归原创作者所有,如有侵犯到您的权益,请您联系我们进行删除,给您带来困扰,我们深感抱歉。