APEX开发实践（25）- APEX & EBS集成开发指导

本文参考了Oracle官方的文档《Extending Oracle E-Business Suite Release 12.2 using Oracle APEX》（2024年11月更新的5.1版本）。

版本要求

Oracle EBS： 12.2.7 或以上版本

Oracle DB：19c 或以上版本

APEX：24.1 或以上版本

ORDS：24.3 或以上版本

基本概念

APEX可以直接对EBS的数据进行开发，创建基于EBS数据的应用。可以通过数据库视图访问EBS的APPS schema，并查询（SELECT）数据。但不能对EBS的数据直接进行增删改（INSERT，DELETE，UPDATE）的操作。这在EBS中是绝对禁止的。APEX只能通过EBS提供的开放的公共的API接口对EBS数据进行增删改的操作。

APEX的EBS扩展可以无缝集成EBS的验证和授权。APEX应用可以使用EBS的登录验证。APEX包括了预设置的验证机制，通过HTTP头的变量使用Oracle访问管理（Oracle Access Manager - OAM）。如果EBS使用了OAM做登录验证，APEX和EBS的统一登录验证就变成一件很简单的事情。否则，需要在EBS的APPS schema里写APEX用户访问的验证函数。

APEX与EBS集成的架构

应用服务器架构

Oracle建议分别单独部署APEX的应用服务器和EBS的应用服务器（如下图）。一套用于部署ORDS，另一套用于部署EBS。

数据库架构

Oracle建议在EBS的数据库上配置APEX（如下图）。在EBS数据库中将配置两个schema。一个是APEX_230100，用于部署APEX引擎。另一个是XX_APEX。给XX_APEX授权访问EBS的数据后，APEX应用可以通过XX_APEX访问EBS的数据。Oracle禁止APEX的应用直接访问EBS的schema APPS。

环境准备

APEX版本：24.2

ORDS版本：23.2.2。(官方建议24.3或更高版本)

地址：http://ds.jasolar.com:8080/ords/appsdev/

Oracle RDBMS : 19.0.0.0.0

Oracle Applications : 12.2.7 +相对应的补丁

地址：http://jjl1u.jasolar.com:8000/OA_HTML/AppsLogin

补丁要求

Oracle Weblogic补丁：10.3.6.231017的PSU，补丁号35586779（注：由于EBS12.2.7已经进入Extend Support，不能直接从Oracle支持官网下载）；
Oracle Application框架补丁：R12.FWK.C，补丁号36839803；
Oracle EBS补丁：
- R12.AD.C，补丁号：36119925
- R12.TXK.C，补丁号：36117775
- R12.ATG_PF.C，补丁号：36034949

所有的补丁下载连接：

ERP_APEX集成开发所需补丁

打完这些补丁之后，要用SQLPlus执行ADAPEXSCHREG.sql把APEX用户注册到ERP中。这个sql脚本在$AD_TOP/patch/115/sql/目录下。依照APEX EBS的命名规则，本案例中，APEX的用户为XX_APEX。执行的脚本示例如下：

sqlplus apps/<APPS password> @$AD_TOP/patch/115/sql/ADAPEXSCHREG.sql XX_APEX

验证示例

验证的目的是通过APEX一个表单，去更新APPS用户里的用户数据（邮箱）。如前述，APEX的用户是XX_APEX，不能直接对APPS用户里的表进行增删改的操作。在ERP里用APPS创建一个叫xx_apex_ebs_user的视图，然后调用一个叫xx_apex_sample_apis的程序包。APPS用户下创建这张视图和程序包如下：

xx_apex_ebs_user视图：

注：视图仅仅是为了XX_APEX的表单读取apps.fnd_user表的用户数据。

CREATE OR REPLACE VIEW xx_apex_ebs_user
( user_id
, user_name
, start_date
, end_date
, description
, email_address
, user_guid
, person_party_id
, CONSTRAINT APEX_EBS_USER_pk
PRIMARY KEY (user_id)
RELY DISABLE NOVALIDATE
)
AS
SELECT user_id
, user_name
, start_date
, end_date
, description
, email_address
, user_guid /* Used for Single-Sign On */
, person_party_id /* FK to party information */
FROM fnd_user;

GRANT READ ON xx_apex_ebs_user TO XX_APEX;
GRANT READ on fnd_responsibility_vl TO XX_APEX;

xx_apex_sample_apis

注：程序包也不是直接更新apps.fnd_user表的数据，而是通过调用fnd_user_pkg.updateuser（）来更新。

create or replace package xx_apex_sample_apis as
function apex_validate_login (  p_username   in  varchar2
                              , p_password   in  varchar2
                             ) return boolean;

procedure apex_update_email (  p_username        in varchar2
                             , p_owner           in varchar2
                             , p_email_address   in varchar2
                            );

end;
/

create or replace package body xx_apex_sample_apis as
function apex_validate_login (  p_username   in  varchar2
                              , p_password   in  varchar2
                             ) return boolean
is
begin
    return fnd_user_pkg.validatelogin(p_username, p_password);
end apex_validate_login;

procedure apex_update_email (  p_username        in varchar2
                             , p_owner           in varchar2
                             , p_email_address   in varchar2
                            )
is
begin
    wf_event.setdispatchmode('async');
    fnd_user_pkg.updateuser(x_user_name=>p_username, x_owner=>p_owner, x_email_address=>p_email_address);
end apex_update_email;

end xx_apex_sample_apis;
/
show errors

grant execute on xx_apex_sample_apis to XX_APEX;

APEX端的表单创建不在本文详述，参考P31~P32页关于获取用户信息的设置和操作。

在APEX的共享组件里创建3个应用级的项：EBS_APP_ID，EBS_RESP_ID，EBS_SEC_GROUP（用户ERP和APEX之间传参）；
在APEX的页中，在呈现前（Pre_Rendering）创建一个处理，获取用户信息；

begin
for c1 in (select responsibility_name
, description
from apps.fnd_responsibility_vl
where application_id = :EBS_APP_ID
and responsibility_id = :EBS_RESP_ID
) loop
:P4_RESPONSIBILITY_NAME := c1.responsibility_name; //注意修改项ID
:P4_RESP_DESCRIPTION := c1.description; //注意修改项ID
end loop;
exception
when others then
null;
end;