简介《Oracle APEX深入浅出》是一份面向 Oracle APEX 初学者与中级开发者的系统化开发指南围绕企业级 Web 应用快速构建这一目标梳理从环境搭建、账户权限管理到页面布局、控件使用、报表图表及文件上传下载的完整知识脉络。压缩包共 1 个 doc 文件约 8.11MB以图文并茂的文档形式承载章节内容便于按目录顺序阅读或针对单个模块查阅。文档结构涵盖 APEX 系统探究、开发概要、CSS 与 JS 美化、Report 增删改、图表报表、插件与部署并延伸至调试技巧、常用 API 及 APEX 与 EBS 集成等实践主题。已有 1592 人学习适合希望理解 APEX 开发流程、补齐控件与报表操作细节、积累企业应用搭建经验的读者参考。1. 版本先对齐Oracle 11g 自带 APEX 3.0 的问题Oracle APEX 深入浅出这件事第一步不是翻文档看控件属性而是先把版本对齐。Oracle 11g 的库装完APEX 3.0 已经躺在里面了很多人不知道直接在这套内置版本上建工作空间、跑应用等到要做页面布局的 Grid Layout、要挂 Dynamic Action 的时候才发现4.1.1 里 Region 的 Column 属性是全局的改一个带动一片4.2.5 才有逐级可配的网格子区域各自有 Grid Layout 可以用。这类翻车我在早期的内部系统项目里见过不止一次不是配置写错是一开始装的东西就不对。这套环境适合手里已经有 Oracle 11g 数据库、想用浏览器把企业内部表单和报表快速搭起来的人。装不好最典型的后果是 ADMIN 登录不上、8888 端口一直 404而数据库本身看起来一切正常连 SQL*Plus 都连得进去——这种“数据库没问题、应用起不来”的玄学状态最耗时间。2. 环境准备与选型RedHat Oracle 11g APEX 4.2.5 这套组合怎么定整套环境能不能一次装通八成取决于装之前那半小时的准备。我这边跑通的组合是虚拟机里一套 RedHat 4.2.1上面装 Oracle 11g 数据库安装包用 APEX 4.2.5。这个组合不是最新但胜在稳定、资料齐、出问题能查到原因尤其适合在企业内网里做表单和报表类的应用。2.1 操作系统、数据库与安装包的对应关系先把三者的版本关系理清楚这一步偷懒后面全部要还回来。Oracle 11g 的 R1 和 R2 两个小版本都自带 APEX 3.0 系列也就是说你什么都不做库里已经有一套能用的 APEX——但它太老老到连现代主题都没有页面布局只能靠一张大表硬撑。要在它上面直接升级到 4.2.5官方路径是先卸载再全新安装不是打补丁。组件采用版本说明操作系统RedHat 4.2.1跑在虚拟机里单机验证够用数据库Oracle 11g R1 / R2自带 APEX 3.0必须先清掉APEX 安装包Apex 4.2.5.zip解压后放$ORACLE_HOME与/apex目录HTTP 接入嵌入式 PL/SQL 网关11g 自带不用另装 Apache监听端口8888EPG 默认 8080改成 8888 避开冲突如果手里的库是 Oracle 10g情况不一样10g 没有可用的嵌入式网关必须挂 mod_plsql 插件或者装 APEX Listener才能让浏览器请求打到数据库里。10g 的用户在这一步就要多花半天别照着 11g 的流程硬套。还有一条容易忽略的虚拟机状态。装完 APEX 之后如果要把虚拟机关掉别用正常关机把状态置为挂起。这一条听上去像偷懒实际是省掉下次开机重配监听、重设端口、重挂共享目录的一整套麻烦。我早期图省事每次都关机结果第二次打开环境时端口配置丢了又从头排查了一遍 404。2.2 三种 HTTP 接入方式该选哪个APEX 的页面是存在数据库里的浏览器发一个 URL 过来数据库把它翻译成 PL/SQL 调用再把 HTML 吐回去。中间这一层“谁把 HTTP 请求送进数据库”就是接入方式选错了后面全是坑。方式依赖适用场景主要代价嵌入式 PL/SQL 网关EPG数据库自带 XDB 组件单机验证、内网小规模、快速搭环境静态资源走数据库并发能力弱APEX Listener独立 Java 进程生产部署、需要独立重启多一个进程要维护mod_plsqlApache 插件已有 Apache 站点集成插件版本与数据库版本绑定死我这边选的是嵌入式网关理由很实际11g 自带不用装 Apache不用配 DAD改端口一条命令的事装完就能访问http://server:8888/apex。代价是它把静态文件和页面渲染都压在数据库进程上几个人做开发没问题真上生产还是换 Listener 稳。选型的时候把这条想清楚后面就不会纠结“为什么页面加载这么慢”。2.3 装之前必须确认的四项参数四项参数里最容易出问题的是表空间。APEX 自己的元数据和上传的静态文件都要地方放不要图省事塞进 SYSAUX那是最常见的“装完能跑、跑两周库告警”的来源。单独建一个表空间初始 100M自动扩展每次 100M上限 1000M这个配置对内部系统完全够。-- 用 sys 登录后执行表空间名与后面 apexins.sql 的参数要一致 CREATE TABLESPACE apex01 DATAFILE /d01/oracle/[SID]/db/apps_st/data/apex01.dbf SIZE 100M AUTOEXTEND ON NEXT 100M MAXSIZE 1000M;DATAFILE的路径必须换成自己库的实际数据文件目录照抄别人的路径是装不上的一号原因AUTOEXTEND ON NEXT 100M表示每次不够就长 100MMAXSIZE 1000M是硬上限防止某个跑飞的会话把磁盘写满。剩下三项端口确认 8888 没被别的服务占用netstat -an | grep 8888确认数据库字符集与应用要展示的中文一致否则后面页面上的中文全是问号确认/apex目录有足够空间4.2.5 解压出来加静态文件要几百兆。这三项都是五分钟能查完、但漏掉要花半天的事。3. 卸载旧版并安装 APEX 4.2.5从 apexins.sql 到 ADMIN 解锁到这一步才是真正动手。整套流程我走过很多遍顺序错一步就要重来尤其是“先卸再装”这个次序跳过去的人最后基本都会在 ADMIN 登录那一步卡住。3.1 先把 11g 自带的 APEX 3.0 清干净卸载不是把目录删掉要用数据库自带的卸载脚本。11g 的$ORACLE_HOME/apex目录下有apxremov.sql以 sys 身份跑一遍它会把 3.0 的 schema 和对象一起清掉。# 以 sysdba 登录数据库执行卸载脚本 sqlplus / as sysdba SQL ?/apex/apxremov.sql脚本会提示确认输入YES之后开始删。跑完之后必须用下面的语句复核只有确认APEX_030200已经不在了才可以进入安装环节。这一步跳过的人后面会遇到“密码怎么改都登不进去”的问题。-- 确认旧版本 schema 是否清理干净 SELECT username, account_status FROM dba_users WHERE username LIKE APEX% ORDER BY username;正常情况下应该只剩APEX_PUBLIC_USER这类公共用户有些版本卸载后连它也没了没关系安装时会重建。如果还能看到APEX_030200说明卸载没跑完手工补一条DROP USER APEX_030200 CASCADE;但注意别在同一个窗口里顺手把别的 APEX 用户一起 drop 了——这一步我吃过亏后面第 5 章会细说。3.2 建表空间与上传解压安装包表空间在第 2 章已经建好这里直接复用apex01。把下载的Apex_4.2.5.zip上传到$ORACLE_HOME下解压到/apex目录。目录权限要给对安装脚本是以 oracle 用户跑的解压出来的文件属主必须是 oracle否则读到一半报权限不足。# 上传后解压注意属主与权限 mkdir -p /apex cd /apex unzip -q /u01/app/oracle/Apex_4.2.5.zip chown -R oracle:oinstall /apex chmod -R 755 /apex ls /apex | headunzip -q是静默解压文件多的时候终端刷屏没意义chown -R oracle:oinstall这一步别省解压出来的文件默认属主是执行解压的那个用户如果当时用的是 root后面apexins.sql会因为读不到images目录而中断。解压完ls一下能看到apexins.sql、apxchpwd.sql、apxremov.sql这些脚本说明包是完整的。3.3 跑 apexins.sql 并处理 ADMIN 与 APEX_PUBLIC_USER安装脚本带四个参数前三个是表空间最后一个是静态资源路径。参数顺序错一个脚本会跑到一半报错退出而且留下半套对象只能重装。cd /apex sqlplus / as sysdba SQL apexins.sql APEX01 APEX01 TEMP /i/四个参数的含义第一个APEX01是放 APEX 元数据的表空间第二个APEX01是放上传文件和静态资源的表空间小环境里合成一个没问题生产建议拆开TEMP是临时表空间写库的默认值即可/i/是静态资源的虚拟路径浏览器要访问/i/下的图标和样式这个值装完再改就要重配网关。脚本跑完会提示安装成功。接着改 ADMIN 密码、解锁两个关键账户-- 修改 ADMIN 密码脚本会交互式要求输入 SQL apxchpwd.sql -- 解锁匿名用户与公共用户不解锁页面直接 404 / 401 SQL ALTER USER ANONYMOUS ACCOUNT UNLOCK; SQL ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK;ANONYMOUS是给未登录页面比如登录页本身用的不解锁连登录框都渲染不出来APEX_PUBLIC_USER是网关到数据库的公共通道它的状态必须是 OPEN。ADMIN 的密码复杂度是真要求必须大写、小写、数字、特殊符号四类齐全输一个纯小写密码脚本会直接拒绝——这不是找麻烦是防止有人图省事设成admin。3.4 配置嵌入式 PL/SQL 网关与 8888 端口数据库里对象都建好了但浏览器还进不来因为 HTTP 通道没开。EPG 的端口用DBMS_XDB改改完不需要重启数据库几秒生效。-- 把 XDB 的 HTTP 端口改成 8888并确认结果 SQL EXEC DBMS_XDB.SETHTTPPORT(8888); SQL SELECT DBMS_XDB.GETHTTPPORT FROM DUAL;SETHTTPPORT接受字符串或数字返回的GETHTTPPORT应该是 8888。如果这一步之后访问http://server:8888/apex还是 404大概率是 XDB 组件本身没初始化检查SELECT COMP_NAME, STATUS FROM DBA_REGISTRY WHERE COMP_IDXDB;状态不是 VALID 就得先把它补起来。这个 404 和“页面不存在”的 404 长得一样但原因完全不同别在 APEX 安装上反复重来。还有一步是给APEX_040200授予外部主机访问权限。4.2.5 的对象全部挂在APEX_040200这个 schema 下网关代它发请求时如果没有连接权限页面图标会缺、调用外部服务会报 ORA-24247。11g 里的常见做法是建一条 host 级 ACLBEGIN DBMS_NETWORK_ACL_ADMIN.CREATE_ACL( acl apex_net.xml, description APEX 4.2.5 outbound connect, principal APEX_040200, is_grant TRUE, privilege connect); DBMS_NETWORK_ACL_ADMIN.ASSIGN_ACL( acl apex_net.xml, host *); END; /principal必须写成APEX_040200写成APEX_PUBLIC_USER不生效因为真正持有对象的不是它host *是放开所有主机内网环境图省事可以这么写对外暴露的库建议把 host 收窄到具体域名。跑完这条管理入口就通了http://server:8888/apex/apex_admin。第一次打开会让你改 ADMIN 密码这是个好机会把第 3.3 步设的临时密码换掉。3.5 中文语言包与管理入口确认需要用中文界面的装完主程序再补语言包脚本在解压目录的builder/zh-cn下文件名形如load_zh-cn.sql以 sys 身份跑一遍即可。这一步是可选的但建议装上后面给业务方看页面的时候英文菜单会增加一轮解释成本。装完先别急着建应用用 ADMIN 登一次管理后台能看到工作空间列表就说明前面全部通过。管理入口和普通入口是两个地址别混# 管理入口建工作空间、管用户 http://server:8888/apex/apex_admin # 应用入口开发者与最终用户登录 http://server:8888/apex4. 账户、工作空间与开发侧配置ADMIN、Schema 与页面的三层落地做到 Apex Oracle 深入开发这一步装的问题基本过去了接下来是“装完怎么让它真的能干活”。APEX 的权限模型是三层ADMIN 管全局Workspace 管一个工程Developer 管具体应用。这三层如果对应错了后面会出现“开发者看不到自己建的应用”“应用能打开但查不到数据”这类问题。4.1 ADMIN、Workspace 与 Schema 的对应关系ADMIN 是 APEX 的超级管理员能建、能删、能改工作空间也能给工作空间指定管理员。它本身不参与业务开发只在管理入口活动。Workspace 是工作空间一个工作空间对应数据库里的一个 Schema。把它理解成一个工程最直观工程里面挂很多子项目子项目就是 Application。与 EBS 集成开发时一个 Application 可以类比成 EBS 里的一张 FormForm 里有多个窗口Application 里有多个页面。这个对应关系决定了数据从哪来工作空间绑的 Schema 有权访问哪些表开发者就能在应用里查到哪些数据。绑定 Schema 的时候要慎重绑错了不是改个配置就能解决的得重建工作空间。4.2 用 APPS 做 Schema 建工作空间并分配 Developer和 EBS 集成时工作空间绑的 Schema 通常是 EBS 的APPS这样应用里能直接查 EBS 的视图和表不用做数据同步。建工作空间的入口在 ADMIN 登录后的管理后台填三个东西工作空间名、Schema 名、该工作空间的管理员账号。建完之后用这个工作空间的管理员账号登录普通入口再往下分两种用户Developer 负责建应用、改页面应用最终用户只有运行权限看不到设计器。这两种用户分开是为了避免业务方在自己的账号里点进设计器把页面改坏——这种事故在小团队里并不罕见。EBS 里的调用入口配置在系统管理员职责下把 APEX 页面的 URL 挂成函数或者菜单项即可。配置时注意 URL 里带不带 Session带 Session 的链接不能复用每次从 EBS 进来都要重新生成。这个细节不写进配置文档接手的人一定会踩。4.3 Page 0 与 Grid Layout布局参数怎么配Page 0 是整个应用的全局页全局变量、全局常量都放这一页。它的区域不会显示在界面上效果类似 HTML 里的 hidden 字段。我的习惯是不同类型的分区放不同区域命名带前缀后面查问题时不用逐个点开看。布局这块是 4.1.1 和 4.2.5 差别最大的地方。4.1.1 里 Region 的 Column 属性是全局的改一个区域同 Body 下所有区域跟着变4.2.5 给每个区域独立的 Grid Layout可以逐级重排。选主题之后页面大体由 DIV CSS 定型常用的可配置区域是 Body1 到 Body3、Position1 到 Position4其中 Body 区域在 HTML 里渲染成TABLEPosition 区域渲染成DIV。Grid Layout 三个参数对应三条 HTML 规则理解了就不用死记APEX 参数对应 HTML作用Start New Grid新开一个TABLE该区域是否脱离上一个表格重新定义列数Start New RowTR该区域是否换行显示Column第几个TD该区域落在当前行的第几列举个实际排布Search1、Search2、Search3 三个区域同属一张表Column 依次填 1、2、2Start New Grid 依次填 Yes、No、NoStart New Row 依次填 Yes、No、Yes。翻成 HTML 就是第一行两个格子1 和合并后的 2第二行再占一个格子。更复杂的嵌套同理把每个子区域当成独立的格子去算配配就出来了不需要写一行 CSS。4.4 控件属性、校验与 Dynamic Action 的落地写法控件本身没什么好讲的下拉框、值列表、文本框、日期选择、报表拖出来就能用。真正决定体验的是属性、事件、校验这三块。属性里常用的Form Element Width控宽、Horizontal / Vertical Alignment控位置、Value Required控必填、Condition Type控显示条件、Read Only Condition Type控只读条件、Default value给默认值、Format Mask控格式掩码。事件里Condition Type是执行前提True Actions/False Actions是真假分支WHEN Condition是动作本身的判断条件。校验里When Button Pressed绑触发按钮Condition Expression是校验前提Error message display location控错误信息显示位置。把这些串起来的一个例子点击 Search 按钮时校验文本项P1_X_TEXT是否为空前提是demo_user_t表里存在user_id123的记录。-- 校验类型选 Function Returning Boolean -- 前提条件类型选 Exists (SQL query returns at least one row) -- 前提表达式 SELECT 1 FROM demo_user_t t WHERE t.user_id 123; -- 校验表达式 BEGIN IF :P1_X_TEXT IS NOT NULL THEN RETURN TRUE; END IF; RETURN FALSE; END;校验类型必须选返回布尔值的函数返回 TRUE 表示通过P1_X_TEXT前面的冒号不能漏漏了会被当成列名而不是页面项前提表达式只判断是否存在不返回具体值写成SELECT COUNT(*)也能跑但语义上不如SELECT 1直接。再一个是 Dynamic Action无刷新交互基本靠它。要在页面加载完把日期项DATA设成当前日期-- 事件Page Load条件类型不设条件 -- 真动作Set ValueSet Type 选 SQL Statement SELECT SYSDATE FROM DUAL; -- 受影响元素Item(s)选 DATASet Type选 SQL Statement 而不是 Static Assignment是为了拿数据库的当前时间而不是客户端时间——服务器在哪个时区业务方看到的就应该是什么时间这一点在跨时区协作的项目里尤其重要。另一个常见用法是值变化时显示或隐藏区域事件选 ChangeWhen Selection Type选 Item(s)When Item(s)填P2_X_TEXT条件填is not null真动作 Hide Region、假动作 Show Region。4.5 Tabular Form 的视图与提交过程记录增删改通常的做法是跳到新页面改单条但 Tabular Form 可以在一个表格里批量改多行并且挂客户化逻辑用起来更像 EBS 的 Form。它基于视图开发视图建不对后面全白搭。-- 基础表 CREATE TABLE demo_class_t ( class_id NUMBER, class_name VARCHAR2(50) ); -- 供 Tabular Form 使用的视图必须能唯一定位到一行 CREATE OR REPLACE VIEW demo_class_v AS SELECT t.user_id, t.resp_id, t.resp_appl_id, t.login_name, c.class_name FROM demo_user_t t, demo_class_t c WHERE c.class_id t.class_id;视图里的多表关联必须保证连接条件唯一否则一个用户会查出多行提交时 APEX 无法判断改的是哪一条Apply Change点了没反应——这是 Tabular Form 最常见的失败原因不是权限问题。页面建好后加一个 Region Button命名为APPLY_CHG再建一个 Process 绑定到这个按钮用来实现客户化逻辑当class_name不存在于demo_class_t时抛错存在时把勾选的记录写入另一张表。Process 的执行点选On Submit - After Computations and ValidationsWhen Button Pressed填APPLY_CHG。这样点击按钮后的顺序是先做条目级校验再跑 Process最后刷新表格。顺序配反了会出现“错误提示闪一下就没了、数据也没写进去”的现象。5. 常见问题排查五条装完才发现的坑APEX 的报错特别不友好一个 404 可能是端口问题也可能是 schema 问题还可能是静态资源路径问题。下面五条是我在虚拟机、内网服务器和客户现场反复碰到的按现象、原因、解决三段记遇到同类问题可以对照。5.1 安装期的三条记录第一条ADMIN 密码改了三次管理后台还是提示用户名或密码无效。现象是密码通过 SQLPlus 改、重启数据库、重启监听都试过登录依旧失败用 SQLPlus 以 ADMIN 身份连库反而正常说明账号本身没锁。原因是 11g 自带的 APEX 3.0 没有被彻底卸载APEX_030200及其授权记录还在库里管理入口的登录校验命中了旧引擎的账户表改的是新版本的密码校验的是旧版本的记录。解决方式是回到第 3.1 步先SELECT username FROM dba_users WHERE username LIKE APEX%;确认残留再跑apxremov.sql或者手工DROP USER APEX_030200 CASCADE;然后重新安装。判断技巧很简单如果改密码这件事“完全无效”问题一定不在密码本身。第二条访问http://server:8888/apex一直 404但数据库连接一切正常。现象是 SQL*Plus 能连tnsping正常EM 也能进就是 APEX 页面不出来。原因通常是 EPG 的 HTTP 端口没开或者被人改过XDB 组件默认端口是 8080之前有人为了避让冲突改过一次恢复环境后配置丢了。解决是先查实际端口SELECT DBMS_XDB.GETHTTPPORT FROM DUAL;不是 8888 就重新EXEC DBMS_XDB.SETHTTPPORT(8888);然后把 XDB 组件状态查一遍STATUS不是VALID的先用?/rdbms/admin/catqm.sql之类的方式补。别看到 404 就以为是安装失败重新装一遍重装解决不了端口问题。第三条清理旧用户时把APEX_040200一起 drop 了全站立刻不能访问。现象是执行完DROP USER xxx CASCADE;之后所有 APEX 页面返回 500管理入口直接白屏。原因是 APEX 4.2.5 的全部对象都挂在APEX_040200这个 schema 下CASCADE是不可逆的对象删干净了没有回收站。解决只有一条路清空环境重装把apxremov.sql跑一遍再执行apexins.sql。所以清理用户的标准动作是先查再删-- 先看清楚有哪些用户再决定删谁 SELECT username FROM dba_users WHERE username LIKE APEX% OR username LIKE FLOWS% ORDER BY username; -- 确认无误后单独下刀不要写成一条批量语句 DROP USER APEX_030200 CASCADE;5.2 开发和上线前的两条记录第四条页面能打开但图标缺、样式错乱或者调外部接口报 ORA-24247。现象是文字都在、布局也在就是图标全是空白方块或者 Dynamic Action 里调用外部 HTTP 服务时抛ORA-24247: network access denied by access control list。原因是APEX_040200没有 host 级的 connect 权限11g 起网络访问受 ACL 管控默认全部禁止。解决就是第 3.4 步那段 ACL 脚本principal一定要写APEX_040200。有一点要注意ACL 建完不一定立刻生效如果还报错查一下SELECT * FROM DBA_NETWORK_ACLS;和DBA_NETWORK_ACL_PRIVILEGES确认 assign 真的挂上了。这类问题最容易被误判成“安装包不完整”实际上是权限。第五条Tabular Form 改了数据点 Apply Change 提示成功表里没变。现象是界面提示 “Action Processed”回来一看数据原样。原因有三个按概率排序视图没有唯一定位行的字段APEX 不知道该更新哪一行Process 没绑定When Button Pressed或者按钮类型设成了Redirect而不是SubmitProcess 执行点选在了校验之前校验一失败整个流程就断在那儿。解决是先把视图改对基于主键或 rowid 关联再确认按钮类型最后确认 Process 的执行点。调试的时候可以在 Process 里临时加一句往日志表写记录跑一次看它到底有没有进去——比盯着页面猜快得多。6. 装完怎么验证跑通三条查询加一个页面装完不验证等于没装。我的习惯是先跑三条查询再开一个空应用走一遍最小闭环整个过程十分钟能挡住后面 80% 的返工。第一条查版本确认跑的确实是 4.2.5SELECT version_no FROM apex_release;返回4.2.5说明安装脚本跑对了。如果返回 3.0 系列说明 11g 自带的那套还在生效回到第 3.1 步重新卸载。第二条查网关端口和账户状态一条语句看完SELECT DBMS_XDB.GETHTTPPORT AS http_port FROM DUAL; SELECT username, account_status FROM dba_users WHERE username IN (APEX_040200,APEX_PUBLIC_USER,ANONYMOUS);http_port是 8888三个账户状态都是OPEN这两项对了端口和权限层面就不会再出问题。第三条是页面级验证别只看登录页。用 ADMIN 进管理后台建一个空应用在建好的页面里放一个文本框、一个按钮、一条校验把第 4.4 步那段 PL/SQL 校验表达式贴进去然后故意留空点按钮——看到红字X_TEXT1 cant be null说明页面渲染、条目提交、校验链路、错误信息定位四个环节全部通了。再放一个 Page Load 型 Dynamic Action 给日期项赋SYSDATE页面打开时日期自动填上说明 Dynamic Action 也正常。把这些整理成一张表每次装完照着打勾验证项命令或操作预期结果版本SELECT version_no FROM apex_release;4.2.5网关端口SELECT DBMS_XDB.GETHTTPPORT FROM DUAL;8888关键账户查DBA_USERS三个都是 OPEN管理入口打开/apex/apex_admin能登录能看到工作空间列表页面链路空应用里跑一次必填校验显示自定义错误信息无刷新交互Page Load 时给日期项赋 SYSDATE打开即显示当前日期从那以后我每装完一套 APEX都强制走一遍这三条查询加一个空应用不管多急都不跳。血泪经验是装完直接建业务应用问题会以“页面某个按钮没反应”这种形式出现到那时候你得在几百个页面项里找原因而用空应用验证问题会以“校验不生效”的形式直接暴露在最小上下文里一眼就能定位。这套顺序希望帮到你。本文还有配套的精品资源点击获取
