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

atomic79

3.       OAF开发课程第一章-Getting Started

3.1.   第一课还是“Hello World！”

本课的目的将会通过生成一个简单的页面来展现如何进行初步的OAF开发工作。约耗时1－3小时。
在完成该课程后，应该掌握：
新建一个Oracle Application（OA）Jdeveloper Workspace和Project。
设置project，以便在开发模式下进行调试。
使用Jdeveloper OA Extension生成一个非常简单的页面。
生成一个控制器，并将它与一个region建立关联。
处理一个HTTP POST请求的submit按钮的事件。
在正常和debug模式下运行一个页面。
该课程的结果页面如下图所示（实例图片为11.5.10上的页面效果）：

该页面上包括一系列global links，比如Preferences（首选项），Logout（注销）以及Return to Portal（返回至门户）。以及一个header（标题区）、一个footer（页脚），一个Go按钮。该页面仅是在点击Go按钮时将文本框中的内容显示到页面上做为提示。页面上的与客户化（Personalization）相关的Personalize Page和About this Page超链接需要配置相应的配置文件才能显示出来。
3.2.   实现步骤

3.2.1.      新建OA Workspace和OA Project

File>New…,打开New Gallery对话框,选择General分类下的Projects节点Workspace Configured for Oracle Applications。
在新建了Workspace后会自动要求你建立一个空的Project。按照向导一步步操作即可。
该课程中在JDEV_USER_HOME\myprojects路径下新建HelloWorldOAProject.jpr，设置默认的包为xz.oracle.apps.ak.hello。dbc文件、用户、职责选择相应。
3.2.2.      设置OA Project的Run Option

打开Project Properties…，展开Oracle Application节点下的Run Options属性。选择OADeveloperMode和OADiagnostic从Avaiable Options到Selected Options。
其中OADeveloperMode提供了额外的运行时代码检测和规则校验。OADiagnostic选中将在页面的顶部显示诊断链接（Diagnostics），该设置优先级高于application中的配置文件。在开发过程中，通常应保持选中这两种模式。开发模式选项见下一小节。
3.2.3.      生成OA Components Page File

在新建的workspace中，选择.jpr文件，右键并选择New>，或者直接从菜单中选择File>New…，打开新建对话框。选择Web Tier>OA Components>Page，在弹出的New Page对话框中，Name处输入HelloWorldPG，Package处输入oracle.apps.ak.hello.webui。
OAF开发中包名的命名规则应该符合Oracle Application的规范，其一般是mycompany.oracle.apps.<application_shortname>.<optional_modulename>.<optional_subcomponent>.webui，其中application_shortname为小写，并且在Oracle Application产品中已存在，比如INV。命名规范具体内容参见OAF课程第八章。
完成页面的创建后，页面的初始结构会出现在Jdeveloper中的Structure Window中。其中pageLayout Components文件夹包含了标准的Oracle公司的商标图像。
3.2.4.      修改顶级Page Layout Region

在创建页面后，Jdeveloper会自动创建页面的顶级的page layout region。具体属性可在属性面板（Property Inspector）中进行相应的调整。
如果属性面板未打开，则可以选择菜单View>Property Inspector。在属性面板的属性上右键并选择“Categories”，可在属性按照字母表序或按分类序来排列之间来切换。
在本教程中，设置该pageLayout的ID属性为：PageLayoutRN。
确认Region Style属性被设置为pageLayout。
确认Form属性设置为True。
确认Auto Footer属性设置为True。
设置Window Title为<your name>:Hello World Window Title。
设置Title为<your name>:Hello World Page Header。此属性将出现在页面头部的蓝条之下。
设置AM Definition属性为oracle.apps.fnd.framework.server.OAApplicationModule，手工输入。该AM是一个为OAF所使用的通用的application module。
3.2.5.      创建第二个Region（Main Content Region）

在pageLayout Region下再创建一个region，方法是在Structure Window选择pageLayout Region，右键并选择New>Region
Region将为页面上的组件提供一个容器，并且保证正常的交错排列。
在本例中，设置该region的属性。
将ID设为MainRN。
将Region Style设为messageComponentLayout，messageComponentLayout做为region的子组件将为message类的组件提供布局容器。
3.2.6.      创建第一个Item

在Structure Window中选择MainRN，并在其上右键，从菜单中选择New>messageTextInput。
并设置属性，ID设为HelloName。
确认Item Style属性设为messageTextInput（该属性值将提供一个文本label和一个文本输入框）。
设置Prompt属性为Name。
设置Length为20。
设置Maximum Length为50。
3.2.7.      为Go按钮创建一个容器Region

在向messageComponentLayout类型的region中，添加一个非message类型的bean，例如submitButton。必须首先添加一个messageLayout Region。
选中messageComponentLayout，右键选择New>messageLayout。并将该region的Name属性设为ButtonLayout
3.2.8.      创建Go Button

选择messageLayout Region，右键并选择New>Item。
设置ID为Go。
设置Item Style为submitButton。
设置Attribute Set为/oracle/apps/fnd/attributesets/Buttons/Go。
此处可通过选择Search in：Entire MDS XML path，及时该Attribute Set不在当前的Project中。
确认Prompt设置为Go.
附件:

leexiaodong

你太伟大了，把第一章也搞出来了。。。支持下！

kof_killer

哈哈。。。好东西

Beyond518

支持.......

hinet

你太伟大了，把第一章也搞出来了。。。支持下！

oaf

这写的这么细，高中生都可以直接研习了。还读啥子大学。。。。

58121663

不错，很用心，非常感谢！