OracleOAF开发指南第一章翻译（中文）-(1)

1.       说明

 

此手册适用于Oracle EBS r12下的OAF开发。 

 

OAF是Oracle Application Framework的简写。 

 

下面的5856648的patch包名称为：Jdeveloper with OA Extension。 

 

在R12中，OAF的开发也不在像11.5.10中，是基于Oracle Jdeveloper9.0.3版本上，而是升级到了新的Oracle Jdeveloper10g上了。Metalink上OAF的Patch Number：5856648。下载p5856648_R12_GENERIC.zip即可。本文档中默认解压到E盘根目录下。下载解压后p5856648_R12_GENERIC文件夹下有三个目录：jdevbin、jdevdoc、jdevhome，其中jdevbin中是jdeveloper10g with OA Extension的程序文件和OAF的类库，jdevdoc中存放Javadoc手册和OAF培训文档，jdevhome存放oaf用户文件和虚拟的oaf环境。  

 

Jdevdoc目录下的文档结构如下：

 

      E:/p5856648_R12_GENERIC/jdevdoc/index.htm  打开教程文档 

      E:/p5856648_R12_GENERIC/jdevdoc/javadoc/fwk/public/index.html 包含OA Framework Javadoc 

      E:/p5856648_R12_GENERIC/jdevdoc/javadoc/aolj/index.html 包含AOL/J的Javadoc

注：AOL/J类似于Form平台下的AOL，其实现方式升级为Java。 

 

E:/p5856648_R12_GENERIC/jdevdoc/javadoc/bc4j/index.html 包含BC4J的Javadoc  

注：BC4J为Business Component for java的简写。 

 

E:/p5856648_R12_GENERIC/jdevdoc/javadoc/uix/index.html 包含UIX的Javadoc 

注：UIX为UI extended的简写。 

 

E:/p5856648_R12_GENERIC/jdevdoc/javadoc/jdbc/index.html 包含Oracle JDBC API Reference的Javadoc。 

E:/p5856648_R12_GENERIC/jdevdoc/WebHelp/devguide/devguide.htm 包含OAF的开发指南。 

E:/p5856648_R12_GENERIC/jdevdoc/WebHelp/persguide 包含OAF个性化指南。 

E:/p5856648_R12_GENERIC/jdevdoc/WebHelp/toolbox 包含OAF 官方实例教程。

 

2.       建立开发环境

2.1.   设置环境变量

 

 

在Windows2000/XP环境下配置环境变量JDEV_USER_HOME。 

 

右键点击“我的电脑”，选择“属性”，选择“系统属性”，“高级”标签页

 

 

 

选择“环境变量”，在打开的对话框中，从“用户变量…”选择“新建”，新建“JDEV_USER_HOME”，变量值为"E:/p5856648_R12_GENERIC/jdevhome/jdev"。

 

在这里，我教大家一种命令行建永久环境变量的方法：<原创>

setx JDEV_USER_HOME E:/p5856648_R12_GENERIC/jdevhome/jdev

 

2.2.   获取数据库连接文件

 

从需要做开发的R12环境上取得FND dbc文件，登录后，切换到应用用户下，并到路径$FND_SECURE下，依据SID取得.dbc文件，并将其下载到本地，放置到E:/p5856648_R12_GENERIC/jdevhome/jdev/dbc_files/secure目录下。在192.168.1.200服务器上的路径是/u01/vis/inst/apps/VIS_www/appl/fnd/12.0.0/secure/VIS.dbc

 

2.3.   在桌面生成Jdeveloper快捷方式

 

E:/p5856648_R12_GENERIC/jdevbin/jdeveloper.exe右键，选择“创建快捷方式”，并将改快捷方式放置到桌面。

 

2.4.   设定例程Toolbox的职责

 

在R12中新建一个应用用户或使用已有的用户，将职责OA Framework ToolBox Tutorial（职责关键字：FWK_TBX_TUTORIAL）和OA Framework Toolbox Tutorial Labs（职责关键字：FWK_TOOLBOX_TUTORIAL_LABS）指定给该用户，比如fwktester。

 

2.5.   运行Jdeveloper，设置数据库连接和用户

双击桌面快捷方式，运行Jdeveloper。在Jdeveloper中选择菜单File>Open，打开<JDEV_USER_HOME>/myprojects下的toolbox.jws。
在Jdeveloper中的Application Navigator中展开toolbox.jws，选择Tutorial.jpr，选择菜单Tools>Project Properties…，或者在其上右键选择Project Properties…，在弹出的Project Properities对话框中展开Oracle Application节点，选择Runtime Connection，配置DBC File Name，将其指向刚才从应用服务器上下载的.dbc文件，用户名和密码填前面指定了相应职责的用户的信息。Responsibility中Application Short Name和Responsibility Key分别配置为ICX和FWK_TBX_TUTORIAL（如果，运行测试不行，可以改成DEM和FWK_TOOLBOX_TUTORIAL_LABS试试），与指定到该用户的职责的属性相对应。
从这里可以看出，OAF的开发比FORM开发与应用层的联系更加紧密，一个projects均与应用环境中的一个职责。使用该OAF功能的用户必须具有相应的职责。
完成以上设置后，再对LabSolution.jpr进行相同的设置。
再点击Jdeveloper中System Navigator中的Connections标签页，右键Database节点，选择New Database Connection…，为该project新建一个数据库连接，该连接必须与应用和前面下载的dbc文件中指向的数据库相对应。
在Tutorial.jpr上右键，选择Business Components节点，设置Business Components的Connection属性。
对LabSolutions.jpr属性也做相同配置。

2.6.   测试配置，运行例子程序

在Jdeveloper中打开toolbox.jws，选择Run>Rebuild toolbox.jws，或者直接在toolobx.jws上右键选择Rebuild。应该得到0 errors。
展开Tutorial.jpr下的Web Content文件夹，选定test_fwktutorial.jsp，选择Run>Run test_fwktutorial.jsp。
Linux环境下开发环境的配置略，请参考OAF官方开发指南。