“FTP 重命名文件”活动
使用 FTP 重命名文件活动可在运行时期间重命名文件和/或将文件移到其他目录。
- 将文件移到新目录,并重命名该文件。例如,将名为 BidAcmeInc.xml 的文件从名为 input directory 的目录移动到 process directory 中,并将该文件重命名为 NewBidAcmeInc.xml。
- 将文件移到新目录,但保留现有文件名。例如,将名为 BidAcmeInc.xml 的文件从名为 input directory 的目录移动到 process directory 中。
- 重命名文件并将其保留在原始目录中。例如,在 input directory 中将名为 BidAcmeInc.xml 的文件重命名为 NewBidAcmeInc.xml。
符号链接
如果以下条件为 true,那么“FTP 重命名文件”活动支持指向目录的符号链接:- 如果托管 FTP 服务器的操作系统支持指向目录的符号链接。
- 如果 FTP 服务器本身支持指向目录的符号链接。
在编排中添加“FTP 重命名文件”活动
- 创建或打开编排。这样会以图形形式显示编排。
- 选择活动选项卡,并展开 FTP 文件夹。
- 将重命名文件活动拖到编排上。
- 选择该活动。这样会显示核对表。
创建、选择或编辑 FTP 端点
- 单击核对表中的选取端点任务,然后选择下列操作之一:
- 选择现有端点:
- 选择浏览。这样会显示 Project Explorer。注意: 指定与原始 FTP 端点具有不同目录结构的新 FTP 端点可导致编排作业在运行时期间失败。您必须指定与最初所指定 FTP 服务器的目录结构匹配的新 FTP 服务器,或者通过按“配置活动”过程中所述单击浏览来更改所在目录字段的已配置目录。
- 选择现有端点并单击确定。转至“配置活动”过程
- 选择浏览。这样会显示 Project Explorer。
- 选择现有端点并编辑该端点:
- 选择浏览。这样会显示 Project Explorer。
- 选择现有端点并单击确定。注意: 指定与原始 FTP 端点具有不同目录结构的新 FTP 端点可导致编排作业在运行时期间失败。您必须指定与最初所指定 FTP 服务器的目录结构匹配的新 FTP 服务器,或者通过按“配置活动”过程中所述单击浏览来更改所在目录字段的已配置目录。
- 单击编辑。这样会显示“编辑端点”窗格。
- 创建新端点:选择新建。这样会显示“创建端点”窗格。
- 选择现有端点:
- 创建或编辑 FTP 端点:创建或编辑 FTP 端点
配置活动
- 从核对表中选择配置任务。这样会显示“配置”窗格。
- 配置此窗格中的字段,如下表所述:
表 1. 字段 描述 重命名 文件名 此字段不用于此活动。您可以使用映射输入任务的 fromFilename 输入参数来指定要重命名的文件的名称。 源目录 指定 FTP 服务器上的某个目录,Integration Appliance 将在其中删除指定文件。您可以使用以下选项之一来指定目录: - 通过单击该字段并输入以下目录路径之一来直接输入目录路径:
- 相对目录路径,例如:/process。(假定已为连接到 FTP 服务器的用户帐户配置了 FTP 主目录。请参阅“注释”以获取更多信息。)
- 完整目录路径,例如在 UNIX 机器上:/home/user/process。
- 单击浏览... 以填充可用目录的下拉列表。从下拉列表中选择相应的目录。
注: UNIX:如果在连接到 UNIX 机器上的 FTP 服务器时指定相对目录路径,请验证是否已针对连接到 FTP 服务器的用户帐户在 /etc/password 文件中正确指定了 FTP 主目录。新路径 此字段不用于此活动。您可以指定完整路径(包含新文件名以及 FTP 服务器上的新目录),Integration Appliance 会将使用“映射输入”任务的 toPath 输入参数来移动的文件放在此路径中。 注: 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 将以错误形式记录第四个连接错误,并停止处理当前编排作业。
映射活动的输入
- 在核对表中选择映射输入任务。这样会显示“重试”窗格。活动的输入参数会显示在“目标活动”窗格中。
- 您必须将变量映射到以下输入参数:
- fromFilename - 在重命名操作期间,此参数可以指定要重命名的文件的原始名称。
- toPath - 在重命名操作期间,此参数可以指定包含新目录名和新文件名的路径。例如,要使用 fileNewName.txt 文件名来指定要移到 FTP 服务器根的 /output 目录中的文件,请为 toPath 指定以下值:/output/fileNewName.txt
所有的其他输入参数都是可选的。请参阅“创建映射”,以获取与映射有关的常规指示信息。
如果下表所列输入参数未显示在“映射输入”窗格的“至活动”窗格中,那么请从工具栏菜单中选择
,或在“至活动”窗格中右键单击并选择“显示可选参数”选项。如果 选项在工具栏菜单中不可选,请单击“映射输入”窗格中的节点以激活此选项。您可以选择性地覆盖运行时期间在核对表的配置和选取端点任务中指定的设置,方法是使用下表中定义的输入参数。
例如,可以在配置任务中将 FTP 服务器上被 Integration Appliance 用于放置此活动所生成文件的目录设置为名为 output 的目录。在运行时期间,可能会使用 directory 输入参数将目录名 outputXML 传递到此活动中。在运行时期间动态指定的目录名称覆盖“配置”窗格中指定的原始设置。 在此示例中,文件会放置在 outputXML 目录中。
表 3. 输入参数名称/节点 描述 是否覆盖任务中的设置? 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 端点的密码字段。
映射活动的输出
- 在核对表中选择映射输出任务。此时在“源活动”窗格中会显示 directoryListing 或 fileListing 输出参数。
- 将 directoryListing 或 fileListing 输出参数映射到变量。请参阅“创建映射”,以获取与映射有关的常规指示信息。
在运行时期间,FTP 列出文件活动会使用 directoryListing 或 fileListing 输出参数向编排返回文件列表。
如果在配置任务中清除了仅列出文件 (NLST) 复选框,那么将通过 directoryListing 输出参数以单个字符串的形式来返回完整的目录列表,其中包含目录许可权、时间戳记和所有权。如果以字符串形式返回了完整的目录列表,那么您必须使用带有读取平面文件活动的平面文件模式来解析目录列表。您可以使用平面文件模式编辑器来创建平面文件模式。有关使用平面文件模式来解析目录列表的示例编排,请参阅“解析目录列表示例”:解析目录列表示例。
如果选中了仅列出文件 (NLST) 复选框,而且 FTP 列出文件活动支持您的 FTP 服务器的目录列表格式,那么 fileListing 输出参数会返回一个仅包含文件名的重复结构。如果返回了文件名的重复结构,那么您无需解析目录列表,并且可以使用针对每个或 While 循环活动只对列表进行迭代。