PutFTP

PutFTP Processor

类型全限定名：cn.org.acal.lynxus.processors.standard.PutFTP

所属 Bundle：cn.org.acal.lynxus:lynxus-standard-nar:2.11.8

描述

将 FlowFiles 发送到 FTP 服务器

属性

下表中，加粗的属性为必填项；其余为可选项。表格同时标注默认值、是否支持表达式语言，以及是否为敏感属性（值会被加密）。

名称	默认值	可选值	描述
Hostname			远程系统的完全限定主机名或 IP 地址支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Port	`21`		远程系统正在侦听文件传输的端口支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Username			用户名支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Password			用户帐户的密码敏感属性：是支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Remote Path			远程系统上从中拉取或推送文件的路径支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Create Directory	`false`	true false	指定如果远程目录不存在，是否应创建该目录。
Batch Size	`500`		单个连接中发送的最大 FlowFile 数量
Connection Timeout	`30 sec`		创建连接时超时之前等待的时间量
Data Timeout	`30 sec`		在本地和远程系统之间传输文件时，该值指定允许在系统之间不传输任何数据的时间长度
Conflict Resolution	`NONE`	REPLACE — 远程文件被新文件替换，FlowFile 进入 success IGNORE — 文件不被传输，FlowFile 进入 success RENAME — 新文件在开头以递增编号重命名，FlowFile 进入 success REJECT — 文件不被传输，FlowFile 进入 reject FAIL — 文件不被传输，FlowFile 进入 failure NONE — 传输前不检查冲突，FlowFile 进入 success 或 failure	确定如何处理文件名冲突问题
Dot Rename	`true`	true false	如果为 true，发送文件的文件名将在前面加上'.'，文件完全发送后再重命名回原始名称。否则不进行重命名。如果设置了'临时文件名'属性，则忽略此属性。
Temporary Filename			如果设置，发送文件的文件名在传输期间将等于指定的值，成功完成后将重命名为原始文件名。如果设置了此值，则忽略'点重命名'属性。支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Transfer Mode	`Binary`	Binary ASCII	FTP传输模式
Connection Mode	`Passive`	Active Passive	FTP 连接方式
Reject Zero-Byte Files	`true`	true false	确定是否应拒绝零字节文件而不尝试传输
Last Modified Time			传输文件后分配给文件的最后修改时间。如果未设置，最后修改时间将不会更改。格式必须为 yyyy-MM-dd'T'HH:mm:ssZ。您也可以使用表达式语言如 ${file.lastModifiedTime}。如果值无效，处理器不会变为无效状态，但将无法更改文件的最后修改时间。支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Permissions			传输文件后分配给文件的权限。格式必须为 UNIX rwxrwxrwx（用 - 表示拒绝的权限，如 rw-r--r--）或八进制数（如 644）。如果未设置，权限将不会更改。您也可以使用表达式语言如 ${file.permissions}。如果值无效，处理器不会变为无效状态，但将无法更改文件的权限。支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Use Compression	`false`	true false	指示传输文件时是否应使用 ZLIB 压缩
Proxy Configuration Service		控制器服务 API： `ProxyConfigurationService` cn.org.acal.lynxus-lynxus-standard-services-api-nar-2.11.8	指定代理配置 Controller Service 来代理网络请求。
Internal Buffer Size	`16KB`		设置缓冲数据流的内部缓冲区大小
Use UTF-8 Encoding	`false`	true false	告诉客户端在处理文件和文件名时使用 UTF-8 编码。如果设置为 true，服务器还必须支持 UTF-8 编码。

动态属性

动态属性允许用户自定义属性的名称与值。

名称	值	描述
pre.cmd._____	未使用	键中指定的命令将在 put 之前执行。您可以添加这些可选属性以在文件实际传输之前（在 put 命令之前）向 FTP 服务器发送任何命令。此选项仅适用于 PutFTP 处理器，因为只有 FTP 具有此功能。这本质上与从命令行向 FTP 服务器发送 quote 命令相同。虽然这与发送 quote 命令相同，但非常重要的一点是您不要加上点号。
post.cmd._____	未使用	键中指定的命令将在 put 之后执行。您可以添加这些可选属性以在文件实际传输之前（在 put 命令之前）向 FTP 服务器发送任何命令。此选项仅适用于 PutFTP 处理器，因为只有 FTP 具有此功能。这本质上与从命令行向 FTP 服务器发送 quote 命令相同。虽然这与发送 quote 命令相同，但非常重要的一点是您不要加上点号。

关系 (Relationships)

名称	描述	自动终止
`failure`	未能发送到远程系统的 FlowFiles；故障通常会循环回到该处理器	否
`reject`	被目标系统拒绝的 FlowFiles	否
`success`	发送成功的FlowFiles将会被路由到成功	否

状态管理

该组件不存储状态。

受限 (Restricted)

该组件不受限。

输入要求

该组件要求有传入连接。

另请参阅

GetFTP