ORACLE APEX · RELEASE 26.1
Oracle APEX 开发者指南
中文专业译编版
面向 Oracle APEX 专业开发、架构设计与企业交付，按中文技术文档阅读习惯重组内容，并补充企业工程实践建议。
25 CHAPTERS
章节导航
每章为独立 HTML 页面，可通过左侧导航、章节卡片或上一页/下一页快速切换。
Oracle APEX 概览
Oracle APEX 是一个完整的低代码平台，用于快速构建安全、可扩展、规模与复杂度不限的企业应用。开发者在浏览器中使用 App Builder，通过配置内置组件和数据源定义页面与功能；只有真正属于业务特性的逻辑才…
使用本地数据
企业应用以数据为核心。虽然 APEX 能方便地集成远程数据，但多数 APEX 应用仍以本地表和视图作为主要数据源。APEX 引擎和 App Builder 运行在 Oracle Database 中，本地数据访问具备…
简化用户体验设计
APEX 通过页面向导、页面设计器、通用主题和声明式动态操作，降低企业应用用户体验设计的成本。页面保存后可立即运行，无需额外编译或发布步骤，开发者可以在“设计 - 运行 - 调整”循环中持续优化。
在页面中引用数据值
APEX 页面经常需要在 HTML 表达式、模板指令、SQL、PL/SQL 和动态操作中引用页面项、应用项、内置替换字符串或报表列。关键是根据上下文选择正确语法，并理解所有页面项值在绑定时首先表现为字符串。
数据可视化与分析
APEX 原生区域能够以报表、卡片、图表、地图、日历和树等形式展示数据。开发者选择适合任务的区域类型，配置数据源和属性，即可获得分页、交互、响应式和可访问性能力。
增强最终用户搜索
搜索是企业应用的基础能力。APEX 提供分面搜索、智能筛选器、统一搜索区域以及页面项查询示例（QBE）等多种模式，可按数据规模、页面空间和用户任务组合使用。
使用插件增加功能
当原生 APEX 能力不足时，可以通过模板组件和插件扩展平台。扩展应遵循可复用、可升级、可审查和安全的原则。
理解页面流与会话状态
APEX 应用通过导航菜单、导航栏、分支、对话框和面包屑组织用户流程；会话状态在页面请求之间保存临时值。理解“呈现 - 提交 - 处理 - 分支”的生命周期，是构建可靠页面的基础。
在网格中编辑数据
Interactive Grid（交互式网格）为表格数据提供滚动、筛选、排序、分组、下载和多行编辑。用户可在一次保存中插入、更新和删除多行，APEX 负责跟踪每行状态。
使用主从数据
主从页面用于维护一对多关系，例如部门与员工、订单与订单行。APEX Create Page 向导提供多种模式，可根据用户任务选择。
使用用户与角色控制访问
安全设计需要同时处理身份验证、授权和数据访问。身份验证回答“用户是谁”；授权回答“用户能访问哪些功能”；行级数据安全回答“在同一功能中用户能看到哪些记录”。三者应形成纵深防御，而不是只依赖隐藏菜单或按钮。
应用人工智能
APEX 可把生成式 AI、AI Agent 和向量搜索嵌入企业应用。AI 功能应建立在明确的数据权限、工具契约、输入输出验证和人工监督之上。
集成远程数据
本地数据库访问性能最佳，但企业应用经常需要访问远程 Oracle/MySQL 数据库、Fusion Applications 或第三方 REST API。APEX 通过 REST-Enabled SQL、Web Cr…
暴露集成 API
APEX 应用可以通过 ORDS 向外部系统提供 REST API，并复用与页面相同的数据库业务逻辑。推荐把业务规则放在包中，由 APEX 页面和 ORDS Handler 共同调用。
地址地理编码
地理编码把文本地址转换为经纬度。获得坐标后，可以在地图上显示位置、计算距离、判断服务范围和执行空间搜索。
上传、查看与下载文件
APEX 支持把图片和文件保存到数据库 BLOB、临时文件区或 OCI Object Storage。设计时要同时考虑存储位置、MIME 类型、文件名、访问权限、内联显示、下载和生命周期。
装载外部数据
APEX 可从 Excel、XML、JSON 和 CSV 装载数据。Data Load Definition 描述外部数据结构与目标表的映射；Data Loading 页面提供上传、预览、校验和装载体验；APEX_D…
组织逻辑与后台执行
Execution Chain（执行链）用于把多个相关页面处理组织成分层顺序，并可把长时间任务移到后台。这样既改善页面可读性，也避免用户等待超时。
执行重复性处理
Automation（自动化）是共享组件中的计划任务，可按时间表达式运行，也可按需触发。它由 Source Query、初始化代码、条件和一组顺序动作组成。
通知最终用户
APEX 可通过页面成功/错误消息、电子邮件和 Web Push 通知用户。通知设计应明确受众、时机、内容、可执行链接和失败处理。
生成像素级精确报表
Report Query 与 Report Layout 组合生成 PDF。Report Query 定义数据及 JSON 结构；Report Layout 使用 Word 或 Excel 模板定义最终版式。远程打印…
翻译应用
APEX 通过 Text Messages、Application Translations、XLIFF 导出导入和可筛选网格支持多语言应用。主语言应用是设计源，翻译语言由同步后的文本消息生成。
理解应用生命周期
APEX 应用会持续演进。团队需要管理应用导出、数据库对象、静态文件、环境配置、工作副本和源代码控制，形成可重复发布流程。
使用 APEXlang
APEXlang 是应用元数据的文本表示，可在 App Builder 内查看，也可在 VS Code、SQLcl 和 AI 编码智能体中使用。它使 APEX 应用能够进入现代代码审查、差异比较和自动化工具链。
自动化业务流程
APEX Workflow 用于编排跨人员、系统和时间跨度的业务过程。工作流由活动和连接组成，可执行代码、调用 API、发送通知、创建人工任务、等待外部信号、分支和循环，并在运行时显示进度。
关于本译编#
译编与术语原则#
- Oracle APEX 产品界面已有稳定叫法的，优先采用 APEX 专业术语，例如：区域、页面项、动态操作、共享组件、会话状态、授权方案、REST 数据源、模板组件、执行链、自动化和工作流。
- 第一次出现的重要英文界面名采用“中文（English）”形式；后续视上下文保留英文，以便读者直接在 App Builder 中定位。
- SQL、PL/SQL、JavaScript、JSON、CSS、HTML、URL、API、对象名、绑定变量和替换字符串不翻译。
- 原书中的示例数据名称（EMP、DEPT、Woods HR、Woods Clinic 等）保持不变。
- “Related Topics”统一整理为章节末的“延伸阅读方向”，不重复逐条列出链接。
- 译编增补内容以“工程实践建议”标识，用于帮助企业团队将原书知识转化为可维护的实施方案。
阅读导航#
以下导航按原书结构覆盖 25 章，并附企业实施与制造业落地建议。Word 导航窗格和 PDF 书签可按章节快速跳转。
核心术语速查#
| 英文术语 | 本译编用语 | 说明 |
|---|---|---|
| App Builder | App Builder（应用构建器） | APEX 应用设计与维护入口 |
| Page Designer | 页面设计器 | 页面组件、布局、动态操作和处理逻辑的主要设计器 |
| Property Editor | 属性编辑器 | 配置所选组件属性的面板 |
| Region | 区域 | 页面中承载报表、表单、图表、地图等内容的组件 |
| Page Item | 页面项 | 页面输入、显示或临时保存值的控件 |
| Dynamic Action | 动态操作 | 响应浏览器端事件并执行一个或多个动作 |
| Shared Components | 共享组件 | 在应用内复用的 LOV、导航、身份验证、授权、模板等 |
| List of Values (LOV) | 值列表（LOV） | 为列表型页面项提供显示值和返回值 |
| Session State | 会话状态 | APEX 为当前用户会话保存的页面项、应用项等临时值 |
| Interactive Report | 交互式报表 | 允许最终用户筛选、排序、分组、计算和保存报表视图 |
| Interactive Grid | 交互式网格 | 支持丰富表格交互和多行编辑的区域 |
| Classic Report | 经典报表 | 由开发者控制展示和分页方式的轻量报表 |
| Faceted Search | 分面搜索 | 通过多个分面条件逐步缩小结果范围 |
| Smart Filters | 智能筛选器 | 紧凑型搜索区域，以单一输入框承载多个筛选器 |
| Template Component | 模板组件 | 基于 HTML、模板指令和自定义属性构建的可复用组件 |
| Authentication | 身份验证 | 确认用户是谁 |
| Authorization | 授权 | 判断已登录用户能否访问页面、组件或执行操作 |
| REST Data Source | REST 数据源 | 将远程 REST API 数据声明式映射为 APEX 可用的行列数据 |
| Web Credential | Web 凭据 | 安全保存访问远程服务所需的凭据信息 |
| Execution Chain | 执行链 | 对一组页面处理进行分层、排序及后台执行 |
| Automation | 自动化 | 按计划或按需重复执行的共享组件 |
| Workflow | 工作流 | 编排跨人员、系统和时间跨度的业务过程 |
| APEXlang | APEXlang | APEX 应用元数据的开放、可读文本表示 |