Android开发者：如何开发API获取Oracle EBS并发程序生成的PDF URL？

这个方案完全可行。Oracle EBS提供了成熟的接口能力来调用并发程序、获取输出文件，你只需要开发一个中间层API对接这些能力，就能让Android应用拿到同款PF ledger PDF的访问URL。

一、先搞定Oracle EBS端的准备 #

• 明确并发程序的核心信息
  先摸清楚目标并发程序的内部短名（比如XX_PF_LEDGER_REPORT）、必填输入参数（比如员工ID、报表时间段），以及调用该程序需要的EBS用户权限——得确保用来调用的EBS账号有提交这个并发程序的职责权限。
• 配置输出存储的可访问性
  默认情况下，EBS并发程序的PDF输出会存在数据库的FND_LOBS表或者指定的文件系统里。你需要确保这些输出能通过HTTP访问：要么把输出目录映射到Web服务器，要么后续API读取数据库LOB后转存到可访问的位置。
• 可选：启用并发程序的Web服务
  如果倾向用SOAP/REST方式调用，EBS自带的Concurrent Program Web Service可以直接暴露并发程序的调用能力，不过用PL/SQL API会更轻量直接。

二、开发中间层API的核心逻辑 #

API要完成这几步关键操作：

1. 接收Android端的请求参数
   把Android传过来的员工ID、时间段等参数，和EBS并发程序的输入参数一一对应好。
2. 提交EBS并发请求
   推荐用PL/SQL API直接调用，示例代码如下：

DECLARE
  l_request_id NUMBER;
BEGIN
  l_request_id := FND_REQUEST.SUBMIT_REQUEST(
    application => 'XXCUST', -- 并发程序所属应用短名
    program     => 'XX_PF_LEDGER_REPORT', -- 并发程序短名
    description => 'Android端请求的PF Ledger报表',
    start_time  => SYSDATE,
    sub_request => FALSE,
    argument1   => '12345', -- 员工ID参数
    argument2   => '01-JAN-2024', -- 报表起始日期
    argument3   => '31-JAN-2024' -- 报表结束日期
  );
  COMMIT;
  DBMS_OUTPUT.PUT_LINE('生成的请求ID: ' || l_request_id);
END;

如果用Web Service方式，直接构造SOAP请求传入参数即可，返回结果里会包含请求ID。
3. 轮询请求状态
提交请求后，要定期查询FND_CONCURRENT_REQUESTS表的PHASE_CODE和STATUS_CODE字段，直到请求完成——当PHASE_CODE='C'且STATUS_CODE='C'时，说明报表生成成功。
4. 生成PDF的访问URL

• 如果输出存在数据库LOB中：读取FND_LOBS表的FILE_DATA字段，把二进制数据写入到API服务器的可访问目录（比如/var/www/pdfs/），然后拼接成HTTP URL（比如https://your-api.com/pdfs/pf_ledger_12345.pdf）。
• 如果输出已经在可访问的文件系统：直接从FND_CONCURRENT_REQUESTS的OUTPUT_FILE_NAME字段拿路径，补全域名就是完整URL。

5. 返回结果给Android
   用JSON格式返回，示例如下：

{
  "success": true,
  "pdf_url": "https://your-api.com/pdfs/pf_ledger_12345.pdf",
  "request_id": 123456
}

三、Android端的对接要点 #

• 调用API时传入正确的报表参数，做好参数校验。
• 拿到PDF URL后，用OkHttp之类的网络库下载文件，或者直接用WebView打开预览。
• 处理异常情况：比如并发请求失败、API返回错误时，给用户清晰的提示（比如“报表生成失败，请稍后重试”）。

四、需要注意的细节 #

• 权限管控：API必须加身份验证（比如API Key、OAuth2），防止未授权调用EBS的并发程序。
• 异步处理：如果报表生成耗时较长，API可以先返回请求ID，让Android端轮询API获取状态和最终的PDF URL，避免长时间阻塞请求。
• 文件清理：定期清理API服务器上的旧PDF文件，别占满存储空间。
• 版本兼容：不同EBS版本（比如R12.1和R12.2）的并发程序API和输出存储逻辑可能有细微差别，要根据你们的实际版本调整代码。

内容的提问来源于stack exchange，提问作者Habibur Rahman