在运行时期间,FTP 获取文件活动连接到 FTP 服务器并尝试获取指定位置的单个文件。您可以配置 FTP 获取文件活动,以将文件内容返回到编排的变量中。此外,还可以配置 FTP 获取文件活动,以将 FTP 服务器返回的文件的时间戳记返回到编排的变量中。
符号链接到... | 硬符号链接 | 软符号链接 | Notes® |
---|---|---|---|
文件 | 不受支持 | 不受支持 | FTP 获取文件活动不会将指向文件的符号链接解释为文件,因此在运行时期间指向文件的符号链接未通过 FTP 获取文件活动进行处理。 |
目录 | 受支持 | 受支持 |
字段 | 描述 |
---|---|
文件名 | 此字段不用于此活动。通过使用映射输入任务的 filename 输入参数来指定输出文件的名称。 |
源目录 | 指定 Integration Appliance 将此活动中生成的文件在 FTP 服务器上的放置目录。
您可以使用以下选项之一来指定目录:
注: UNIX:如果在连接到 UNIX 机器上的 FTP 服务器时指定相对目录路径,请验证是否已针对连接到 FTP 服务器的用户帐户在 /etc/password 文件中正确指定了 FTP 主目录。
|
类型 | 指定如何读入文件的内容 - 以二进制数据或编码文本形式。如果选择了文本选项,请使用下列选项之一设置编码类型:
|
注意: 如果在以 ASCII 方式与 FTP 端点之间来回传输数据时针对操作文本数据的端点检索文本文件并将文本文件放置在 FTP 服务器上,那么必须为 FTP 活动指定以文本 (ASCII) 方式传输选项。例如,在以 ASCII 方式传递数据时,大型机和 DOS FTP 端点操作 ASCII 数据。
例如,如果编排使用 FTP 轮询目录活动来检索 ASCII 文件并使用“FTP 放置文件”活动将 ASCII 文件放置到大型机 FTP 服务器,那么必须在 Studio 内的下列任务中指定选项:
|
字段 | 描述 |
---|---|
重试 | |
1) 在两次重试之间等待 ___ 秒。 | Integration Appliance 在尝试与 FTP 服务器建立连接之前等待的秒数。 |
2) 在尝试连接 ___ 次后失败。 | 指定重试计数 - Integration Appliance 在发出错误并停止处理当前编排作业之前尝试与 FTP 服务器建立连接的最大次数。 如果部署包含 FTP 获取文件活动的编排并且 Integration Appliance 无法连接到指定的 FTP 服务器,那么 Integration Appliance 会在系统和编排日志中将连接错误记录为警告,直至达到重试计数值。当达到重试计数时,Integration Appliance 会在系统和编排日志中记录错误,并且停止处理当前编排作业。 例如,您将重试计数设置为 3。第一个、第二个和第三个连接错误在系统日志中显示为“警告”。Integration Appliance 将第四个连接错误记录为错误,并且停止处理当前编排作业。 |
如果“映射输入”窗格的“目标活动”窗格中未显示下表中列出的可选输入参数,请从工具栏菜单中选择显示可选参数选项。 如果 选项在工具栏菜单中不可选,请单击“映射输入”窗格中的节点以激活此选项。
,或者在“目标活动”窗格中右键单击,然后选择您可以选择性地覆盖运行时期间在核对表的配置和选取端点任务中指定的设置,方法是使用下表中定义的输入参数。
例如,可以在配置任务中将 Integration Appliance 获取文件所在的 FTP 服务器上的目录设置为名为 input 的目录。在运行时期间,可能会使用 directory 输入参数将目录名 inputXML 传递到此活动中。 在运行时期间动态指定的目录名称覆盖“配置”窗格中指定的原始设置。在此示例中,Integration Appliance 尝试从 inputXML 目录中获取文件。
输入参数名称/节点 | 描述 | 是否覆盖任务中的设置? |
---|---|---|
directory | 指定 Integration Appliance 将此活动中生成的文件在 FTP 服务器上的放置目录。 | directory 输入参数覆盖配置任务的源活动字段。 |
encoding | 指定如何将传出数据写出到文件:
|
encoding 输入参数覆盖配置任务的类型字段中指定的编码,但是如果在配置任务的类型字段中选择了二进制选项,那么会忽略 encoding 输入参数指定的编码。 |
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 端点的密码字段。 |
输出参数名称 | 描述 |
---|---|
数据 | 包含文件的内容。 |
timestamp | 包含从 FTP 服务器返回的文件的时间戳记,通常是文件的创建日期或上次修改日期。 |