跳至主要内容
Administrator Guide
上次更新时间 :2024-07-26
参考信息:FTP 子程序集属性

参考信息:FTP 子程序集属性

Studio 调色板中不再提供“FTP 子装配件”选项。在新集成中,您应使用
ftp-out
sftp-out
组件将文档发送到 FTP 服务器。这些组件可提高安全性、性能和可靠性。它们还与更高版本的 JSCAPE 兼容。该 FTP 子程序集在现有集成中仍然可用,但 Workday 建议您在切实可行的情况下将其替换。

公用选项卡

属性A
XML 属性名称
描述
编号
id
Ftp
子装配件在程序集中的唯一编号。
将回复发送至
routes-response-to
Ftp
子程序集响应消息的目标。
执行时间
execute-when
确定是否执行
Ftp
子程序集的条件。
端点
endpoint
子装配件的目标端点地址。
Ftp
组件支持
vm://
端点地址。示例:
vm://wcc/Ftp

“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 详细信息。
复制申请
clone-request
指定是否在子装配件之间进行链式处理。设置为“true”
可创建原始消息的副本,这样任何修改请求消息的子程序集都不会影响其他子程序集。设置为“false”
可传递原始消息。
传播中止
propagate-abort
指定中止标志是否从子程序集中传播到调用程序集。
子装配件在标记
MediationContext
状态为“已中止”。
取消设置属性
unset-properties
指定在
本地转出
传输函数调用子部件后,是否重置所有的
本地输出
属性。

“Parameters”选项卡

参数
描述
wd.ftp.endpoint
此端点方案用于确定要使用的
FTP 输出
传输方式。端点必须以以下开头:
ftp://
sftp://
,或
ftps://
wd.ftp.username
用于访问 FTP 服务器的用户名。
wd.ftp.password
与用于访问 FTP 服务器的用户名关联的密码。
wd.ftp.method
与端点连接时,FTP 子部件实施的方法或消息操作。请将每项操作用单引号引起来。有效选项包括:
  • 'put'
    :FTP 组件将消息发送到 FTP 服务器,并且消息保持不变。
  • 'get'
    :程序集会将消息的根部分替换为从 FTP 服务器接收的数据。
  • 'list'
    :消息保持不变。Workday 添加了一个名为“”的上下文属性
    wd.ftp.files.list
    ,其中包含
    List<String>
    对象实例。
    使用
    'list'
    方法,文件模式为
    *.txt
    *.xml
    会导致异常。
  • 'delete'
    :Workday 请求从 FTP 服务器删除文件。该消息保持不变。
  • 'mget'
    (MultiGet):Workday 下载与输入模式匹配的所有文件,并将消息的根目录部分替换为包含这些文件的 ZIP 文件。
  • 'mdelete'
    (MultiDelete):Workday 会删除与输入模式匹配的所有文件。该消息保持不变。
wd.ftp.passive.mode
指定在 FTP 连接期间是否使用被动模式。
wd.ftp.file.pattern
指定执行 FTP 操作时使用的文件模式。示例:
  • *.xml
  • *.txt
对于除
list
, Workday 支持通配符,并在客户端执行筛选。对于
list
方法,Workday 使用基于正则表达式语法的服务器端筛选。示例:
  • wd.ftp.method
    'get'
    wd.ftp.file.pattern
    *.xml
    :Workday 会获取在 FTP 服务器上的指定目录中找到的第一个 .xml 文件。
  • wd.ftp.method
    'mget'
    wd.ftp.file.pattern
    *.xml
    :Workday 会获取在 FTP 服务器的指定目录下找到的所有 .xml 文件,并以 ZIP 格式返回这些文件。
  • wd.ftp.method
    'list'
    wd.ftp.file.pattern
    ^.*\.(xml)$
    :Workday 会列出在 FTP 服务器的指定目录中找到的所有 .xml 文件。
wd.ftp.temp.file.name
指定在执行 FTP 操作时是否应使用临时文件。
put
消息操作。
wd.ftp.timeout
消息操作的超时设置(以毫秒为单位)。
wd.ftp.directory
相对路径或完全限定的目录路径。
wd.ftp.private.key
与用户名关联的私钥,用于 SFTP 身份验证。使用附件协议和 Workday 编号,将其设置为 URI 格式。示例:
attachment:privatekey/@{WID}
,其中 Workday 编号对应于 32 个字符的 Workday 编号。
wd.ftp.max.attempts
访问 FTP 服务器的最大尝试次数。
wd.ftp.debug
指定 Workday 是否向日志添加调试日志记录。
wd.ftp.proxy.host
FTP 代理服务器的主机名。
wd.ftp.proxy.port
FTP 代理服务器端口。
wd.ftp.proxy.username
用于访问 FTP 代理服务器的用户名。
wd.ftp.proxy.password
FTP 代理服务器的密码。
wd.ftp.proxy.type
代理服务器的类型。
wd.ftp.input.content.type
指定使用 FTP 检索的文件的内容类型
get
。示例:
text/plain; charset=Big5