在运行时期间,FTP 列出文件活动连接到 FTP 服务器并使用指定正则表达式从指定目录位置生成文件列表。FTP 列出文件活动会使用 directoryListing 或 fileListing 输出参数向编排返回文件列表。
如果已清除仅列出文件 (NLST) 复选框,那么在 directoryListing 输出参数中会将完整目录列表(包括目录许可权、时间戳记和所有权)作为单个字符串返回。如果以字符串形式返回了完整的目录列表,那么您必须使用带有读取平面文件活动的平面文件模式来解析目录列表。如果已选中“仅列出文件 (NLST)”复选框,并且“FTP 列出文件”活动支持 FTP 服务器的目录列表格式,那么在 fileListing 输出参数中会返回仅包含文件名(如果受 FTP 服务器支持)的重复结构。在返回了文件名重复结构时,无需解析目录列表,可以只是使用 For Each 或 While 循环活动通过列表进行迭代。您连接的 FTP 服务器必须支持 NLST 命令。这样会返回 FTP 服务器提供的响应。
对于某些情况,必须将 FTP 列出文件活动与 FTP 获取文件、FTP 放置文件、FTP 删除文件 和 FTP 重命名文件活动协同使用,以处理在 FTP 目录中找到的文件集;而在其他情况下,只要使用 FTP 轮询目录活动即可。
符号链接到... | 硬符号链接 | 软符号链接 | Notes® |
---|---|---|---|
文件 | 不受支持 | 不受支持 | FTP 列出文件活动不会将指向文件的符号链接解释为文件,因此在运行时期间指向文件的符号链接未通过 FTP 列出文件活动进行处理。 |
目录 | 受支持 | 受支持 |
字段 | 描述 |
---|---|
目录 | 指定 FTP 服务器上的目录,Integration Appliance 将在其中生成文件列表。
您可以使用以下选项之一来指定目录:
注: UNIX:如果在连接到 UNIX 机器上的 FTP 服务器时指定相对目录路径,请验证是否已针对连接到 FTP 服务器的用户帐户在 /etc/password 文件中正确指定了 FTP 主目录。
|
文件名 | 指定用于定义要从 FTP 服务器获取的文件名的 glob 模式。由 FTP 服务器完成对 glob 模式的处理。有关更多信息,请参阅有关 glob 模式的 FTP 服务器文档。 |
仅列出文件 (NLST) | 仅列出文件 (NLST) 复选框确定运行时期间通过“测试”按钮返回的目录列表类型。此外,此复选框还确定 fileListing 或 directoryListing 输出参数是否显示在映射输出任务中并由活动在运行时期间返回。 |
如果已选中仅列出文件 (NLST) 复选框,那么在单击测试按钮时仅会返回文件名(如果受 FTP 服务器支持),如图 1 中所示。此外,当选中了仅列出文件 (NLST) 复选框时,在“映射输出”任务中会列出 fileListing 输出参数。在运行时期间,在 fileListing 输出参数的 fileName 重复节点中会返回文件集。您连接的 FTP 服务器必须支持 NLST 命令。这样会返回 FTP 服务器提供的响应。 | |
如果已清除仅列出文件 (NLST) 复选框,那么在单击测试按钮时会返回完整目录列表(包括目录许可权、时间戳记和所有权),如图 2 中所示:此外,当选中了仅列出文件 (NLST) 复选框时,在映射输出任务中会列出 directoryListing 输出参数。在运行时期间,完整目录列表会作为单个字符串提供并通过使用 directoryListing 输出参数进行返回。 |
bidAcmeInc.txtbidBudgetManufacture.txtbidCrankCo.txtbidSamAndSons.txtbidWidgetRUs.txt
-rw-r--r-- 1 551 551 65 May 3 11:39 bidAcmeInc.txt
-rw-r--r-- 1 551 551 43 May 3 11:39 bidBudgetManufacture.txt
-rw-r--r-- 1 551 551 0 May 3 11:39 bidCrankCo.txt
-rw-r--r-- 1 551 551 73 May 3 11:39 bidSamAndSons.txt
-rw-r--r-- 1 551 551 33 May 3 11:39 bidWidgetRUs.txt
字段 | 描述 |
---|---|
重试 | |
1) 在两次重试之间等待 ___ 秒。 | Integration Appliance 在尝试与 FTP 服务器建立连接之前等待的秒数。 |
2) 在尝试连接 ___ 次后失败。 | 指定重试计数 - Integration Appliance 在发出错误之前尝试与 FTP 服务器建立连接的最大次数。 如果已部署以 FTP 列出文件活动开始的编排,并且 Integration Appliance 无法连接到指定的 FTP 服务器,那么 Integration Appliance 会在系统日志中将连接错误记录为警告,直至达到重试计数值。在达到了重试计数时,Integration Appliance 会在系统日志中记录错误,将连接错误计数重置为零,并且继续尝试与 FTP 服务器建立连接。 例如,您将重试计数设置为 3。第一个、第二个和第三个连接错误在系统日志中显示为“警告”。Integration Appliance 将第四个连接错误记录为错误并将连接错误计数重置为零。因此,第五个连接错误会在系统日志中生成警告。Integration Appliance 会继续尝试与 FTP 服务器建立连接。 |
如果“映射输入”窗格的“目标活动”窗格中未显示下表中列出的输入参数,请从工具栏菜单中选择显示可选参数选项。 如果 选项在工具栏菜单中不可选,请单击“映射输入”窗格中的节点以激活此选项。
,或者在“目标活动”窗格中右键单击,然后选择您可以选择性地覆盖运行时期间在核对表的配置和选取端点任务中指定的设置,方法是使用下表中定义的输入参数。
例如,可以在配置任务中将 Integration Appliance 获取文件列表所在的 FTP 服务器上的目录设置为名为 input 的目录。在运行时期间,可能会使用 directory 输入参数将目录名 inputXML 传递到此活动中。在运行时期间动态指定的目录名称覆盖“配置”窗格中指定的原始设置。在此示例中,文件列表是从 inputXML 目录中生成的。
输入参数名称/节点 | 描述 | 是否覆盖任务中的设置? |
---|---|---|
directory | 指定 FTP 服务器上的目录,Integration Appliance 将在其中生成文件列表。 | 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 端点的密码字段。 |
在运行时期间,FTP 列出文件活动会使用 directoryListing 或 fileListing 输出参数向编排返回文件列表。
如果在配置任务中清除了仅列出文件 (NLST) 复选框,那么在 directoryListing 输出参数中会将完整目录列表(包括目录许可权、时间戳记和所有权)作为单个字符串返回。将完整目录列表作为字符串返回时,必须将平面文件模式与“读取平面文件”活动配合使用来解析目录列表。您可以使用平面文件模式编辑器来创建平面文件模式。有关使用平面文件模式解析目录列表的示例编排,请参阅解析目录列表示例:解析目录列表示例。
如果已选中仅列出文件 (NLST) 复选框,并且 FTP 列出文件活动支持 FTP 服务器的目录列表格式,那么在 fileListing 输出参数中会返回仅包含文件名(如果受 FTP 服务器支持)的重复结构。在返回了文件名重复结构时,无需解析目录列表,可以只是使用针对每个或 While 循环活动通过列表进行迭代。