OAF开发学习总结教程一 苏南生.doc

OAF开发学习总结 (一)环境的配置Author:苏南生Creation Date:July 27, 2014Document Ref: Version:DRAFT 1AApprovals: Copy Number_Document ControlChange Record3DateAuthorVersionChange Reference2014-7-27苏南生Draft 1aNo Previous DocumentReviewersNamePositionDistributionCopy No.NameLocation1Library MasterProject Library2Project Manager34Note To Holders:If you receive an electronic copy of this document and print it out, please write your name on the equivalent of the cover page, for document control purposes.If you receive a hard copy of this document, please write your name on the front cover, for document control purposes.Contents目录Document Controlii1.概述21.1. 总体说明21.2 附带网上的一段话22.开发工具的下载与安装32.1 EBS版本查看32.2 开发工具的获取32.3 JDeveloper的安装52.4 设置 JDEV_USER_HOME 环境变量52.5 获取数据库连接文件（DBC）52.6 分配 ToolBox 职责53.Toolbox Tutorials Release 12.1.373.1 概述73.2 启动 JDeveloper；并配置数据库连接和用户73.3 新建一个DATABASE连接83.4 测试设置94.OAF结构和组件概述114.1 整体结构114.2 Business Components Package114.3 Entity Object（以下简称EO124.4 Association（以下简称AO）124.5 View Object （以下简称VO）124.6 View Link （以下简称VL）124.7 Application Module（以下简称AM）124.8 Page134.9 Java 控制文件134.10 Region131.Open and Closed Issues for this Deliverable14Open Issues14Closed Issues14精品文档交流1.概述1.1. 总体说明OAF是Oracle Applications Framework的简称，目前主要应用于供应商门户网页的开发。它的开发工具是Jdeveloper，以Java 作为其主体开发语言。是Oracle 提供的基于HTML应用的开发和发布平台1.2 附带网上的一段话OAF是Oracle推出的一个基于JAVA框架，本身在JAVA领域并不流行（Java开发者更常用ssh这样的架框吧._）。但在EBS领域却相当*&*%*。如果你本身没有学习过J2EE，直接学习OAF的开发会是一件麻烦的事。由于企业级的JavaWeb开发，至少会涉及html、CSS、Javascript、JSP、Servlet、http协议、MVC等技术。OAF尝试一统所有技术，这样就造成OAF本身变得异常复杂啦（只不传导了一下复杂性而已！_）。尽管Oracle号称OAF是简化J2EE开发，但这只适合OracleEBS的开发人员。但对于OracleEBS二次开发人员来讲，掌握OAF与掌握SSH这样流行框架，并不会简化多少。2.开发工具的下载与安装2.1 EBS版本查看因为开发OAF所用的工具JDeveloper的版本要与EBS一一对应，因此下载工具前应该了解当前所使用的EBS是哪一个版本。对于11I以及12.0.X版本，可以直接在浏览器中输入http:/:/OA_HTML/OAInfo.jsp即可；针对12.1.X版本，需要登录进EBS，点击页面左下角关于此页，在Technology Components页签下可以看到版本信息2.2 开发工具的获取当您创建电子商务OA框架页面的扩展时，你必须使用电子商务产品团队提供的JDeveloper版本。JDeveloper版本特定于ATG的补丁级别，因此对于每一个ATG的补丁集都有一个新的JDeveloper与之对应。这篇文档给出了在创建电子商务11i版和12.x版的OA扩展时如何找到正确的JDeveloper补丁. 补丁对应的官方文档ID:文档 ID 1534686.1补丁下载地址：/epmos/faces/DocumentDisplay?_afrLoop=794282182840541&id=1534686.1&_afrWindowMode=0&_adf.ctrl-state=1awmp50fyy_235为了便于大家下载，我已经上传了R12.1.3版本的对应开发工具（Patch 987998910G JDEVELOPER WITH OA EXTENSION ARU FOR R12.1.3）到网盘上下载地址： /s/1eQw1RMU2.3 JDeveloper的安装下载下来的压缩包，不用安装，直接解压就可以了。解压完后，我们得到jdevbin、jdevdoc、jdevhome三个目录。关于目录的介绍：2.4 设置 JDEV_USER_HOME 环境变量选择我的电脑，右键选择 属性点击“高级系统设置”进入“高级”标签页 “环境变量”新建变量名：JDEV_USER_HOME变量值：F:Oracle_prgp9879989_R12_GENERICjdevhomejdev2.5 获取数据库连接文件（DBC）通过系统管理员获取数据库连接（DBC）文件，将 dbc 文件放到此目录下： dbc_filessecure注：DBC文件位于应用服务器下 /secure/2.6 分配 ToolBox 职责分配下列的职责给一个测试用户。如果需要知道如何创建一个用户并分配职责，请参考 Oracle Applications System Administrators Guide 1 OA Framework ToolBox Tutorial (职责关键字： FWK_TBX_TUTORIAL) 2 OA Framework ToolBox Tutorial Labs (职责关键字： FWK_TOOLBOX_TUTORIAL_LABS)对应的中文名称及添加完职责后：这两个职责是为了以后测试我们的工程使用的，所以一定要添加职责，否则后面运行程序会报错。3.Toolbox Tutorials Release 概述ToolBox 指南向开发人员介绍了如何结合 Oracle Applications Framework Developers Guide 手册所讲解的各项功能来创建 OA Framework 应用，提供了创建应用的示例代码和简便的实验室，整个实验室根据自学和指导学习分成了两种类别：1 核心课程必须的课程，讲述了开发OAF应用程序需要的最基本的功能2 补充课程可选的课程，讲述了开发OAF应用程序中所使用到的一些特别功能或者高级功能，如：弹性域、个性化、图表和图形及扩展 OAF 的现有功能3.2 启动 JDeveloper；并配置数据库连接和用户1 启动JDeveloper2 选择 File Open 打开 OA Framework ToolBox Tutorial 工作台。导航到目录 myprojects ，打开文件 toolbox.jws 3 在系统导航栏中，展开 toolbox.jws 显示其中的内容。选择 Tutorial.jpr 项目，然后选择 Project Project Settings 4 在 Project Settings 对话框中，展开 Oracle Applications 节点，选择 Runtime Connection 项5 使用 Browse 按钮选择在任务2种保存的 DBC 文件，此文件必须保存在 dbc_filessecure 目录下6 将已指定 ToolBox 职责的用户和密码输入对应位置 3.3 新建一个DATABASE连接点开左边导航栏的Connections，右击其下的Database，选择New Connection，出现如下的欢迎界面为数据库连接起一个名字，连接类型使用默认的JDBC连接输入数据库连接的用户名和密码，使用normal进行连接Driver 类型选择默认的thin ，输入主机名、端口号和SID 。这样就配置完成了，进入下一步后点击“test ”，应该就会如愿以偿的看到“success”字样。3.4 测试设置1 在系统导航栏中选择 toolbox.jws ，并从主菜单中选择 Project Rebuild toolbox.jws 重新编译整个工作台中的项目，必须保证没有任何的错误（警告信息无所谓） 2 展开 toolbox.jws 项目找到 test_fwktutorial.jsp ，通过主菜单选择 Run Run test_fwktutorial.jsp 运行3. 如果浏览器显示出如下页面，代表环境配置正确4. 点击Hellow，world！进行OAF页面的测试4.OAF结构和组件概述4.1 整体结构OAF的整体结构如下图：其中（1 ）是根目录（工作台WORKSPACES）。OAF中组件较多，一定要遵从命名规范，才可以方便的进行开发和维护。下面分别对这些组件进行说明。4.2 Business Components Package这是OAF中的实物组件包，如图中的（4 ）所示。这儿有三个包： oracle.apps.ak.lov.server oracle.apps.ak.schema.server oracle.apps.ak.wydeliverybillstatus.server 其中oracle.apps.ak.lov.server 是值列表所在的包，这里面包含了所有值列表页面、值列表VO视图、值列表AM应用模板、值列表java 控制文件。它的文件夹位置就在ak目录下，创建于你的第一个OAF项目。在以后的OAF项目中要用到值列表时只需import导入此值列表的包就行，无需再次建立值列表包。 oracle.apps.ak.schema.server 是实体对象EO（图中的（5 ）和实体联系对象AO（图中的（6 ）所在的包，它同值列表包一样，位置在ak目录下，创建于第一个项目，以后只需引入就可以了。它和值列表里面的组件是所有项目可以共用的。 oracle.apps.ak.wydeliverybillstatus.server 就是你本个项目的私有组件所在的包了，它包含这个项目的AM应用模板（图中（9 ）、V O视图对象（图中的（7 ）和VL(VIEW LINK)视图联系对象（图中的（8 ）。4.3 Entity Object（以下简称EOEO是OAF的实体对象（图中的（5 ），它是基于数据库中的表、视图和同义词这些基本对象的。一个EO对应一个基本对象（就如同FORM 中的BLOCK一样）。OAF中的操作对象是EO，而不是直接面向数据库中的表或视图。建立的实体对象都以*EO命名。4.4 Association（以下简称AO）AO是OAF中的实体联系对象，它将两个EO联系起来。例如PoHeaderEO 是基于表PO_H EADERS_ALL建立的实体对象，PoLineEO是基于表PO_LINES_ALL建立的实体对象，那么就可以建立一个PoHeaderToLineAO将二者联系起来，关系栏位就是po_header_id。这样做是为以后建立基于PoHeaderEO 和PoLineEO的VO视图对象做准备的。4.5 View Object （以下简称VO）VO是OAF中的视图对象（图中的（7 ）。OAF中的所有数据都来自视图对象。视图对象主要分两种：基于EO实体对象的、基于SQL 查询的。 基于EO实体对象的VO主要应用于需要对VO中的数据进行查询、新增、修改和删除操作的情况。 基于SQL 查询的VO主要用于只进行查询的情况。4.6 View Link （以下简称VL）VL是OAF中VO的联系对象，用于主从视图对象的联系。（如图中的（8 ）。4.7 Application Module（以下简称AM）AM是OAF中的应用模板（图1.5中的（9 ）。此项目中所有用到的VO都要添加到模板中，然后再将模板应用到OAF页面中。AM是VO和OAF页面的联系体，起一个桥梁的作用。4.8 PagePage是OAF的可见实体。它是用户在应用中能看到页面。它在包oracle.apps.ak.wydeliverybillstatus.webui下。（图1.5中的（10）4.9 Java 控制文件它是Page中的逻辑控制代码文件，里面是Java 代码。（图1.5中的（11）4.10 Region它主要用于值列表。在值列表中它充当弹出框的角色，同FORM 中的LOV。1. Open and Closed Issues for this DeliverableAdd open issues that you identify while writing or reviewing this document to the open issues section. As you resolve issues, move t