使用 FTP 重命名文件活动可在运行时期间重命名文件和/或将文件移到其他目录。
字段 | 描述 |
---|---|
重命名 | |
文件名 | 此字段并不用于此活动。您可以使用映射输入任务的 fromFilename 输入参数来指定要重命名的文件的名称。 |
源目录 | 指定 FTP 服务器上的某个目录,Integration Appliance 将在其中删除指定文件。您可以使用以下选项之一来指定目录:
注: UNIX:如果在连接 UNIX 机器上的 FTP 服务器时指定了相对目录路径,那么请验证是否已在 /etc/password 文件中为连接到 FTP 服务器的用户帐户正确指定了 FTP 主目录。
|
新路径 | 此字段并不用于此活动。您可以指定完整路径(包含新文件名以及 FTP 服务器上的新目录),Integration Appliance 会将使用“映射输入”任务的 toPath 输入参数来移动的文件放在此路径中。 注: UNIX:如果在连接 UNIX 机器上的 FTP 服务器时指定了相对目录路径,那么请验证是否已在 /etc/password 文件中为连接到 FTP 服务器的用户帐户正确指定了 FTP 主目录。
|
选项 - 选择以下选项之一,以定义当指定输出目录中已存在同名现有文件时应执行的操作: | |
如果找到重复文件名,那么覆盖现有文件 | 指定当文件已存在时使用活动所返回的新数据来破坏原始文件的内容。 |
如果找到名称重复的文件,那么发出错误 | 指定当文件已存在时保留文件中的原始数据、抛出错误且不对活动所返回的新数据执行任何操作。 |
字段 | 描述 |
---|---|
重试 | |
1) 前后两次重试之间的等待时间(以秒为单位)。 | Integration Appliance 在尝试与 FTP 服务器建立连接之前要等待的秒数。 |
2) 失败之前的连接尝试次数。 | 指定重试计数,即 Integration Appliance 在发出错误并停止处理当前编排作业之前尝试与 FTP 服务器建立连接的最大次数。 如果部署了包含 FTP 重命名文件活动的编排,而且 Integration Appliance 无法连接指定的 FTP 服务器,那么 Integration Appliance 会将连接错误以警告的形式记录在系统和编排日志中,直至达到重试计数值为止。在达到重试计数之后,Integration Appliance 会在系统和编排日志中记录错误,并停止处理当前编排作业。 例如,将重试计数设置为 3。第一、第二和第三个连接错误将以警告的形式出现在系统日志中。Integration Appliance 将以错误形式记录第四个连接错误,并停止处理当前编排作业。 |
所有的其他输入参数都是可选的。请参阅“创建映射”,以获取与映射有关的常规指示信息。
如果下表所列输入参数未显示在“映射输入”窗格的“目标活动”窗格中,那么请从工具栏菜单中选择
,或在“目标活动”窗格中右键单击并选择“显示可选参数”选项。如果无法在工具栏菜单中选择 选项,那么请单击“映射输入”窗格中的节点以激活此选项。您也可以选择使用下表所定义的输入参数来覆盖自己在运行时期间在核对表的配置和选取端点任务中动态指定的设置。
例如,可以在配置任务中将 FTP 服务器上被 Integration Appliance 用于放置此活动所生成文件的目录设置为名为 output 的目录。在运行时期间,可能会使用 directory 输入参数将目录名 outputXML 传递到此活动中。在运行时期间动态指定的目录名会覆盖“配置”窗格所指定的原始设置。 在此示例中,会将文件放置在 outputXML 目录中。
输入参数名称/节点 | 描述 | 是否覆盖任务中的设置? |
---|---|---|
fromDirectory | 指定 FTP 服务器上的目录,Integration Appliance 将在其中获取文件列表。 | directory 输入参数会覆盖配置任务的所在目录字段。 |
overwrite | 指定在 Integration Appliance 尝试与端点建立连接和端点响应连接请求之间发生超时情况前的时间量(以秒为单位)。对于 FTP 列出文件活动,指的是 Integration Appliance 在超时之前尝试与 FTP 服务器建立连接所花费的时间量。 | connection 输入参数的 timeout 节点会覆盖 FTP 端点的连接超时 - 超时时间(以秒为单位,从端点连接建立时开始算起)字段。 |
connection/timeout | 指定 FTP 服务器的主机名或 IP 地址。 | connection 输入参数的 timeout 节点会覆盖 FTP 端点的连接超时 - 超时时间(以秒为单位,从端点连接建立时开始算起)字段。 |
connection/host | 为所指定的主机名指定端口号。FTP 流量的标准端口为 21。SFTP 流量的缺省端口为 22。 | connection 输入参数的 host 节点会覆盖 FTP 端点的主机名字段。 |
connection/port | 为所指定的主机名指定端口号。FTP 流量的标准端口为 21。SFTP 流量的缺省端口为 22。 | connection 输入参数的 port 节点会覆盖 FTP 端点的端口字段。 |
connection/username | 指定要用于连接 FTP 服务器的帐户的用户名。 | connection 输入参数的 username 节点会覆盖 FTP 端点的用户名字段。 |
connection/password | 指定要用于连接 FTP 服务器的帐户的密码。 | connection 输入参数的 password 节点会覆盖 FTP 端点的密码字段。 |
在运行时期间,FTP 列出文件活动会使用 directoryListing 或 fileListing 输出参数向编排返回文件列表。
如果在配置任务中清除了仅列出文件 (NLST) 复选框,那么将通过 directoryListing 输出参数以单个字符串的形式来返回完整的目录列表,其中包含目录许可权、时间戳记和所有权。如果以字符串形式返回了完整的目录列表,那么您必须使用带有读取平面文件活动的平面文件模式来解析目录列表。您可以使用平面文件模式编辑器来创建平面文件模式。有关使用平面文件模式来解析目录列表的示例编排,请参阅“解析目录列表示例”:解析目录列表示例。
如果选中了仅列出文件 (NLST) 复选框,而且 FTP 列出文件活动支持您的 FTP 服务器的目录列表格式,那么 fileListing 输出参数会返回一个仅包含文件名的重复结构。如果返回了文件名的重复结构,那么您无需解析目录列表,并且可以使用针对每个或 While 循环活动只对列表进行迭代。