“FTP 删除文件”活动
使用 FTP 删除文件活动可在运行时期间从特定目录中删除特定文件。
通常,FTP 删除文件活动与 FTP 列出文件活动协同使用,如以下示例编排中所示:
- 调度作业活动每小时创建编排作业。
- FTP 列出文件活动生成位于 FTP 服务器根目录的 \temp 目录中找到的文件列表并将结果存储到字符串中。
- 读取平面文件活动解析文件列表并将结果存储到重复 XML 结构中。
- 针对每个活动通过包含文件列表的重复结构进行迭代:
- 如果文件以 .tmp 扩展名结尾,那么 FTP 删除文件活动会删除指定文件。
符号链接
如果下列条件成立,那么 FTP 删除文件活动支持指向目录的符号链接:- 如果托管 FTP 服务器的操作系统支持指向目录的符号链接。
- 如果 FTP 服务器本身支持指向目录的符号链接。
在编排中添加“FTP 删除文件”活动
- 创建或打开编排。这样会以图形形式显示编排。
- 选择活动选项卡,并展开 FTP 文件夹。
- 将删除文件活动拖至编排中。
- 选择该活动。这样会显示核对表。
创建、选择或编辑 FTP 端点
- 单击核对表中的选取端点任务,然后选择下列操作之一:
- 选择现有端点:
- 选择浏览。这样会显示 Project Explorer。注意: 指定与原始 FTP 端点具有不同目录结构的新 FTP 端点可导致编排作业在运行时期间失败。您必须指定与最初所指定 FTP 服务器的目录结构匹配的新 FTP 服务器,或者通过按“配置活动”过程中所述单击浏览来更改所在目录字段的已配置目录。
- 选择现有端点并单击确定。转至“配置活动”过程。
- 选择浏览。这样会显示 Project Explorer。
- 选择现有端点并编辑该端点:
- 选择浏览。这样会显示 Project Explorer。
- 选择现有端点并单击确定。注意: 指定与原始 FTP 端点具有不同目录结构的新 FTP 端点可导致编排作业在运行时期间失败。您必须指定与最初所指定 FTP 服务器的目录结构匹配的新 FTP 服务器,或者通过按“配置活动”过程中所述单击浏览来更改所在目录字段的已配置目录。
- 单击编辑。这样会显示“编辑端点”窗格。
- 创建新端点:选择新建。这样会显示“创建端点”窗格。
- 选择现有端点:
- 创建或编辑 FTP 端点:创建或编辑 FTP 端点
配置活动
- 从核对表中选择配置任务。这样会显示“配置”窗格。
- 配置此窗格中的字段,如下表所述:
表 1. 字段 描述 查找 文件名 此字段不用于此活动。通过使用映射输入任务的 filename 输入参数来指定要删除的文件的名称。 目录 指定 FTP 服务器上的某个目录,Integration Appliance 将在其中删除指定文件。您可以使用以下选项之一来指定目录: - 通过单击该字段并输入以下目录路径之一来直接输入目录路径:
- 相对目录路径,例如:/process。(假定已为连接到 FTP 服务器的用户帐户配置了 FTP 主目录。请参阅“注释”以获取更多信息。)
- 完整目录路径,例如在 UNIX 机器上:/home/user/process。
- 单击浏览... 以填充可用目录的下拉列表。从下拉列表中选择相应的目录。
- directory 输入参数会映射到变量。
- 针对 directory 输入参数提供了缺省值。
注: UNIX:如果在连接到 UNIX 机器上的 FTP 服务器时指定相对目录路径,请验证是否已针对连接到 FTP 服务器的用户帐户在 /etc/password 文件中正确指定了 FTP 主目录。 - 通过单击该字段并输入以下目录路径之一来直接输入目录路径:
指定重试选项
- 从核对表中选择重试任务。这样会显示“重试”窗格。
- 配置用于连接到 FTP 服务器的重试选项。下表描述了用于连接到 FTP 服务器的重试选项:
表 2. 字段 描述 重试 1) 在两次重试之间等待 ___ 秒。 Integration Appliance 在尝试与 FTP 服务器建立连接之前等待的秒数。 2) 在尝试连接 ___ 次后失败。 指定 Integration Appliance 在发出错误并停止处理当前编排作业之前尝试与 FTP 服务器建立连接的最大次数。 如果部署包含 FTP 删除文件活动的编排并且 Integration Appliance 无法连接到指定的 FTP 服务器,那么 Integration Appliance 会在系统和编排日志中将连接错误记录为警告,直至达到重试计数值。当达到重试计数时,Integration Appliance 会在系统和编排日志中记录错误,并且停止处理当前编排作业。
例如,您将重试计数设置为 3。第一个、第二个和第三个连接错误在系统日志中显示为“警告”。Integration Appliance 将第四个连接错误记录为错误,并且停止处理当前编排作业。
映射活动的输入
- 在核对表中选择映射输入任务。这样会显示“重试”窗格。活动的输入参数会显示在“至活动”窗格中。
- 必须将变量映射到 filename 输入参数。所有其他输入参数是可选的。filename 参数指定 FTP 服务器上要删除的文件的名称。
如果“映射输入”窗格的“至活动”窗格中未显示下表中列出的输入参数,请从工具栏菜单中选择显示可选参数选项。 如果 选项在工具栏菜单中不可选,请单击“映射输入”窗格中的节点以激活此选项。
,或者在“至活动”窗格中右键单击,然后选择您可以选择性地覆盖运行时期间在核对表的配置和选取端点任务中指定的设置,方法是使用下表中定义的输入参数。
例如,可以在配置任务中将 Integration Appliance 删除文件所在的 FTP 服务器上的目录设置为名为 process 的目录。在运行时期间,可能会使用 directory 输入参数将目录名 processXML 传递到此活动中。在运行时期间动态指定的目录名称覆盖“配置”窗格中指定的原始设置。在此示例中,会从 processXML 目录中删除文件。
输入参数名称/节点 | 描述 | 是否覆盖任务中的设置? |
---|---|---|
directory | 指定 Integration Appliance 将此活动中生成的文件在 FTP 服务器上的放置目录。 | directory 输入参数覆盖配置任务的目录字段。 |
connection/timeout | 指定在 Integration Appliance 尝试与端点建立连接和端点响应连接请求期间发生超时之前等待的秒数。对于 FTP 删除文件活动,指的是在超时之前 Integration Appliance 尝试与 FTP 服务器建立连接所花费的时间量。 | connection 输入参数的 timeout 节点覆盖 FTP 端点的连接超时 - 在与端点建立连接 ___ 秒后将超时字段。 |
connection/host | 指定 FTP 服务器的主机名或 IP 地址。 | connection 输入参数的 host 节点覆盖 FTP 端点的主机名字段。 |
connection/port | 为所指定的主机名指定端口号。FTP 流量的标准端口为 21。SFTP 流量的缺省端口为 22。 | connection 输入参数的 port 节点覆盖 FTP 端点的端口字段。 |
connection/username | 指定用于连接到 FTP 服务器的帐户的用户名。 | connection 输入参数的 username 节点覆盖 FTP 端点的用户名字段。 |
connection/password | 指定用于连接到 FTP 服务器的帐户的密码。 | connection 输入参数的 password 节点覆盖 FTP 端点的密码字段。 |