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

OAF开发学习总结 (一) 环境的配置

Author: Creation Date: Document Ref: Version:

Approvals:

苏南生 July 27, 2014

DRAFT 1A

Copy Number _____

OAF开发学习总结

Doc Ref:

July 27, 2014

Document Control

Change Record

3

Date Author Version Change Reference 2014-7-27 苏南生 Draft 1a No Previous Document

Reviewers

Name Position

Distribution

Copy No. Name Location 1 2 3 4 Library Master Project Library Project Manager

Note 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.

开发环境配置

File Ref: Oracle Application Framework Personalization Guide 12.1.3

Company Confidential - For internal use only

Document Control ii

OAF开发学习总结

Doc Ref:

July 27, 2014

Contents

目录

Document Control .................................................................................................................. ii 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

1. Open and Closed Issues for this Deliverable ...................................................... 14 Open Issues ..................................................................................................................... 14 Closed Issues .................................................................................................................. 14

开发环境配置

File Ref: Oracle Application Framework Personalization Guide 12.1.3

Company Confidential - For internal use only

Document Control iii

OAF开发学习总结

Doc Ref:

July 27, 2014

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这样流行框架，并不会简化多少。

开发环境配置

File Ref: Oracle Application Framework Personalization Guide 12.1.3

Company Confidential - For internal use only

1.概述 2 of 16

OAF开发学习总结

Doc Ref:

July 27, 2014

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与之对应。

开发环境配置

File Ref: Oracle Application Framework Personalization Guide 12.1.3

Company Confidential - For internal use only

2.开发工具的下载与安装 3 of 16

OAF开发学习总结

Doc Ref:

July 27, 2014

这篇文档给出了在创建电子商务11i版和12.x版的OA扩展时如何找到正确的JDeveloper补丁.

补丁对应的官方文档ID:

文档 ID 1534686.1

补丁下载地址：

https://support.oracle.com/epmos/faces/DocumentDisplay?_afrLoop=794282182840541&id=1534686.1&_afrWindowMode=0&_adf.ctrl-state=1awmp50fyy_235

为了便于大家下载，我已经上传了R12.1.3版本的对应开发工具（Patch 9879989 10G JDEVELOPER WITH OA EXTENSION ARU FOR R12.1.3）到网盘上 下载地址：

http://pan.http://www.wodefanwen.com//s/1eQw1RMU

开发环境配置

File Ref: Oracle Application Framework Personalization Guide 12.1.3

Company Confidential - For internal use only

2.开发工具的下载与安装 4 of 16

OAF开发学习总结

Doc Ref:

July 27, 2014

2.3 JDeveloper的安装

下载下来的压缩包，不用安装，直接解压就可以了。

解压完后，我们得到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 文件放到此目录下： \\ dbc_files\\secure

注：DBC文件位于应用服务器下 /secure/

2.6 分配 ToolBox 职责

分配下列的职责给一个测试用户。如果需要知道如何创建一个用户并分配职责，请参考 Oracle Applications System Administrators Guide

开发环境配置

File Ref: Oracle Application Framework Personalization Guide 12.1.3

Company Confidential - For internal use only

2.开发工具的下载与安装 5 of 16

OAF开发学习总结

Doc Ref:

July 27, 2014

1． OA Framework ToolBox Tutorial (职责关键字： FWK_TBX_TUTORIAL) 2． OA Framework ToolBox Tutorial Labs (职责关键字： FWK_TOOLBOX_TUTORIAL_LABS) 对应的中文名称及添加完职责后：

这两个职责是为了以后测试我们的工程使用的，所以一定要添加职责，否则后面运行程序会报错。

开发环境配置

File Ref: Oracle Application Framework Personalization Guide 12.1.3

Company Confidential - For internal use only

2.开发工具的下载与安装 6 of 16

OAF开发学习总结

Doc Ref:

July 27, 2014

3.Toolbox Tutorials Release 12.1.3

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 工作台。导航到目录

\\myprojects ，打开文件 toolbox.jws 3． 在系统导航栏中，展开 toolbox.jws 显示其中的内容。选择 Tutorial.jpr 项目，然后

选择 Project > Project Settings 4． 在 Project Settings 对话框中，展开 Oracle Applications 节点，选择 Runtime

Connection 项 5． 使用 Browse… 按钮选择在任务2种保存的 DBC 文件，此文件必须保存在

\\dbc_files\\secure 目录下 6． 将已指定 ToolBox 职责的用户和密码输入对应位置

开发环境配置

File Ref: Oracle Application Framework Personalization Guide 12.1.3

Company Confidential - For internal use only

3.Toolbox Tutorials Release 12.1.3 7 of 16

OAF开发学习总结

Doc Ref:

July 27, 2014

3.3 新建一个DATABASE连接

点开左边导航栏的Connections，右击其下的Database，选择New Connection，出现如下的欢迎界面

为数据库连接起一个名字，连接类型使用默认的JDBC连接

输入数据库连接的用户名和密码，使用normal进行连接

开发环境配置

3.Toolbox Tutorials Release 12.1.3 8 of 16

File Ref: Oracle Application Framework Personalization Guide 12.1.3

Company Confidential - For internal use only

OAF开发学习总结

Doc Ref:

July 27, 2014

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 运行

开发环境配置

File Ref: Oracle Application Framework Personalization Guide 12.1.3

Company Confidential - For internal use only

3.Toolbox Tutorials Release 12.1.3 9 of 16

OAF开发学习总结

Doc Ref:

July 27, 2014

3. 如果浏览器显示出如下页面，代表环境配置正确

4. 点击Hellow，world！进行OAF页面的测试

开发环境配置

File Ref: Oracle Application Framework Personalization Guide 12.1.3

Company Confidential - For internal use only

3.Toolbox Tutorials Release 12.1.3 10 of 16

OAF开发学习总结

Doc Ref:

July 27, 2014

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 是值列表所在的包，这里面包含了所有值列表页面、值

开发环境配置

File Ref: Oracle Application Framework Personalization Guide 12.1.3

Company Confidential - For internal use only

4.OAF结构和组件概述 11 of 16

OAF开发学习总结

Doc Ref:

July 27, 2014

列表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页面的联系体，起一个桥梁

开发环境配置

File Ref: Oracle Application Framework Personalization Guide 12.1.3

Company Confidential - For internal use only

4.OAF结构和组件概述 12 of 16

OAF开发学习总结

Doc Ref:

July 27, 2014

的作用。 4.8 Page

Page是OAF的可见实体。它是用户在应用中能看到页面。它在包 oracle.apps.ak.wydeliverybillstatus.webui下。（图1.5中的（10）） 4.9 Java 控制文件

它是Page中的逻辑控制代码文件，里面是Java 代码。（图1.5中的（11）） 4.10 Region

它主要用于值列表。在值列表中它充当弹出框的角色，同FORM 中的LOV。

开发环境配置

File Ref: Oracle Application Framework Personalization Guide 12.1.3

Company Confidential - For internal use only

4.OAF结构和组件概述 13 of 16

OAF开发学习总结

Doc Ref:

July 27, 2014

1. Open and Closed Issues for this Deliverable

Add open issues that you identify while writing or reviewing this document to the open issues section. As you resolve issues, move them to the closed issues section and keep the issue ID the same. Include an explanation of the resolution.

When this deliverable is complete, any open issues should be transferred to the project- or process-level Risk and Issue Log (PJM.CR.040) and managed using a project level Risk and Issue Form (PJM.CR.040). In addition, the open items should remain in the open issues section of this deliverable, but flagged in the resolution column as being transferred.

Open Issues

ID Issue Resolution Responsibility Target Date Impact Date

Closed Issues

ID Issue Resolution Responsibility Target Date Impact Date

Open and Closed Issues for this Deliverable 14 of 16 开发环境配置

File Ref: Oracle Application Framework Personalization Guide 12.1.3

Company Confidential - For internal use only

OAF开发学习总结

Doc Ref:

July 27, 2014

1. Open and Closed Issues for this Deliverable

Add open issues that you identify while writing or reviewing this document to the open issues section. As you resolve issues, move them to the closed issues section and keep the issue ID the same. Include an explanation of the resolution.

When this deliverable is complete, any open issues should be transferred to the project- or process-level Risk and Issue Log (PJM.CR.040) and managed using a project level Risk and Issue Form (PJM.CR.040). In addition, the open items should remain in the open issues section of this deliverable, but flagged in the resolution column as being transferred.

Open Issues

ID Issue Resolution Responsibility Target Date Impact Date

Closed Issues

ID Issue Resolution Responsibility Target Date Impact Date

Open and Closed Issues for this Deliverable 14 of 16 开发环境配置

File Ref: Oracle Application Framework Personalization Guide 12.1.3

Company Confidential - For internal use only

本文来源：https://www.bwwdw.com/article/i4f6.html