前置條件
- Oracle EBS 環境已部署 (如 11i/R12)。
- 下載 **JDeveloper 9.0.3.5 with Oracle Applications Extension** (OTN 需登錄 Oracle 帳號)。
- 客戶端 OS：Windows 7/10/11 (32/64 位均可，JDev 9i 為 32 位)。
目錄結構規劃 (無空格、無中文路徑)
D:\Java\jdev_oaf\
├── jdevbin\ # JDev 執行程式
├── jdevdoc\ # 開發文檔
└── jdevhome\ # OAF 工作區
└── jdev\
├── myhtml\OA_HTML\secure\ # DBC 文件放這裡
├── myprojects\ # 專案檔
└── jdev\bin\jdevw.exe # 啟動程式
環境變數配置
# 系統環境變數
JDEV_USER_HOME = D:\Java\jdev_oaf\jdevhome\jdev
DBC 文件獲取與部署
- EBS 登錄頁 → **功能管理員** → **驗證連接** → **定位 DBC 文件** 複製路徑。
- 複製該 `.dbc` 文件至 `D:\Java\jdev_oaf\jdevhome\jdev\myhtml\OA_HTML\secure\`。
- 關鍵修改：編輯 DBC 文件，**註釋掉 `APPS_JDBC_URL` 行** (前加 `#`)，否則 JDev 9i 解析報錯 (已知 Bug，需打補丁或註釋繞過)。
快捷方式建立
目標: D:\Java\jdev_oaf\jdevbin\jdev\bin\jdevw.exe
起始位置: D:\Java\jdev_oaf\jdevhome\jdev
EBS 職責授權 (開發用戶)
系統管理員 → 用戶 → 指派職責：
- `OA Framework ToolBox Tutorial` (鍵 `FWK_TBX_TUTORIAL`)
- `OA Framework ToolBox Tutorial Labs` (鍵 `FWK_TOOLBOX_TUTORIAL_LABS`)
JDev 專案配置 (ToolBox 範例)
- 打開 `D:\Java\jdev_oaf\jdevhome\jdev\myprojects\toolbox.jws`。
- 專案 `Tutorial.jpr` 右鍵 → **Project Settings** → **Oracle Applications** → **Runtime Connection**：
- Connection: 選擇上述 DBC 文件。
- Username/Password: 與 EBS 開發用戶一致。
- Responsibility: 保持預設。
- 同樣配置 `LabSolutions.jpr`。
資料庫連接配置 (Navigator 面板)
- Navigator → **Connections** → **Database** → 右鍵 **New Connection**。
- 填寫：連接名、用戶名/密碼、主機/端口/SID 或服務名 (Thin 模式)。
- 測試連接成功。
- 回到 `Tutorial.jpr` / `LabSolutions.jpr` Project Settings → **Connection Name** 選擇剛建立的連接。
常見問題排查
| 現象 | 原因 | 解決 |
|---|
| JDev 啟動報 `ClassNotFoundException` | JDK 版本不匹配 (JDev 9i 需 JDK 1.4.2/1.5) | 安裝對應 JDK 並配置 `SetJavaHome` 在 `jdev.conf` |
| DBC 解析錯誤 | `APPS_JDBC_URL` 格式含換行/轉義字元 | 註釋該行，或升級 JDev/打補丁 |
| 運行頁面報 `FND-XXXXX` | 職責/菜單/功能授權缺失 | 核對職責鍵值、菜單掛載、功能註冊 |
| 無法連接資料庫 | 防火牆/Listener/服務名錯誤 | `tnsping` 測試、檢查 `listener.ora`、`sqlnet.ora` |
結語
OAF 開發環境搭建核心在於 **JDev 版本精準匹配、DBC 文件正確部署與註釋修正、職責授權完整、專案連接配置一致** 四大支柱。建議將上述流程封裝為 **自動化安裝腳本 (PowerShell/Bat)**，新員工入職一鍵環境就緒。
