Oracle Integration Cloud（Gen3）：使用 FTP 触发器进行文件轮询

Source: Dev.to

在没有自定义调度器的情况下实现基于文件的自动化集成（OIC Gen3 24.10+）

基于文件的集成仍然非常常见——每日 CSV 提取、来自遗留系统的 XML 投递，或通过 FTP/SFTP 的批量合作伙伴数据。

在 Oracle Integration Cloud (OIC) Gen3 24.10 之前，文件到达时触发集成通常需要：

• 定时集成
• 外部脚本
• 自定义轮询逻辑

Gen3 引入了原生的文件轮询触发器，简化了一切。

何时使用文件轮询？

如果满足以下条件，请使用此功能：

• 文件大小为小到中等
• 希望在文件到达时立即触发
• 不需要手动下载文件的逻辑
• 偏好低代码、原生 OIC 模式

典型使用场景：

• 每日 CSV 或 XML 报表
• 轻量批量集成
• 合作伙伴文件投递
• 基于暂存区的数据摄取

OIC Gen3 24.10+ 的新特性

使用 FTP 文件轮询触发器，你可以：

• 文件到达时自动触发集成
• 使用文件名模式匹配文件
• 将文件内容直接加载为负载
• 控制归档、删除或拒绝的行为
• 避免额外的适配器或脚本

步骤指南：在 OIC 中配置文件轮询

1. 验证 OIC 版本

确保你的实例是 Oracle Integration Cloud Gen3 – 24.10 或更高。
文件轮询在早期 Gen3 版本中不可用。

2. 配置 FTP / SFTP 连接

创建或复用一个 Trigger & Invoke 角色的 FTP 适配器连接：

• 主机、端口、凭证
• 源目录权限
• 可选的归档/拒绝目录

在继续之前先测试连接。

3. 使用文件轮询触发器

在创建集成时：

1. 选择 FTP 适配器作为触发器。
2. 将触发类型设为 File Polling。

配置项：

• 轮询频率（例如每 5 分钟）
• 源目录
• 文件名模式（例如 *.csv）
• 模式类型（CSV / XML）

你可以上传示例文件生成模式，无需单独的文件读取步骤。

4. 配置文件处理行为

定义文件读取后的处理方式：

• 📦 归档 文件
• 🗑️ 删除 成功读取后的文件
• 🚫 拒绝 无效文件
• ⚠️ 忽略删除错误 以防重试

这些选项有助于实现幂等性和清理。

5. 设计集成流程

触发器之后：

• 使用生成的模式解析文件内容
• 将数据路由到下游系统
• 执行校验和转换
• 使用拒绝逻辑处理错误

文件内容已作为负载可用——无需手动流式读取。

6. 进行概念验证（POC）

投入生产前：

• 投放一个符合模式的测试文件。
• 确认集成能够立即触发。

验证内容：

• 文件移动（归档/删除）
• 负载解析
• 错误处理

7. 部署与监控

验证完成后：

• 激活集成。
• 通过跟踪页面监控文件运行情况。
• 如有需要，调整轮询频率或文件规则。