05 OAF客户化开发实例之Helpdesk在线帮助管理员开发实例v1.0

AIMMD.070APPLICATIONEXTENSIONTECHNICALDESIGNHelpdesk在线帮助管理员开发实例Author:Peng.YangCreationDate:January28,2010LastUpdated:June26,2010DocumentRef:Version:1.0Approvals:Approver1Peng.YangApprover2CopyNo._____MD.070ApplicationExtensionTechnicalDesignii/38DocRef:June26,2010DocumentControlChangeRecord3DateAuthorVersionChangeReference28-Jan-2010Peng.Yang1.0NoPreviousDocumentReviewersNamePositionDistributionCopyNo.NameLocation1LibraryMasterProjectLibrary2ProjectManager34NoteToHolders:Ifyoureceiveanelectroniccopyofthisdocumentandprintitout,pleasewriteyournameontheequivalentofthecoverpage,fordocumentcontrolpurposes.Ifyoureceiveahardcopyofthisdocument,pleasewriteyournameonthefrontcover,fordocumentcontrolpurposes.MD.070ApplicationExtensionTechnicalDesigniii/38DocRef:June26,2010ContentsDocumentControl..................................................................................................................ii 开发介绍...................................................................................................................................1 概述....................................................................................................................................1 完成的目标........................................................................................................................2 XP操作系统JDEV环境配置.............................................................................................3 步骤1：创建页面模型组件..............................................................................................5 步骤2：程序部署到EBS应用服务器中.........................................................................30 步骤3：OAF控制器中的日志查看................................................................................33 步骤4：如何找到页面所对应的源文件........................................................................33 OpenandClosedIssuesforthisDeliverable....................................................................35 OpenIssues.....................................................................................................................35 ClosedIssues..................................................................................................................35 MD.070ApplicationExtensionTechnicalDesign1/38DocRef:June26,2010开发介绍概述本文当讲述了如何实现OAF在线帮助管理员页面功能。MD.070ApplicationExtensionTechnicalDesign2/38DocRef:June26,2010完成的目标完成此开发之后，需要掌握如下的课题：zOAF开发环境搭建了解zOAF框架的了解zOAF开发规范遵循zOAF页面的基本布局z通过编写必要的程序实现页面直接的JSPForwardz启用WarnAboutChanges功能，帮助用户减少不必要的数据丢失工作z实现实体对象、实体属性和行级的业务逻辑(包括抛出属性和行级的验证异常)z在业务逻辑中使用视图对象验证和应用模块验证z在基于实体对象的视图对象中添加一个新的行z处理按钮的动作z确保应用程序在使用浏览器中的Back按钮是安全的MD.070ApplicationExtensionTechnicalDesign3/38DocRef:June26,2010XP操作系统JDEV环境配置创建目录结构在jdev_install_dir\jdev目录下创建两个文件夹分别为myprojects和dbc_files，为了保持和ebs服务器一致，则在dbc_files下创建secure文件夹用于存放HostName_SID_Name.dbc文件，如下图所示。设置JDEV_USER_HOME环境变量1．选择我的电脑，右键选择属性2．在系统属性对话框中，选择tab高级页3．在高级tab页中选择环境变量按钮4．在环境变量对话框中，选择新建按钮创建用户变量5．在新建用户变量对话框中，输入变量名：JDEV_USER_HOME变量值：jdev_install_dir\jdev，例如：我在这里设置的变量值为：D:\JDeveloper9iCU3\jdevhome\jdev6．保存设置MD.070ApplicationExtensionTechnicalDesign4/38DocRef:June26,2010从ebs服务器上下载dbc文件到本地并进行修改ebs服务器中dbc文件所在位置：$FND_TOP/secure/HostName_SID_Name.dbc将erpuat_uat.dbc下载下来，将里面APPS_JDBC_URL=后面的内容反斜杠全部去除，即如下：APPS_JDBC_URL=jdbc:oracle:thin:@(DESCRIPTION=(LOAD_BALANCE=YES)(FAILOVER=YES)(ADDRESS_LIST=(ADDRESS=(PROTOCOL=tcp)(HOST=erpuat.yangpeng.com)(PORT=1522)))(CONNECT_DATA=(SID=UAT)))然后将该dbc文件放到$JDEV_HOME\jdevhome\jdev\dbc_files\secure路径下，例如我当前路径如下：D:\JDeveloper9iCU3\jdevhome\jdev\dbc_files\secure创建快捷方式为了方便快速启动，为jdev_install_dir\jdev\bin\jdevw.exe创建桌面快捷方式添加下面两个职责给自己的ebs用户以便开发和测试1．OAFrameworkToolBoxTutorial(职责关键字：FWK_TBX_TUTORIAL)，即OAFramework工具教程2．OAFrameworkToolBoxTutorialLabs(职责关键字：FWK_TOOLBOX_TUTORIAL_LABS)，即OAFramework工具教程：练习。启动Jdeveloper，并配置数据库连接和用户打开Jdeveloper后，ConnectionsDatabaseNewConnection或更改已新建过的连接如下：Type下ConnectionType为Oracle(JDBC)Authentication下Username为apps，Password为apps，Role为NormalConnection下Driver为thin，HostName为erpuat.yangpeng.com，JDBCPort为1522，SID为UAT然后TestConnection看是否可以连上，如果连上则显示Success!MD.070ApplicationExtensionTechnicalDesign5/38DocRef:June26,2010步骤1：创建页面模型组件任务1.1:拷贝HelpdeskSearchPG文件由于JDeveloper还不支持页面的”Saveas”或者copy/paste功能，需要使用文件系统来完成如下的任务。z在myprojects\oracle\apps\cux\helpdesk\webui文件夹中选择HelpdeskSearchPG.xml文档，并进行拷贝z将拷贝的文件放到webui目录下，并命名文件名为HelpdeskAdminSearchPGz在SearchOAProject.jpr项目下展开OAComponents类别，选择AddFile工具条图标打开AddFilesorDirectoriestoCUX_Helpdesk_OAProject.jpr对话框，找到HelpdeskAdminSearchPG.xml文件，确定添加。任务1.2:拷贝和改变创建页的控制器需要更改和新建的更新页关联的控制器。z在JDeveloper中打开HelpdeskResultsCO控制器文件，从主菜单中选择FileSaveAs，命名新的文件名为HelpdeskAdminResultsCOz改变HelpdeskResultsCO类文件中的类名为HelpdeskAdminResultsCOz在结构窗口中选择HelpdeskAdminSearchPG页的PageLayoutRN区域，并打开属性监视器z在ResultsTable下更改ControllerClass属性值从oracle.apps.cux.helpdesk.webui.HelpdeskResultsCO到oracle.apps.cux.helpdesk.webui.HelpdeskAdminResultsCOz更改WindowTitle和Title属性值为在线帮助管理员搜索页面z删除ResultsTable下的tableActions按钮z清空ResultsTable下的IssueNumber的属性DestinationURI中的内容MD.070ApplicationExtensionTechnicalDesign6/38DocRef:June26,2010任务1.3:拷贝He