在运行时期间,“FTP 轮询目录”活动连接到 FTP 服务器并在指定位置轮询是否存在指定的一个或多个文件。读取一个或多个文件的内容并将内容映射到编排的一个或多个变量后,FTP 轮询目录活动可删除文件、移动文件或将文件保留在 FTP 服务器的目录中。
“FTP 轮询目录”活动是启动器活动。将以 FTP 轮询目录活动开始的编排部署到 Integration Appliance 时,Integration Appliance 会轮询要添加到 FTP 服务器上特定目录的一个或多个文件。在 FTP 服务器上显示了一个或多个文件时,将会启动编排作业来对文件和编排中的其余活动进行处理。有关更多信息,请参阅轮询时间间隔行为。有关使用 FTP 轮询目录活动的编排示例,请参阅《入门指南》。
符号链接到... | 硬符号链接 | 软符号链接 | Notes® |
---|---|---|---|
文件 | 不受支持 | 不受支持 | FTP 轮询目录活动不会将指向文件的符号链接解释为文件,因此在运行时期间指向文件的符号链接未通过 FTP 轮询目录活动进行处理。 |
目录 | 受支持 | 受支持 |
您可以对包含 FTP 轮询目录活动的编排启用持久性。 例如,如果您禁用持久性并且具有已选择保持位置不变选项的包含 FTP 轮询目录活动的编排作业,那么在运行时期间,如果发生失败导致作业停止,那么在重新启动编排后,该作业会再次对文件进行处理。作业状态将丢失,并且 Integration Appliance 不知道其是否已处理文件。有关更多信息,请参阅启用持久性。
字段 | 描述 |
---|---|
文件名 | 指定用于定义要从 FTP 服务器获取的一个或多个文件名的模式或正则表达式。正则表达式的处理通过 FTP 服务器来进行。有关更多信息,请参阅关于正则表达式的 FTP 服务器文档。通常,FTP 服务器在其正则表达式中支持下列通配符:
注: 由于正则表达式的处理是在 FTP 服务器上进行的,因此是否区分大小写由 FTP 服务器来确定。
如果 FTP 服务器区分大小写,那么通过“FTP 轮询目录”活动进行的文件匹配也区分大小写。
|
目录 | 指定 Integration Appliance 查找 FTP 服务器上的文件所在的目录。您可以使用以下选项之一来指定目录:
注: UNIX:如果在连接到 UNIX 机器上的 FTP 服务器时指定相对目录路径,请验证是否已针对连接到 FTP 服务器的用户帐户在 /etc/password 文件中正确指定了 FTP 主目录。
|
测试 | 在已命名文件字段中指定正则表达式并在目录字段中指定用以在 FTP 服务器上查找文件的目录后,单击测试以针对 FTP 服务器上指定目录中的文件集来测试该正则表达式。这样会出现对话框,其中将列出任何匹配文件。 |
类型 | 指定如何读入文件的内容 - 以二进制数据或编码文本形式。如果选择了文本选项,请使用下列选项之一设置编码类型:
注: 一些双字节字符未使用 SHIFT-JIS 编码进行转换。有关更多信息,请参阅使用 Shift-JIS 编码。
|
警告: 如果在以 ASCII 方式与 FTP 端点之间来回传输数据时针对操作文本数据的端点检索文本文件并将文本文件放置在 FTP 服务器上,那么必须为 FTP 活动指定“以文本 (ASCII) 方式传输”选项。例如,在以 ASCII 方式传递数据时,大型机和 DOS FTP 端点操作 ASCII 数据。例如,如果编排使用“FTP 轮询目录”活动来检索 ASCII 文件并使用“FTP 放置文件”活动将 ASCII 文件放置到大型机 FTP 服务器,那么必须在 Studio 内的下列任务中指定选项:
|
|
读取文件后 | 将其删除 - 读取文件后删除该文件。 移至目录 - 读取文件后将文件移至指定目录。 使用下列选项之一指定运行时期间将文件移至的目录:
|
注意: 在最后列出的目录名称后指定目录分隔符。例如,要将文件移至相对路径中的 processed/acme 目录,请在“移至目录”字段中指定以下目录:processed/acme/
可选 - 将文件重命名后指定文件名的格式。从模式下拉列表中选择所需模式。要指定用于分隔文件名中子字段的字符,请在模式分隔符字段中输入字符。
指定存在具有同一文件名的文件时的运行时行为:
注: FTP 轮询目录活动在运行时期间首次进行轮询时,如果因为指定的移动至目录不存在以致该活动无法移动文件,那么会在 Web 管理控制台 (WMC) 中记录警告(而不是错误),并且该文件将保持在原位置。对于所有后续轮询,该活动均不会尝试移动此同一文件,并且 WMC 中将记录信息级别的消息,该消息声明已对此文件进行处理。
保持位置不变 - 读取文件后将文件保留在输入目录中。 |
|
高级选项 | 描述 |
重复列表大小 | Integration Appliance 用于记录 FTP 服务器上已轮询或未轮询文件的内部列表的大小。缺省值为 10000。您应当仅指定大于缺省值的大小。 |
字段 | 描述 |
---|---|
重试 | |
1) 在前后两次重试之间等待 __ 秒。 | Integration Appliance 在尝试与 FTP 服务器建立连接之前等待的秒数。 |
2) 尝试连接 __ 次后失败。 | 指定重试计数 - Integration Appliance 在发出错误之前尝试与 FTP 服务器建立连接的最大次数。如果已部署以 FTP 轮询目录活动开始的编排,并且 Integration Appliance 无法连接到指定的 FTP 服务器,那么 Integration Appliance 会在系统日志中将连接错误记录为警告,直至达到重试计数值。在达到了重试计数时,Integration Appliance 会在系统日志中记录错误,将连接错误计数重置为零,并且继续尝试与 FTP 服务器建立连接。 例如,您将重试计数设置为 3。第一个、第二个和第三个连接错误在系统日志中显示为“警告”。Integration Appliance 将第四个连接错误记录为错误并将连接错误计数重置为零。因此,第五个连接错误会在系统日志中生成警告。Integration Appliance 会继续尝试与 FTP 服务器建立连接。 |
输出参数 | 描述 |
---|---|
文件名 | 提供 FTP 服务器上找到的文件的名称。 |
数据 | 提供文件的内容。 |
timestamp | 以 XML 模式 dataType 格式(YYYY-MM-DDhh:mm:ss,其中 YY 表示年,MM 表示月,DD 表示日,hh 表示时区,mm 表示分,ss 表示秒)的字符串形式提供日期和时间。 注: 如果 timestamp 输出参数在映射输出任务中进行映射,但是 MDTM(返回文件的修改时间)功能不可用或未对 FTP 服务器启用,那么在运行时期间,编排将会由于此错误而停止处理。这样会生成警告并在 timestamp 输出参数中返回 Epoch 日期 (1/1/1970)。
|