Oracle EBS OAF 開發環境配置全攻略：JDev 9.0.3.5 安裝與連接實戰

前言

Oracle E-Business Suite (EBS) 的 OA Framework (OAF) 開發需使用特定版本的 JDeveloper（JDev 9.0.3.5 with OA Extension）。本文詳述從下載、解壓、環境變量、數據庫連接（.dbc 文件）、工作區配置到職責分配的完整配置流程，並針對常見 APPS_JDBC_URL 配置錯誤給出規避方案。

環境準備

• 下載：JDev 9.0.3.5 with Oracle Applications Extension（OTN 或 Metalink）
• 解壓目錄：D:\Java\jdev_oaf（路徑不含空格）
• 目錄結構：
  • jdevbin - JDev 執行程序
  • jdevdoc - 開發文檔
  • jdevhome - OAF 工作目錄

配置步驟

1. 設置環境變量 JDEV_USER_HOME

變量值：D:\Java\jdev_oaf\jdevhome\jdev

2. 配置數據庫連接文件 (.dbc)

從 EBS 應用層 $FND_TOP/secure 或 Web 界面「Connection Test」頁面獲取 .dbc 文件，放入：

D:\Java\jdev_oaf\jdevhome\jdev\myhtml\OA_Html\secure

關鍵參數說明：

• APPS_JDBC_URL：JDBC Thin 連接串（含主機、端口、SID/Service Name）
• GWYUID：APPLSYSPUB/PUB（網關用戶）
• FNDNAM：APPS（應用短名）
• DB_HOST、DB_PORT、DB_NAME、TWO_TASK

3. 關鍵避坑：註釋 APPS_JDBC_URL

該參數在某些版本中會導致啟動報錯（已知 Bug，需補丁）。臨時解決：在 .dbc 文件中該行前加 # 註釋：

#APPS_JDBC_URL=jdbc:oracle:thin:@(DESCRIPTION=...)

4. 創建 JDev 啟動快捷方式

目標：D:\Java\jdev_oaf\jdevbin\jdev\bin\jdevw.exe

5. 分配 OAF 開發職責

在系統管理員職責中為開發用戶分配：

• OA Framework ToolBox Tutorial (Key: FWK_TBX_TUTORIAL)
• OA Framework ToolBox Tutorial Labs (Key: FWK_TOOLBOX_TUTORIAL_LABS)

6. 配置 JDev 專案數據庫連接

1. 打開工作區 D:\Java\jdev_oaf\jdevhome\jdev\myprojects\toolbox.jws
2. 右鍵專案 Tutorial.jpr → Project Settings → Oracle Applications → Runtime Connection，選擇上述 .dbc 文件
3. 用戶名/密碼與步驟 5 一致，職責保持默認
4. 同樣配置 LabSolutions.jpr
5. Navigator → Connections → Database 新增數據庫連接，並在兩個專案的 Project Settings → Connection 中指定該連接名

驗證與常見問題

• 啟動 JDev，打開 toolbox.jws，編譯運行無誤即配置成功。
• 若連接失敗，檢查 .dbc 中 HOST/PORT/SID、防火牆、TNSNAMES.ORA。
• 類路徑缺失：確認 JDEV_USER_HOME 指向正確，且 jdevhome/jdev 下有 myclasses、myprojects 等目錄。

總結

OAF 開發環境配置的核心在於「正確的 JDev 版本 + 正確的 .dbc 文件 + 工作區專案綁定連接」。掌握上述流程，可快速搭建穩定的 EBS 二次開發環境。