《Oracle之APEX深入开发指南》.docx

1、Oracle之APEX深入开发指南Oracle之APEX深入开发指南Oracle ERP APEX开发指南Author: 刘俊杰 Creation Date: April 10, 2014 Last Updated: November 29, 2018 Document Ref: Version: 1.0Approvals: Document Control Change Record 4 Date Author Version Change Reference10-Apr-13 Junjie.liu 1.0 No Previous DocumentReviewers Name Positio

2、n Distribution Copy No. Name Location1 2 3 4Note 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 fron

3、t cover, for document control purposes. Contents Document Control ii 1. APEX之系统探究 2 1.1. APEX简介 2 1.2. 环境搭建 3 1.3. APEX账户管理 6 1.4. 待定 8 2. APEX 开发 9 2.1. 开发概要 9 2.2. 页面布局、美化 10 2.3. APEX控件 13 2.4. Report常用增删改 16 2.5. 文件上传下载 19 2.6. 使用CSS与JS 25 2.7. 图表、报表 28 2.8. Application Express Free Plugins 35 2

4、.9. APEX部署 37 3. APEX之调试、常用技巧、API 39 4. APEXEBS集成 40 4.1. EBS中配置APEX页面调用 40 5. Reference 43 6. Open and Closed Issues for this Deliverable 44 Open Issues 44 Closed Issues 44 1. APEX之系统探究 1.1. APEX简介 1.1.1. 概述 1) Oracle Application Express是基于Web浏览器的网络即时开发、部署、运行。 2) Oracle Application Express所有页面都是存储于

5、数据库，类似于EBS的Form个性化。 3) Oracle ApplicationExpress具有易用性、灵活性及Web的安全性、集成性、可伸缩。 1.1.2. 体系结构 Application Express使用用户计算机上的Web浏览器通过Web监听程序与Oracle数据库通信。开发，部署或运行时不需要浏览器之外的任何其他客户机软件。 Application Express页使用浏览器中的HTML来呈现。页请求和提交发送到Oracle数据库中的Application Express引擎。 1.1.3. 运行环境 1) 浏览器要求 Web浏览器必须支持Java脚本和HTML4.0和CSS1

6、.0标准。Oracle Application Express建议使用以下浏览器进行开发或查看应用程序： l 微软Internet Explorer7.0或更高版本 l Mozilla Firefox 3.6或更高版本 l 谷歌Chrome4.0或更高版本 l 苹果Safari4.0或更高版本 2) 数据库及HTTP服务器要求 1) Oracle Database 11g release 1or 2,自带pl/sql网关配置比较简单，能够直接提供HTTP服务器的功能。 2) Oracle Database 10g,必须使用mod_plsql插件或是Oracle Application Expr

7、ess监听器来连接专业的HTTP服务器。 1.1.4. 运行机制 Application Express完全驻留在Oracle的数据库中，它是由存储在数据表中的数据和大量的pl/sql对象组成.对于客户浏览器发送的URL请求解析成pl/sql调用，数据库处理pl/sql调用，并将结果以HTML形式返回浏览器(sys.htp.p)。每个页面的结果都在新的会话中，因此当Application Express引擎处理或者呈现一个页面的时候才会消耗数据库资源 Application Express引擎包括： 1) 异步会话状态管理 2) 认证服务 3) 授权服务 4) 页面流控制 5) 验证处理 6)

8、 页面渲染和处理 1.1.5. 学习基础 1) SQL、PL/SQL基础 2) HTML基础 深入开发的时候对html,javascript,css还是蛮重要的。 1.2. 环境搭建 1.2.1. 环境准备 操作系统、数据库、安装文件 我这边使用的是RedHat 4.2.1 + Oracle 11g + Vmware8.0 安装文件使用最新的Apex_4.2.5.zip可在网上下载 安装方式可以采用嵌入式SQL网关来监听或使用APEX Listener基于Apatch的mod_plsql来安装。 本文使用嵌入式SQL风关来安装。安装OK后当需要关闭虚拟机时把虚拟机的状态置为挂起状态，这样下次再

9、打开时就不需要再重新去配置参数。 下面的安装都是使用系统的DB用户操作 安装有问题可联系作者jjl.soft 1.2.2. Oracle Application Express安装step by step 1) 由于oracle 11g自带Apex3.0，因此在本次安装的时候我们首先要卸载掉3.0版本 2) 上一步全部运行OK后，在apex目录下执行rm rf *.* 创建一个TableSpace:Apex01, CREATE TABLESPACE apex01 DATAFILE /d01/oracle/db/apps_st/data/apex01.dbf SIZE 100M AUTOEXTE

10、ND ON NEXT 100M MAXSIZE 1000M; 3) 把之前下载的Apex4.2.5安装文件上传至$ORACLE_HOME下,然后解压至/apex目录下 4) 开始安装 5) 更改Admin用户，并解锁APEX_PUBLIC_USER,其中Admin用户密码要设置得比较复杂，必须包含大写、小写字母+特殊的符号+数字 ALTER USER ANONYMOUS ACCOUNT UNLOCK; 6) 上述步骤全部OK后，可选安装中文语言 7) 配置嵌入式pl/sql网关 8) Grant connect privileges to any host for the APEX_04020

11、0 database user 9) 更改参数值 10) 以上全部OK后，APEX安装完成，可通过http:/server:8888/apex/apex_admin来管理，若出现HTTP404错误后，请执行如下命令,若没开则把它启起来 11) 成功后则可访问访URL http:/server:8888/apex http:/server:8888/apex/apex_admin 安装到此，貌似都解决了，打开管理员网址，输入用户名、密码：ADMIN/.后发现无法通过登录授权认证，怎么解决呢？难道密码不对，于是再次更改ADMIN的密码，重启数据库，发现问题依旧，这样排除了ADMIN密码不对的可能，

12、APEX授权的登录连接只有APEX_04002,这个也是没有问题的，也就是说本次的安装都是OK的，毕竟系统都启起来了，这时候联想到是不是这个授权验证是否还走的是之前的3.0版本的校验，执行了如下这段SQL发现确实还存在之前3.0版本的遗留用户，果断的把这些用户全部drop掉。后面不小心把APEX_04002也drop了，因此只好又重装，重装后一切OK。 Drop user cascade; 1.3. APEX账户管理 1.3.1. APEX账户关系图 1.3.2. ADMIN 1) ADMIN是Oracle Application Express的超级管理员 2) ADMIN可以创建、删除、修

13、改WorkSpace及Workspace的管理员 创建一个WorkSpace名为jjl，Schema为oracle ebs的apps,同时创建该workspace的管理员名为jjl 1.3.3. WorkSpace的Admin，Developer，AppEndUser 1) 使用刚创建好的WorkSpace以管理员jjl登录 2) 登录之后为该workspace创建开发用户与app最终用户 3) 后续就可以用使用developer登录workspace进行开发1.4. 待定 1.4.1. 待定 2. APEX 开发 2.1. 开发概要 2.1.1. 理解WorkSpace、Applicatio

14、n WorkSpace:工作空间,一个WorkSpace对应Oracle数据库的一个Schema，形象的理解我们可以认为它就是一个工程，这个工程里面有很多的子项目Application.在与EBS的集成开发中，我们认为每个Application可以类似于EBS中的一个Form，该Form里包含多个窗口. 本文有些截图是基于Oracle Application Express 4.2.5版本。在APEX中的页面布局、各种OBJECT的属性控制都是可以通过配置来解决的，对于这种声明式的开发它需要的是少量的Coding，主要是偏向于pl/sal编程. Oracle Application Expre

15、ss可以创建Database Applications,Websheet Applications,Packaged Application 本文对应的开发都是Database Application. 2.1.2. Application授权登录机制 每个Application都可以为其设置安全认证，创建Application的时候会让你三选一。 后期创建好后我们是可以对其登录机制进行修改。具体的APEX自带的授权登录机制有7种。 在目前的开发中我们可以选择Application Express Accounts与HTTP Header Variable. 前者必须输入APEX用户名密码才可

16、登录，后者 2.1.3. Page0 Page0是该Application的一个全局页，比如某些全局变量，全局常量都可以在该页去设置,为了方便管理我们把不同类型的变量放在不同的区域，这些区域是不显示在界面上的类似于HTML的HIDDEN. 2.1.4. 待定 2.2. 页面布局、美化 Application Express 提供了 20 个主题。每个主题由定义应用程序外观的组件模板组成。Oracle Application Express 4.0 提供的这些现代化主题都符合 XHTML 和 CSS 标准。XHTML 页面可移植性更强、呈现时间更短。在项目上开发的使用的是APEX4.1.1版本，

17、在网页布局这块比较郁闷，创建Region的Column属性是在某个 Body内是全局的，在APEX4.2.5版本中，就变得相当的Easy，可以对子子.区域的重新布局，其子子区域都会有对应的Grid Layout可以配置。 2.2.1. 页面区域展现 APEX的页面在选定主题后，其页面的布局与CSS基本上已确定，基本上符合DIV+CSS来布局，然后把某几个常用的DIV放开给Developer开发使用。其中Body区域在HTML中是以展现，Position区域在HTML中是以展现 其中我们常用的区域为红色标记的区域。 实例创建区域的布局如图： 如何实现以上布局呢？在这里首先还是得明白HTML中的基

18、本元素及这些元素附带的一些属性. 上图相信对TABLE能一目了然了。那这些HTML的标签是如何对应APEX中的配置呢？请看下图来自APEX的Grid Layout的配置 Start New Grid：意为着当前的Object是否采用新的网格布局，即是否采用一个新的展现，不基于上一个的布局展现(比如可以重新定义列数,) Start New Row：意为着当前的Object是否换行显示，即展现 Column：意为着当前的Object是在该的当前行的第几列展现. 那么像上面布局图中的 Search3的区域布局配置为： Newsearch1的区域布局配置为： Newsearch3的区域布局配置为： 同

19、理要实现更复杂的布局基于上述原则也是实现起来比较简单的。配配就OK了 2.2.2. 标题待定 2.3. APEX控件 APEX作为一个强大的快速开发工具，当然少不了一些常用的控件，下拉框Commbox,值列表Lov,文本框Text,日历DataPick,报表Report,。这些控件的基本使用可参考 我们知道控件都是可以有很多属性、事件、校验、Dynamic Action。 其中Dynamic Action是可以做很多操作的，比较重要的是执行pl/sql时类似于Ajax的无刷新 控件属性： l Form Element Width：控件的宽度 l Horizontal / Vertical Al

20、ignment:控件的显示位置还有Label显示位置。 l Value Required：是否必输入。 l Condition Type：控件显示的条件，只有满足了才显示。 l Read Only Condition Type,：控件只读的条件，只有满足了才只读。 l Default value：设置控件的默认值。 l Format Mask：控件值的格式掩码 事件： 事件定义也是有属性可配置的： l Condition Type：执行事件的前提条件 l True Actions：事件发生后，对应控件的校验条件为真时执行的动作。 l False Actions：事件发生后，对应控件的校验条件为

21、假时执行的动作。 l WHEN Condition:事件发生后，执行相应的动作的判断条件。 校验属性： l When Button Pressed ：触发校验的Button l Condition Type：触发校验的前提条件 l Condition Expression:校验表达式 l Validation：执行相应的校验 l Error message display location：错误信息显示方式 l Associated Item：错误信息关联到指定的Object 下面做个具体的实例使用这些属性、事件、校验 1、 点击Button: Search2 Btn时校验 X_Text1值是

22、否为空，满足校验的前提条件是jjl_test表中存在记录user_id=123; 2、 当页面加载完，DatePick:Data init值赋值为当前日期 3、 当X_text2值不为空时,Region：new search2隐藏，否则显示 最终效果图： Step By Step操作 1、 创建一个页面命名为Page2 2、 Pl/sql apps登录创建table：jjl_test(user_id varchar2(50),resp_id varchar2(50),resp_appl_id varchar2(50),login_name varchar2(50),login_count nu

23、mber,login_date date); insert into jjl_test values(123,); 3、 在Page2中创建六个html region，对应的Parent Regionn选择Page Template Body(1) 4、 Search1,search2,search3 属于同一个TABLE，属性Column依次为1，2，2. 属性Start New Grid依次为Yes,No,No. 属性Start New Row依次为Yes,No,Yes. 5、 New Search1,new search2,new search3 属于同一个TABLE，属性Column依

24、次为1，2，3. 属性Start New Grid依次为Yes,No,No. 属性Start New Row依次为Yes,No,No. 6、 在search1中创建TextField:P1_X_TEXT,P2_X_TEXT,search2中创建Button :SEARCH2_BTN,search3中创建DatePick:DATA,new search2中创建子区域：newsearch_subpage1,new_search3_subpage2,new_search3_subpage3, 属于同一个TABLE，属性Column依次为1，2，1. 属性Start New Grid依次为Yes,No

25、,No. 属性Start New Row依次为Yes,No,Yes 7、 P1_X_TEXT鼠标右键创建相应的Validation： Name:X_TEXT1 IS NOT NULL When Button Pressed:SEARCH2_BTN. Condition Type:Exists(SQL query returns at least one row) Condition Expression 1:select 1 from jjl_test jt where jt.user_id=123; Validation Type:Function Returning Boolean Val

26、idatoin Expression:begin if :P1_X_TEXT is not null then return true; end if; return false;end; Error message:X_TEXT1 cant be null; 8、 P2_X_TEXT鼠标右键创建相应的Dynamic Actions: Name:Dynamic_action1; Conditon Type:Always; When Event:Change When Selection Type:Item(s) When Item(s):P2_X_TEXT When Condition:is

27、not null True Actions:Hide Region(new search2) False Actions:Show Region(new search2); 9、 创建PageLoad型的Dynamic Action Name:page_load_set_date; Condition Type:Dynamic Actoin Not conditional When Event:Page Load When Condition No Condition True Actions:Set Value Set Value/Settings/Set Type:SQL Statemen

28、t Set Value/Settings/SQL Statement:select sysdate from dual; Set Value/Affected Elements/Selection Type:Item(s) Set Value/Affected Elements/Item(s):DATA 2.4. Report常用增删改 通常在APEX中对于记录的增删改是通过链接到新的页面去实现单条数据的更改。本节主要介绍如何在一个Tabular Form中不链接实现多行数据的增删改和客户化逻辑。APEX的Tablular Form开发类似于EBS Form开发，也是基于视图去开发。 下面实例

29、开发一个Form，当更改用户的class_name与login_name时，更新用户的login_name，然后在另一张表校验class_name是否存在，若不存在报错，若存在则把当前勾选的记录插入另一张表jjl_test3 1、 数据库中先创建APEX页面的Tabular Form的View,同时创建一个APEX页面并创建Tabular Form 2、 create table jjl_class(class_id number,class_name varchar2(50);create or replace view jjl_class_test2 asSELECT jt.user_id

30、,jt.resp_id,jt.resp_appl_id,jt.login_name,jc.class_nameFROM jjl_test2 jt, jjl_class jcWHERE jc.class_id = jt.class_id; 3、 配置页面Tabular Form数据源 4、 创建一个RegionButton：Apply Change 5、 为Apply Change创建Process: 6、 运行效果如图： 当class_name不存在于jjl_class表中时 当输入的class name存在时，运行的效果与结果如图： 把BBB更改为DDD 点击Apply Change后2.5

31、. 文件上传下载 真是麻雀虽小，五脏俱全，上传下载在Apex里的实现是非常easy.下面的例子实现 文件上至数据库 - Create table 1、create table JJL_FILE ( idNUMBER,file_nmae VARCHAR2(50),file_memetypeVARCHAR2(50),file_blob BLOB,file_commentsVARCHAR2(200),file_charsetVARCHAR2(20),last_update_date DATE) 2、创建Page:updown load file，在该page中创建html区域:upload file

32、 由于数据文件是上传至数据库表，需要在页面上传文件之前，可以在加载完head后去表里 Fetch Row from jjl_file，然后在页面上创建相应的hidden项与表jjl_file中相字段相应。就像在pl/sql中要往表里插一行记录时，可以先定义该表的Rowtype类型的变量，然后再做赋值与Commit; 创建相应的region item,type:hidden分别为p_file_id,p_file_name,p_file_charset,p_file_memetype 创建processes:fetch row from jjl_file;上图中的table name要大写. 双击之前hidden项，配置每项的Source属性，保持与jjl_file的列名一致。如P_FILE_ID对应JJL_FILE中的ID。 4、在区域upload file中创建File Browse项，具体配置如下： 以上都对应