跳至主要内容
Administrator Guide
上次更新时间 :2023-06-23
参考信息:SFTP-Out 传输属性

参考信息:SFTP-Out 传输属性

“Common”选项卡

属性A
XML 属性名称
描述
编号
id
程序集中的
sftp-out
组件的唯一编号。
将回复发送至
routes-response-to
sftp-out
传输的响应消息的目标。
执行时间
execute-when
指定一个条件,以确定是否执行传输。
端点
endpoint
指定要将文件写入到的主机(还可以选择指定端口)和 FTP 目录。
遵循格式
sftp://SFTP-directory
,其中
SFTP-directory
是目标地点。
示例:
sftp://sftpserver.example.org/outputDir
指定的目录位置在服务器上必须已存在。
双重身份验证
dual-authentication
指定是否强制使用用户名/密码组合和私钥进行双重身份验证。默认值为
false
,这意味着用户可以使用私钥或用户名/密码组合进行身份验证,但不能同时使用两者。
如果该属性设置为
false
并且用户输入私钥(通过配置
sftp-out
组件的私钥属性),则身份验证将自动使用该密钥值和用户名,而忽略密码字段。如果该属性设置为
false
并且未配置私钥,则身份验证将使用用户名/密码组合。
如果该属性设置为
true
则将同时使用私钥值和用户名/密码组合进行身份验证。
主机密钥的指纹
host-key-fingerprint
FTP 服务器将用于 SSH 通信的加密密钥。
用户名
username
用于访问 FTP 服务器的用户名。
密码
password
与用于访问 FTP 服务器的用户名关联的密码。
二进制文件
binary-file
指定是否以二进制格式传输输出文件。
显式 SSL
explicit-ssl
连接类型:显式 SSL (AUTH TLS) 或隐式 SSL (AUTH SSL)。设置为
true
以使用显式 SSL。
输入文件模式
input-file-pattern
用于匹配特定类型文件的文件名模式。
示例:指定。
*.xls
以仅选取 Excel 文件。
输入内容类型
input-content-type
运行时包含的媒体文件类型
content-type
消息标头中的值。媒体类型至少包含 2 个部分:类型、子类型以及 1 个或多个可选参数。该
text
子类型有一个可选
charset
参数,用于指定字符编码。
示例:
text/html; charset=UTF-8
如果文件是非 XML 文本格式,文件中未明确指定媒体类型和字符集,则此属性特别有用。
输出文件模式
output-file-pattern
指定如何生成输出文件的名称。该模式可以包含文字字符串以及以下一个或多个标记:
  • ${INFILE}
    (将替换为输入文件的名称)。
  • ${UUID}
    (将替换为通用唯一编号)。
  • ${EXT}
    ,位于模式末尾,后者会根据写入程序集组件输出的数据的内容类型替换为文件扩展名。
方法
method
指定转账方法:
  • put
    :将文件写入到包含远程目录的 FTP 端点。
  • list
    :列出 FTP 端点上的所有文件。结合使用
    “输入文件模式”
    属性
    list
    以将模式应用于要返回的列表。您可以访问“”的结果
    list
    方法(使用 MVEL
    ftp
    对象)。示例:
    ftp.list()
    返回一个字符串列表,其中包含最后检索的列表。
  • get
    :会检索第一个与
    “文件输入模式”
    属性值匹配的文件。
  • delete
    :会删除第一个与
    “输入文件模式”
    属性值匹配的文件。
    系统不会自动从 FTP 站点中删除文件
    get
    已执行。如果要删除文件,则必须调用单独的方法。示例:您可以包括一个单独的
    ftp-out
    专门用于删除文件的传输。

“Advanced”选项卡

属性A
XML 属性名称
描述
存储消息
store-message
除非 Workday 技术支持另行通知,否则
指定内容。
要存储消息,请使用 Workday Studio 的“store”
步骤。
传输类
transport-class
如果需要,为每个装配件指定一个备选的实现类。
您可以通过编辑 WEB-INF/classes/spring/assembly-bean.xml 文件来全局更改实现类。
忽略动态端点
ignore-dynamic-endpoints
指定是忽略传入消息标头中的动态 WS-Addressing (WSA) 值,还是使用它来重设传输协议的
Endpoint
属性中的值。
使用“set-dynamic-endpoint”
步骤指定 WS-Addressing 详细信息。
超时
timeout
以毫秒为单位,指定客户端与传输正在侦听的 FTP 服务器之间进行 FTP 会话的超时期限。
如果您未指定值,会话将在 300000 毫秒(5 分钟)后超时。
多用途互联网邮件扩展 (MIME) 类型映射文件
mime-types-map-file
指定映射文件的位置,该映射文件用于在 MIME 类型和文件扩展名之间进行映射。此属性可用于:
  • “方法”
    属性设置为“”时,将 MIME 类型映射到文件扩展名
    put
  • 如果将
    “方法”
    属性设置为“”,则将文件扩展名映射到多用途互联网邮件扩展 (MIME) 类型
    get
用于此映射的文件为
ccx/conf/mome.types
。您可以提供此文件的您自己的版本。
此传输可以使用
${EXT}
令牌置于 的末尾
output-file-pattern
临时文件名
temp-file-name
指定临时文件名。当
“方法”
属性设置为“
put
,将使用此临时文件名上传文件。FTP 完成后,文件将重命名为
“输出文件模式”
属性指定的名称。
关闭连接
close-connection
指定 FTP 操作完成时是否发生断开连接。
池大小
pool-size
此组件在每台主机上支持的最大同时连接数和会话数。如果尝试连接到同一主机的线程数量超过指定数量,则系统会强制要求某些线程等待,直至其可以访问池。
要使池大小不受限制,请指定一个负数。
调试
debug
在传输协议中启用 JSMAPE 调试模式