OAF 系列教程 二 HelloWorld

1.      文档概述

本节教程开始，将进行OAF开发教程的实践开发环节。从编程语言学习通用的Hello Wold开始，依次按照查询、新增、修改、删除的基础功能逐步进行。基础部分完成之后还会添加一些进阶的相关知识的教程学习。

本系列教程注重实际操作部分，不再对于原理性的知识做过多描述。按照本系列教程的步骤，基本保证开发软件安装及相关的环境信息配置正确的情况下，尽量确保相关的教程中的示例程序可以直接拿来运行(该系列教程完成之后对应的示例代码程序也会发布出来)。

学习本系列教程之前需要有一定的变成基础知识，主要是Java，其次还需要对数据库操作和SQL的基本操作有一定的了解，此部分知识不会再文档中进行介绍。

 

 

 

2.       实现Hello Wold

OAF开发的各个功能模块都属于OA PROJECT(OA工程)，OA工程文件的后缀为工程名称.jpr 。

而OA PROJECT又都必须隶属于某个OA WORKSPACES的工作空间下，OA WORKSPACES的后缀为工作空间名.jws。 因此在实际的开发中需要按照建立OA工作空间—》OA PROJECT的步骤来进行开发。

 

新建工作空间

打开开发工具，在Application视图窗口中的Application节点上点击鼠标右键，在弹出的菜单中选择 NEW OAWORKSPACE:

 

在弹出的窗口中就可以进行OAWORKSPACE的相关配置：

FILE NAME:中是新建工作空间的名字，根据自己需求来设置就可以了，本系列教程的工作空间命名为OAFLessons,相关示例OA工程均会建立在该空间下；

如果勾选“ADD a New OAProject”,则会在新建完成工作空间之后默认新建一个OA工程，此选项不是必选，后边新建完成工作空间之后也可以自己新增。

输完信息点击确定之后变回建立好了对应的工作空间。

说明：此处我们勾选上了“ADD aNew OA Project”，因此会默认直接创建一个OA PROJECT。

 

新OAPROJECT

一般新建OA PROJECT也是按照标准的引导界面一步步进行的：

直接下一步即可，在接下来的页面中便可以输入OA PROJECT的相关信息：

PROJECT NAME是对应的OA工程的名称，本系列教程均在oaflessons,为了便于理解，不在新建多个OA工程，不同的章节会对应不同的页面及CO，后期会添加明细说明；

DefaultPACKAGE：是工程的一个默认路径，后期建立AM、PG、CO、VO等等对象的时候均会基于该路径进行建立。

备注：OA的工程路径有一定的命名规则，具体如下：

公司名.oracle.apps.子模块.功能模块名

其中的，oracle.apps.子模块是固定的，区别只在于不同的子模块对应的子模块的简称不一致而已，公司名和功能模块名可以根据自己的实际情况进行设定。

本系列教程的默认路径为：

cux.oracle.apps.ak.oaflessons

 

使用AK模块主要是系统有自带的职责，以及Jdeveloper开发工具自带的教程也是在AK模块的对应职责下。

 

接下来需要进行数据库连接信息的配置：

勾选图中复选框，点击“NEW”按钮进行数据库信息的配置

输入数据库连接名称，类型默认即可，然后下一步：

输入对应的数据库用户和密码即可，接着下一步：

此处需要配置数据库连接的数据库地址信息、端口、数据库实例，根据实际需求进行配置即可，接着下一步：

到此基本完成数据库连接信息的配置，可以在该页面测试连接信息是否正确。

在刚才的新建OA 工程的界面选择数据库连接页面中，选择之前已经配置好的一个即可，上边的主要是为了说明如何新配置数据库连接:

接下来就需要配置相关的访问用户、职责及选择DBC文件了：

DBC FILE 按照上一篇教程中的进行配置，此处进行选择即可；

User NAME 此处的用户名和密码是前台登陆EBS系统的用户和密码

Responsibility:是对应的配置的用户的访问职责

(以上配置后边都可以进行修改)

 

到此就完成了工作空间和OA工程的建立。

 

新建AM

AM是OAF程序中的业务层组件，主要用于绑定EO、VO，页面也需要配置AM，否则无法运行，而且涉及到事务操作的话，都需要通过AM来获得相关的数据库连接信息。

 

接下来下一步即可进行创建AM的配置：

PACEAGKE：cux.oracle.apps.ak.oaflessons.server

AM必须位于对应功能模块的server路径下；

AM名称：OAFLessonAM

然后依次下一步，直到以下界面为止：

 

点击完成即可完成AM的创建

 

新建HelloWorld页面

O在OAFLesson工程上点击右键，选择“NEW”,然后选择OA Components中的Page:

 

然后输入页面名称和路径,点击确定即可完成页面的创建：

NAME：Helloworld

PACKAGE: cux.oracle.apps.ak.oaflessons.webui

OAF中的PAGE页面必须位于功能模块的webui路径之下

 

 

3.运行测试页面

 

如何运行

在创建的页面上点击鼠标右键，选择“RUN”即可运行页面

 

运行说明

创建完成PAGE之后并不能直接运行该页面，还需要配置AM和页面标题信息，否则运行会报错：

未配置AM及页面标题直接运行页面：

 

可以看到无法运行该页面，提示：

Error: Cannot run "Helloworld.region1" as a standalone component due to a missing property

  value. Please set "AM Definition" on this component.

 

 

因此，我们先要进行页面的AM和标题信息的配置，选中页面，在页面结构的导航窗口中选择页面下的第一个regionregion1,即页面的顶层region,然后即可在右边的属性窗口中看到页面相关的配置信息：

 

找到AM属性，进行选择配置即可：

 

然后在配置页面标题即可：

 

完成以上配置之后再次运行页面，可以在启动日志窗口中看到这次没有报错，而是正常启动了：

 

 

存在问题：

如果之前配置的登陆用户和配置的职责不匹配，则页面运行依然后报错：

 

此时修改之前的配置，或者给配置的用户添加对应的职责即可。

 

如何修改配置

a. 修改配置

选择项目，右键，选择“PROJECTPROPERTIES”

在弹出的窗口中选择“Oracle Application”中的 Run Time Connection配置信息：

 

到此便可以进行用户、DBC文件、职责的更改；

b.前台添加职责（此处不再描述）

 

完成职责的修改之后再次运行页面：

程序已经可以正常执行了

 

 

4. 附录

 

附录

a. 本系列教程为个人原创，基于实际工作中的使用情况及个人理解，以及参考Jdeveloper开发工具自带的参考文档所得，仅供学习交流之用，有不足之处还望批评指正，希望共同提高

b. 本系列教程的EBS及软件平台环境信息如下：

EBS版本：12.1

数据库：Oracle Database 11g

Jdeveloper：Oracle Jdeveloper10g

c. 参考文档：D:\EBSTools\jdevelopment\jdevdoc(工具自带)