OracleEBS R12-OAF开发笔记

### OracleEBS R12-OAF开发笔记 #### 前言 Oracle E-Business Suite (EBS) R12 的 OAF (Oracle Applications Framework) 是一个强大的开发框架，用于构建高度可定制的企业应用程序。本笔记由 JarWang（王重东）编写，主要涵盖了从环境搭建到实际应用开发的一系列步骤与技巧。 #### 开始指南 ##### 下载 JDeveloper JDeveloper 是 Oracle 提供的一个集成开发环境，是进行 OAF 开发的基础工具。 ##### 配置 JDeveloper 安装完成后，需要对 JDeveloper 进行必要的配置，以便更好地支持 OAF 开发。这包括设置工作空间、导入必要的库文件等。 ##### 配置 EBS-OAF 环境 1. **创建数据库连接**：在 JDeveloper 中添加与 Oracle EBS 数据库的连接。 2. **安装必需组件**：确保环境中已经安装了所有必需的 Oracle 组件，例如 Oracle WebLogic Server。 3. **配置 OAF 插件**：如果使用的是插件版 JDeveloper，则需安装并启用 OAF 插件。 ##### 验证 EBS-OAF 环境 完成配置后，应通过创建简单的示例项目来验证环境是否正确搭建。 #### OAF 概念 ##### OAF 与 ADF OAF 和 ADF (Application Development Framework) 在某些方面有交集，但在功能定位上有所不同。OAF 主要针对 EBS 平台，而 ADF 更加通用。 ##### OAF 对象概念 - **EO (Entity Object)**：代表数据库中的实体，如表或视图。 - **VO (View Object)**：用于检索和操作数据，常用于显示列表或表格中的数据。 - **AM (Application Module)**：控制业务逻辑的核心对象，协调 EO 和 VO 的交互。 - **VO Collection**：一组 VO 的集合，通常用于复杂的数据结构。 - **Page (页面)**：用户界面元素的容器，包含各种组件如表格、输入框等。 - **CO (Component Object)**：页面上的控件，负责页面上组件的行为和事件处理。 ##### OAF 对象命名规则 命名规则对于代码的可读性和维护性至关重要。OAF 对象应遵循一定的命名约定，比如使用有意义的缩写，以及区分不同类型的对象。 ##### JSR 168 与 JSR 227 - **JSR 168**：定义了 Portlet API，允许开发者创建可以在不同门户服务器间共享的 Portlet 应用程序。 - **JSR 227**：也称为 Portlet 2.0 规范，扩展了 JSR 168 的功能，增加了更多特性如生命周期管理、安全模型等。 #### OAF 开发实践 ##### OAF 导入 Excel 示例 本节介绍如何创建一个简单的项目，实现将 Excel 文件中的数据导入到 Oracle EBS 中的功能。 1. **创建 OA 项目**：在 JDeveloper 中新建一个 OA 项目。 2. **设置运行选项**：在项目设置中配置运行选项。 3. **创建 DataTable**：为 Excel 文件中的数据创建对应的 DataTable。 4. **创建 AM 对象**：定义用于控制业务逻辑的 AM 对象。 5. **创建 VO 对象**：创建用于检索和操作数据的 VO 对象。 6. **将 VO 添加到 AM**：在 AM 中引用 VO，以便进行数据交互。 7. **创建页面**：设计用户界面，包括表单、按钮等组件。 8. **安装三十个 Jar 包**：导入项目所需的第三方库。 9. **创建 Java 类**：编写用于处理 Excel 文件的 Java 类。 10. **创建 CO 对象**：为页面上的控件创建 CO 对象。 11. **在 AM 中添加方法**：实现业务逻辑所需的方法。 12. **运行项目**：测试项目功能。 #### 部署 OAF 完成开发后，还需要将项目部署到生产环境中。这包括打包、配置服务器环境等步骤。 #### OAF-OA Train Bean 实践 本节介绍如何创建一个复杂的 OA Train Bean 示例，包括多级数据结构的处理。 1. **创建 DataTable**：为不同的数据层创建 DataTable。 2. **创建 EO 对象**：分别为 Header 和 Lines 创建 EO 对象。 3. **创建 AO 对象**：定义 AO 对象来控制整个数据结构的逻辑。 4. **创建 VO 对象**：分别为 Header 和 Lines 创建 VO 对象。 5. **创建 VL 对象**：创建用于管理 VO 集合的 VL 对象。 6. **创建 AM 对象**：定义 AM 对象来协调 EO、VO、VL 的交互。 7. **将 VO 对象添加到 AM**：在 AM 中引用 VO 和 VL，以便进行数据交互。 8. **为 Header 创建页面**：设计 Header 页面。 9. **为 Header 创建 CO 对象**：定义页面上控件的行为。 10. **为 Lines 创建页面**：设计 Lines 页面。 11. **为 Lines 添加方法**：实现 Lines 的业务逻辑。 12. **为 Lines 创建 CO 对象**：定义 Lines 页面上控件的行为。 13. **实现货币下拉列表**：为 Lines 页面添加货币选择功能。 14. **为 Lines 添加表格按钮**：增加表格操作的灵活性。 15. **为 Lines 运行项目**：测试 Lines 功能。 16. **创建预览 VO**：为预览功能创建 VO。 17. **为预览创建页面**：设计预览页面。 18. **为预览创建 CO 对象**：定义预览页面上控件的行为。 19. **为预览运行项目**：测试预览功能。 20. **创建 OA Train**：将各个部分整合在一起。 21. **向 PG 添加 OA Train**：将 OA Train 添加到页面。 22. **添加页面按钮**：增加页面操作的便捷性。 #### OAF-OA Tree 实践 本节介绍如何创建一个 OA Tree 示例。 1. **创建 OA 项目**：在 JDeveloper 中新建一个 OA 项目。 2. **创建 DataTable**：为树状结构中的节点创建 DataTable。 3. **创建 VO 对象**：创建用于检索和操作数据的 VO 对象。 4. **创建 AM 对象**：定义用于控制业务逻辑的 AM 对象。 5. **创建 VL 对象**：创建用于管理 VO 集合的 VL 对象。 6. **创建页面**：设计用户界面，包括树状结构的展示。 7. **创建 CO 对象**：为页面上的控件创建 CO 对象。 8. **运行项目**：测试项目功能。 #### OAF 个性化 除了以上内容外，还可以探索如何对 OAF 应用进行个性化设置，以满足特定业务需求。这包括自定义样式、调整布局等功能。 总结起来，OracleEBS R12-OAF 的开发涵盖了从环境搭建到具体功能实现的多个方面。通过上述笔记，开发者可以系统地了解 OAF 的基本概念和开发流程，并掌握如何构建高效稳定的应用程序。希望这些知识点能够帮助你在 OracleEBS R12-OAF 开发过程中取得成功。