OAF入门学习教程

OAF 系列之一基础教程Author: Danny ShenCreation Date: May 9, 2006Last Updated: June 13, 2019Document Ref:Version: 1.1文档控制变更记录3审阅分发目录文档控制 (ii)概述 (1)前提知识 (1)对象读者 (1)其它说明 (1)如何掌握OAF开发技术 (2)推荐的学习步骤 (2)OAF基础知识 (4)JSP应用的基本结构 (4)OAF应用的基本结构 (6)模型组件的实现 (10)模型对象介绍 (10)模型对象的设计 (14)推荐的OAF开发过程 (15)业务组件创建方法 (16)用户界面的实现 (38)页面、Region、Item (38)创建可重用的控件（Component） (39)属性集 (42)URL参数控制 (43)样式表 (45)与模型的交互 (45)OA Controller的实现 (49)OA Controller的设计 (49)创建OA Controller (50)处理HTTP GET请求 (51)处理HTTP POST请求 (54)处理HTTP POST请求 (55)常用方法示例 (56)禁用验证 (58)环境配置与应用发布 (59)开发环境安装与设置 (59)应用发布 (62)概述此文档用于讲解在Oracle E-Business Suite（以下简称EBS）下如何应用OA Framework（以下简称OAF）开发框架，进行客户化开发。

此文档主要介绍OAF的基础知识，其中涉及如何建立开发环境、OA Framework MVC框架介绍及各部分说明、如何发布应用等方面。

要掌握更深更系统的OAF技术知识，请查看《Oracle Application Framework Developer’sGuide》。

前提知识此文档假定读者已经具备以下条件：●Web开发的基础知识●Java语言基本编程技术●面向对象开发的基本知识●XML的基本知识对象读者此文档适用于以下人员：●OAF开发人员●OAF测试人员其它说明本来是想翻译《Oracle Application Framework Developer ’s Guide》作为OAF的教程。

OAF开发学习总结教程一苏南生OAF开发学习总结 (一) 环境的配置Author: Creation Date: Document Ref: Version:Approvals:苏南生 July 27, 2021DRAFT 1ACopy Number _____OAF开发学习总结Doc Ref:July 27, 2021Document ControlChange Record3Date Author Version Change Reference 2021-7-27 苏南生 Draft 1a No Previous DocumentReviewersName PositionDistributionCopy No. Name Location 1 2 3 4 Library Master Project Library Project ManagerNote 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.3Company Confidential - For internal use onlyDocument Control iiOAF开发学习总结Doc Ref:July 27, 2021Contents目录DocumentControl ...................................................................... ............................................ 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 Release12.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.8Page ......................................................................... ......................................................... 13 4.9 Java 控制文件............................................................................ ....................................... 13 4.10Region ....................................................................... .. (13)1. Open and Closed Issues for thisDeliverable ...................................................... 14 Open Issues ....................................................................... .............................................. 14 ClosedIssues ....................................................................... . (14)开发环境配置File Ref: Oracle Application Framework Personalization Guide 12.1.3Company Confidential - For internal use onlyDocument Control iiiOAF开发学习总结Doc Ref:July 27, 20211.概述1.1. 总体说明OAF是Oracle Applications Framework的简称，目前主要应用于供应商门户网页的开发。

OAF开发指导一、search功能的实现1.创建应用项目工作区2.创建项目在创建完应用项目工作区之后会直接跳转到创建项目的页面。

（如果没有跳转也可以在工作区中右键创建project）。

跳转到这个界面之后输入项目的名称，并指定“Default Package”的路径为“oracle.apps.po.test”或者其他的合适路径点击下一步，进入选择数据库链接的页面，勾选“User Repository for Design Time”选项，并选择配置好的连接（此连接为数据库连接）并点击进入下一步。

在页面中选择DBC File Name的文件路径，DBC文件是从服务器下载的oracle文件，放在指定的路径。

在user name 和password中分别输入oracle应用系统的用户名和密码。

3.创建AM选中”Application Sources”，右键“NEW”进入创建AM的页面在NEW Gallery中选择Categories中的“ADF Business Components”选项，在Items 中选择“Application Module”选项，并点击确定按钮进入创建AM向导。

直接点击下一步进入AM创建的第一步：命名界面，package会默认路径名为project的路径，需要添加后缀.server来指定子目录“oracle.apps.po.test.sever”，并命名AM的名称，原则上以”AM”结尾。

点击下一步进入Data Model界面，直接点击完成，就完成了AM的创建。

4.创建VO创建完AM的project中应该存在“oracle.apps.po”子目录，在子目录中的test 目录中的server中会显示之前创建的AM“APPSTESTAM”。

选中server右键，在弹出的页面选择“New View Object”选项，进入创建VO的向导页面。

在弹出的向导页面中选择下一步，进入VO设置步骤。

教程：管理持久性数据(BC4J)此教程说明了OTN 开发人员如何使用Oracle9i JDeveloper 和Oracle Business Components for Java (BC4J) 框架为虚拟购物中心示例应用程序管理持久性数据。

目录1. 概念2. 设计3. 所需软件4. 安装5. 实施6. 资源7. 反馈ConceptsBC4J-VSM 是一个在数据库中存储持久性数据的多层应用程序。

下图给出了该体系结构的一个高级视图。

BC4J 框架提供了两个运行于数据库的重要对象：实体对象和视图对象。

∙实体对象为数据库表（或视图、同义词、或快照）存储商务逻辑和列信息。

实体对象回答了"什么对象与商务相关？"的问题.在问题域中它们是名词。

您能够从现有的数据库表来创建实体对象（反向生成），或者定义实体对象，并使用它们来创建数据库表（正向生成）。

∙视图对象使用 SQL 查询来指定过滤的商务数据子集，这些数据能够与实体对象的属性相关。

视图对象回答了"什么数据与任务相关？"的问题。

您可以查询一组数据，并完全按您希望的方式显示出来。

视图对象定义视图行类的属性，视图行类代表查询结果中的一行，而且也可以指底层的实体对象。

视图对象为客户提供了行的集合，他们可以对它进行滚动和更新，而不需要考虑或了解底层实体对象。

客户可以通过导航结果集来操纵数据、获取和设置属性值；当提交事务时，将会对底层数据库中的数据做出相应更改。

视图对象之间的关系用视图链接来表示。

每个视图对象都提供了一个默认的迭代器，您可以用它来导航该对象的结果集。

例如，下图展示了视图对象、实体对象和底层数据库表之间的关系。

名为EmpNames 的视图对象对Emp 实体对象操作，提供EMP 表中EMPNO 和ENAME 列的视图。

通过消除与常见的"应用程序探测"设备相关的大量编码和测试工作，BC4J 使应用程序开发人员可以将全部时间集中在实施商务解决方案上。

OracleOAF开发指南第二章翻译（中文）-(1)作者: atomic79 | 来源: ERP100门户OAF开发课程第二章-OA Framework Essential1、JSP Application Prime如果你没有web application的开发经验，下面将讲解一些基础的知识。

比如一个JSP 应用是如何构建的，在运行时发生了什么。

并说明OAF开发教程中的一些重要的关键概念。

1.1.1. Key JSP Application Components一个典型的JSP应用要包括以下的组件：用来进行客户端访问的浏览器、存放企业数据的数据库和一个web应用服务器（中间件）。

浏览器通过HTTP（超文本传输协议）协议与应用服务器进行通信。

该通信过程中包括从客户端通过浏览器发送一个request信息到应用服务器，然后应用服务器响应请求，返回一个response信息到浏览器。

JSP是内部有HTML和Java代码的从头到尾顺序执行的文件。

在运行时，它会被编译成为一个Servlet class。

Servlet是实现了标准API的基于Java的web应用服务器扩展程序。

JavaBean(简称bean)是很容易进行重用的组件。

它根据一定的设计模式的思想来进行构建，便于开发人员使用开发工具易于挖掘对象的属性和行为。

应用服务器上的任何对象均是通过JDBC驱动与数据库进行通信。

模型图如下所示：1.1.2. What Happens at Runtime？Step 1当用户点击一个超连接、按钮或者热点图像时，浏览器发送一个HTTP请求到web应用服务器进行处理。

HTTP请求主要有POST和GET两种。

HTTP GET不论用户点击一个超链接或者热点图像时，浏览器发送的请求均为GET类型的。

你可以把GET请求假想成一张明信片：请求的任何信息都写在明信卡上。

这就意味着所有的通信信息均可以看到，数据均是通过地址栏参数进行传输。

OAF--基础OAF是WEB界⾯，FORM是由JDK将FORM⾥⾯的东西插⼊到HTML UI⾥的；OAF由 Oracle Business Components for JAVA(BC4J)框架作为其模型部分，完成EBS数据库对象到java对象的转换⼯作，相当于hibernate，来实现业务逻辑和数据操作并且页⾯的运⾏依赖于oacore容器，oacore相当于tomcat，完成服务器端的事件监听和转发。

OAF使⽤元数据库⽀持的(整个页⾯由XML来定义，定义存储与Oracle数据库中)。

由UIX引擎将xml元素重新组装，并且与BC4J中的数据项进⾏绑定，形成HTML返回给我们的浏览器进⾏展⽰。

UIX框架作为其视图部分，将BC4J中的数据展⽰给⽤户。

页⾯部分是通过JDeveloper ⼯具定义XML结构。

⼀般不需要额外编写代码。

OAF提供丰富的页⾯组建库和事件机制，例如页⾯局部刷新、翻页、LOV选择、统⼀的CSS风格。

OAF具有强⼤个性化扩展性，对于已有程序可以在不需要改动源代码的情况下，实现web页⾯以及数据逻辑修改和新增。

1.下载JDeveloper：关于此页--技术组件查看OAF版本号登陆metalink，搜索⽂档编号：416708.1，下载最新版本的。

2.解压配置定义系统环境变量： JDEV_UESR_HOME 解压⽬录 jdev层。

3.新建⼯作空间4.在⼯作空间下定义project5.在project建⽴数据库连接6.DBC file:存放些DB信息DBCfile在⽬录 $FND_SECURE下7. 模拟数据库登陆项⽬--属性字符为 UTF-81. 新建OAF中的对象新建PG:Application Sources -> new --> OA Components --> page 包的路径: trn.oracle.apps.cux.hello.webui : 第2、3层不能变，第四层是定义的应⽤下，第五层是对象的名称，第六层页⾯放在 webui下；新建AM: Application Sources -> new --> ADF Business Components --> Application Module 包的路径 trn.oracle.apps.cux.hello.serverPG指定AM/AM绑定PG：Structure窗⼝下点击 region1，在BC4J下的AM Definition选择AMregion1下添加 item1.2.发布.class ⽂件放⼊ $JAVA_TOP ⽬录下执⾏ adcgnjar 打成jar包将XML导⼊到数据库执⾏ java oracle.jrad.tools.xml.importer.XMLImporter $JAVA_TOP/trn/oracle/apps/cux/hello/webui/HelloWorldPG.xml -rootdir $JAVA_TOP -username apps - password apps -dbconnection $AD_APPS_JDBC_URL检验导⼊成功：beginjdr_utils.printDocument(''); --import后⽣成的 as后⾯end;未完待续。

OA工作流程及快速入门手册OA（Office Automation）即办公自动化系统，是一种集成电子数据处理、办公设备和通信技术的管理信息系统，旨在提高办公效率和管理水平。

本文将介绍OA工作流程及快速入门手册。

一、OA工作流程1. 流程设计在实施OA系统前，需要对企业流程进行分析和设计。

流程设计包括确定流程的各个环节和流转规则，制定流程的审批规则和权限。

2. 软件开发和部署根据流程设计，开发OA系统的软件，并进行测试和调试。

完成开发后，需要对系统进行部署和安装，确保其正常运行。

3. 员工培训在系统部署完成后，需要对员工进行培训，让他们熟悉系统的使用方法和操作流程，并了解各个模块的功能和作用。

4. 数据录入和配置将企业的数据录入到OA系统中，并进行数据的配置和设置，包括组织结构、角色权限和流程规则等。

确保数据的准确性和完整性。

5. 日常运维日常运维包括系统监控、故障排除和数据备份等工作。

同时，还需要对系统进行定期的更新和优化，以保证系统的稳定性和安全性。

二、快速入门手册1. 登录系统在浏览器中输入OA系统的网址，并输入用户名和密码登录系统。

如果是首次登录，系统会提示首次设置密码。

2. 导航菜单登录系统后，便可看到系统的主界面。

主界面上有一个导航菜单，菜单上列有各个功能模块的名称和图标。

点击相应的模块图标，即可进入对应的功能界面。

3. 新建流程在功能界面中，点击“新建”按钮，即可创建一个新的流程。

根据提示填写相关信息，如流程名称、参与人员和审批规则等。

保存后，流程就会自动启动。

4. 审批流程在流程的不同环节，会需要不同的人员进行审批。

系统会自动发送审批通知给相应的人员，并显示在待办事项列表中。

审批人员需要登录系统，进入待办事项列表，点击对应的审批任务，进行审批操作。

5. 数据查询在系统的主界面上有一个查询按钮，点击后，可以输入相关条件进行数据查询。

系统会根据条件搜索并显示符合条件的数据列表。

6. 报表生成系统还提供了报表生成的功能。