文档目录
1.概述 2
1.1. 总体说明 2
1.2 附带网上的一段话 2
2.开发工具的下载与安装 3
2.1 EBS版本查看 3
2.2 开发工具的获取 3
2.3 JDeveloper的安装 5
2.4 设置 JDEV_USER_HOME 环境变量 5
2.5 获取数据库连接文件（DBC） 5
2.6 分配 ToolBox 职责 5
3.Toolbox Tutorials Release 12.1.3 7
3.1 概述 7
3.2 启动 JDeveloper并配置数据库连接和用户 7
3.3 新建一个DATABASE连接 8
3.4 测试设置 9
4.OAF结构和组件概述 11
4.1 整体结构 11
4.2 Business Components Package 11
4.3 Entity Object（以下简称EO 12
4.4 Association（以下简称AO） 12
4.5 View Object （以下简称VO） 12
4.6 View Link （以下简称VL） 12
4.7 Application Module（以下简称AM） 12
4.8 Page 13
4.9 Java 控制文件 13
4.10 Region 13
文档地址
http://wenku.baidu.com/view/bef59c7c3169a4517623a307
正文
备注：图片无法显示，请到文库查看
本文地址：http://wenku.baidu.com/view/bef59c7c3169a4517623a307
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://<host_name>:<port_number>/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
为了便于大家下载，我已经上传了R12.1.3版本的对应开发工具（Patch 9879989 10G JDEVELOPER WITH OA EXTENSION ARU FOR R12.1.3）到网盘上
下载地址：
http://pan.baidu.com/s/1eQw1RMU
下载下来的压缩包，不用安装，直接解压就可以了。
解压完后，我们得到jdevbin、jdevdoc、jdevhome三个目录。
<特别注意：解压的目录不能含有空格、中文等。如：解压到C:\Program Files就不行啦。>
关于目录的介绍：
2.4 设置 JDEV_USER_HOME 环境变量
选择我的电脑，右键选择 属性
点击“高级系统设置”
进入“高级”标签页 – “环境变量”
新建变量名：JDEV_USER_HOME
变量值：[F:\Oracle_prg\p9879989_R12_GENERIC]\jdevhome\jdev
2.5 获取数据库连接文件（DBC）
通过系统管理员获取数据库连接（DBC）文件，将 dbc 文件放到此目录下：
<JDEV_USER_HOME>\ dbc_files\secure
注：DBC文件位于应用服务器下 <FND_SECURE>/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.1 概述
ToolBox 指南向开发人员介绍了如何结合 Oracle Applications Framework Developer's Guide 手册所讲解的各项功能来创建 OA Framework 应用，提供了创建应用的示例代码和简便的实验室，整个实验室根据自学和指导学习分成了两种类别：
1． 核心课程 必须的课程，讲述了开发OAF应用程序需要的最基本的功能
2． 补充课程 可选的课程，讲述了开发OAF应用程序中所使用到的一些特别功能或者高级功能，如：弹性域、个性化、图表和图形及扩展 OAF 的现有功能
3.2 启动 JDeveloper；并配置数据库连接和用户
1． 启动JDeveloper
2． 选择 File > Open 打开 OA Framework ToolBox Tutorial 工作台。导航到目录 <JDEV_USER_HOME>\myprojects ，打开文件 toolbox.jws
3． 在系统导航栏中，展开 toolbox.jws 显示其中的内容。选择 Tutorial.jpr 项目，然后选择 Project > Project Settings
4． 在 Project Settings 对话框中，展开 Oracle Applications 节点，选择 Runtime Connection 项
5． 使用 Browse… 按钮选择在任务2种保存的 DBC 文件，此文件必须保存在 <JDEV_USER_HOME>\dbc_files\secure 目录下
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中组件较多，一定要遵从命名规范，才可以方便的进行开发和维护。下面分别对这些组件进行说明。
这是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（以下简称EO
EO是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页面的联系体，起一个桥梁
的作用。
Page是OAF的可见实体。它是用户在应用中能看到页面。它在包
oracle.apps.ak.wydeliverybillstatus.webui下。（图1.5中的（10））
4.9 Java 控制文件
它是Page中的逻辑控制代码文件，里面是Java 代码。（图1.5中的（11））
它主要用于值列表。在值列表中它充当弹出框的角色，同FORM 中的LOV。