ORACLE WEBADI 开发示例

一、建表

create table SGQ_WEBADI_DEMO

(

ADI_ID NUMBER,

ADI_ORGANIZATION_ID NUMBER,

ADI_CODE VARCHAR2(30),

ADI_NAME VARCHAR2(100),

ADI_DATE DATE

);

二、创建同义词

SQL> CREATE PUBLIC SYNONYM SGQ_WEBADI_DEMO FOR SGQ_WEBADI_DEMO;

Synonym created

三、创建序列

SQL> CREATE SEQUENCE SGQ_WEBADI_DEMO_S;

Sequence created

四、创建序列同义词

SQL> CREATE PUBLIC SYNONYM SGQ_WEBADI_DEMO_S FOR SGQ_WEBADI_DEMO_S;

Synonym created

五、插入测试数据

SQL> INSERT INTO SGQ_WEBADI_DEMO VALUES(1,83,'TEST01','青羊支行',SYSDATE);

1 row inserted

SQL> commit;

Commit complete

六、登记表

参数的涵义分别为:所有者、表名、扩展（T自动，S非自动）下一区，自由、已使用

：所有者、表名、列字段名、序号、类型、字段宽度、是否为空，是否可以转换。

SQL> BEGIN

ad_dd.register_table('XXT','SGQ_WEBADI_DEMO','t');

ad_dd.register_column('XXT','SGQ_WEBADI_DEMO','adi_id',1,'number',38,'y','n');

ad_dd.register_column('XXT','SGQ_WEBADI_DEMO','adi_organization_id',2,'number',38,'y','n');

ad_dd.register_column('XXT','SGQ_WEBADI_DEMO','adi_code',3,'varchar2',30,'y','n');

ad_dd.register_column('XXT','SGQ_WEBADI_DEMO','adi_name',4,'varchar2',100,'y','n');

ad_dd.register_column('XXT','SGQ_WEBADI_DEMO','adi_date',5,'date',9,'y','n');

COMMIT;

END;

/

PL/SQL procedure successfully completed

七、创建视图

SQL> create or replace view sgq_webadi_demo_v as select * from sgq_webadi_demo;

View created

八、创建包

SQL> CREATE OR REPLACE PACKAGE SGQ_WEBADI_DEMO_PKG IS

PROCEDURE UPLOAD_DATA(P_ID IN NUMBER,

P_ORGANIZATION_ID NUMBER,

P_CODE IN VARCHAR2,

P_NAME IN VARCHAR2,

P_DATE IN DATE);

END;

/

Package created

SQL> CREATE OR REPLACE PACKAGE BODY SGQ_WEBADI_DEMO_PKG IS

PROCEDURE UPLOAD_DATA(P_ID IN NUMBER,

P_ORGANIZATION_ID NUMBER,

P_CODE IN VARCHAR2,

P_NAME IN VARCHAR2,

P_DATE IN DATE) IS

BEGIN

IF P_ID IS NULL THEN

INSERT INTO SGQ_WEBADI_DEMO

(ADI_ID, ADI_ORGANIZATION_ID, ADI_CODE, ADI_NAME, ADI_DATE)

SELECT SGQ_WEBADI_DEMO_S.NEXTVAL,

P_ORGANIZATION_ID,

P_CODE,

P_NAME,

P_DATE

FROM
DUAL;

ELSE

UPDATE SGQ_WEBADI_DEMO T

SET T.ADI_ORGANIZATION_ID = P_ORGANIZATION_ID,

T.ADI_CODE = P_CODE,

T.ADI_NAME
= P_NAME,

T.ADI_DATE = P_DATE

WHERE T.ADI_ID = P_ID;

END IF;

END;

END SGQ_WEBADI_DEMO_PKG;

/

Package body created

九、创建集成器

9.1 Desktop Integrator -->创建文档(Create Document)



9.2选择“HR集成器设置”,下一步



9.3 查看程序选择“EXCEL 2003”，否则可能会有问题。
报告框不要选，否则不能编辑上传。下一步。



9.4 内容选择“无”，下一步。



9.5 点击“创建文档”。



9.6 保存并打开文档





9.7 文档创建完成后，点弹出界面的关闭按钮，并编辑（注意点一下加载列的第一个单元格，用来进行标记，本测试后续导入时，只导入标记的行）。



以上内容填写如下：



9.8 加载到EBS（加载项-ORACLE-加载）



9.9选择标记的行，点击加载





9.10 验证，因为在中文环境下创建的集成器，所以查看时如果无数据，则要先初始化语言环境，再进行一遍查询操作。

SQL> alter session set nls_language='SIMPLIFIED CHINESE';

Session altered

SQL> SELECT BNI.APPLICATION_ID, --应用ID

2 BNI.INTEGRATOR_CODE, --集成器代码

3 BNI.USER_NAME --集成器名称

4 FROM BNE_INTEGRATORS_VL BNI

5 WHERE BNI.USER_NAME = 'SGQ_WEBADI_DEMO';

APPLICATION_ID INTEGRATOR_CODE USER_NAME

---------------- ------------------------------ ------------------------------

20003 GENERAL_141_INTG SGQ_WEBADI_DEMO

十、维护集成器表单功能关联

10.1 Desktop Integrator -->创建文档(Create
Document)



10.2 选择“HR 维护集成器表单功能关联”（HR
Maintain Integrator Form Function Associations）,下一步



10.3 选择EXCEL 2003 ，报告前面的框不打勾，理由参见上面说明，，下一步。



10.4 选择内容参数



PS：应用程序简称为本系统的客户化应用名称XXT，其他系统按之前加载时导入的“应用程序简称”填写。同样，集成器用户名也是在之前加载时定义的。填写完成后，继续。

10.5 复查，无问题，则点击“创建文档”。



10.6 保存文件并打开



文档创建后如图：



表单功能列表字段暂不填写，我们定义此功能名称后再进行填写。

十一、定义功能

11.1 进入路径：应用开发员-->应用产品-->功能

a)在说明选项卡，填写如下:



其中,SGQ_WEBADI_FUNCTION为自定义的功能。

b)在特性选项卡，填写如下：



功能： SGQ_WEBADI_FUNCTION

用户功能名：SGQ_WEBADI_FUNCTION

类型：子函数

保存退出当前界面。

十二 添加功能到菜单

12.1 进入路径：应用开发员-->应用产品-->菜单

a)查找DESKTOP INTEGRATION MENU,添加一行,功能列填写：SGQ_WEBADI_FUNCTION，即上面定义的功能。提示列保存为空。然后保存退出。



十三、填写第十步创建的表单功能EXCEL中的表单功能列表，并进行加载





13.1 验证

SQL> alter session set nls_language='SIMPLIFIED CHINESE';

Session altered

SQL> SELECT BNI.APPLICATION_ID,

BNI.INTEGRATOR_CODE, --集成器CODE

BNI.USER_NAME, --集成器名称

BSR.SECURITY_VALUE --功能CODE

FROM BNE_INTEGRATORS_VL BNI

JOIN BNE_SECURITY_RULES BSR ON (BSR.APPLICATION_ID = BNI.APPLICATION_ID AND

BSR.SECURITY_CODE = BNI.INTEGRATOR_CODE)

WHERE BNI.USER_NAME = 'SGQ_WEBADI_DEMO';

APPLICATION_ID INTEGRATOR_CODE USER_NAME SECURITY_VALUE

---------------- ------------------------------ ------------------------------ ------------------------------

20003 GENERAL_141_INTG SGQ_WEBADI_DEMO SGQ_WEBADI_FUNCTION

十四、定义布局

14.1 Desktop Integrator -->定义布局



14.2 选择刚创建的集成器（本例为SGQ_WEBADI_DEMO），查找。再点创建



14.3 填写如下：输入自定义的布局名称SGQ_WEBADI_DEMO_LAYOUT，题头数不用管，下一步。



14.4 选择相关字段展示区域



必须字段里面的ORGANIZATION_ID改为题头，其他全部为行。

改为题头，则字段显示的Header里面，如果改为行，则显示在行里面。必需字段是自动出来的API PROCEDURE NAME里面的参数列表，并去提了前面的P_,我们可以安排这些字段的显示区域，（Header或者Line）

注意：

1.这些值将传给API PROCEDURE NAME，也就是参数列表，一行一次，不管是Header还是Line。

2.视图的字段名和变量名P_XXX，变量名去年P_前缀后，最好不要和视图里面的字段名相同。

因此在EXCEL里面显示的参数是分题头、行、传递给API PRECECURE NAME时是并列的，至于在API PROCEDURE NAME里面，我们又可以自己把头字段和行字段进行区分，以便插入到不同的表中。

可选字段是VIEW的字段，可以不进行显示。

14.4 对字段属性是否只读等进行设置，此处我们只设置行ID为只读。标题为“测试组织ID”，然后应用（设置为只读后，上传时此值为空）。



14.5 应用之后的界面如下：



14.6 验证：

SELECT BNI.APPLICATION_ID,

BNI.INTEGRATOR_CODE, --集成器CODE

BNI.USER_NAME, --集成器名称

BLV.LAYOUT_CODE, --布局代码

BLV.USER_NAME, --布局用户名称

BLC.SEQUENCE_NUM,

BIC.*

FROM BNE_INTEGRATORS_VL BNI,

BNE_LAYOUTS_VL BLV,

BNE_LAYOUT_COLS BLC,

BNE_INTERFACE_COLS_VL BIC

WHERE BNI.USER_NAME = 'SGQ_WEBADI_DEMO'

AND BLV.INTEGRATOR_APP_ID = BNI.APPLICATION_ID

AND BLV.INTEGRATOR_CODE = BNI.INTEGRATOR_CODE

AND BLV.LAYOUT_CODE = BLC.LAYOUT_CODE

AND BLC.INTERFACE_APP_ID = BIC.APPLICATION_ID

AND BLC.INTERFACE_CODE = BIC.INTERFACE_CODE

AND BLC.INTERFACE_SEQ_NUM = BIC.SEQUENCE_NUM;

十五、定义映射

15.1 Desktop Integrator -->定义映射



15.2 查找SGQ_WEBADI_DEMO，然后点“更新”，然后下一步。







15.3 更新映射，这里我们添加5行，和数据库视图列数保持一致。



这里显示界面定义的字段对应到数据库的哪个字段。我们增加4行，把视图出来的值传给API PROCEDURE NAME的参数。

15.4 验证：

SQL> SELECT BNI.APPLICATION_ID,

BNI.INTEGRATOR_CODE, --集成器CODE

BNI.USER_NAME, --集成器名称

BMV.MAPPING_CODE --映射CODE

FROM BNE_INTEGRATORS_VL BNI, BNE_MAPPINGS_VL BMV

WHERE BMV.INTEGRATOR_APP_ID = BNI.APPLICATION_ID

AND BMV.INTEGRATOR_CODE = BNI.INTEGRATOR_CODE

AND BNI.USER_NAME = 'SGQ_WEBADI_DEMO'

AND BMV.INTEGRATOR_APP_ID = BNI.APPLICATION_ID

AND BMV.INTEGRATOR_CODE = BNI.INTEGRATOR_CODE;

APPLICATION_ID INTEGRATOR_CODE USER_NAME MAPPING_CODE

---------------- ------------------------------ ------------------------------ ------------------------------

20003 GENERAL_141_INTG SGQ_WEBADI_DEMO GENERAL_141_MAP

十六、定义查询条件 ，用来定义过滤条件

16.1 Desktop Integrator -->创建文档



16.2 创建独立查询,下一步



注意：这里创建独立查询，以后要修改，则要HR 维护查询（HR Maintain Standalone Query）

16.3，选择EXCEL 2003 ,报告前面的框不选 ，下一步。



16.4 选择对应的应用程序简称和集成器用户名，下一步。



16.5 复查



16.6创建文档，保存并打开，并填写：



16.7 加载到EBS

十七、使用：

17.1 Desktop Integrator -->创建文档



17.2 选择集成器，下一步



17.3 选择EXCEL 2003，报告前面的框不选 ，下一步。



17.4 机构组织ID为83，即前面插入的SQL值，继续。



17.5 复查



17.6 创建文档，保存并打开。



进阶：客户化开发

十八、进阶EXCEL LOV

18.1 定义字段与LOV字段的关系

直接在APPS下面执行：

SELECT BIC.INTERFACE_COL_NAME, --字段名

BIC.VAL_TYPE, --填TABLE

BIC.VAL_ID_COL, --传递给程序参数的字段，填 ORGANIZATION_ID

BIC.VAL_MEAN_COL, --在EXCEL中显示的字段，填ORGANIZATION_ID

BIC.VAL_DESC_COL, --LOV中说明字段，填organization_code,organization_name

BIC.VAL_OBJ_NAME, --列表所在的表名，填 ORG_ORGANIZATION_DEFINITIONS

BIC.VAL_ADDL_W_C, --WHERE 语句，可不填

BIC.VAL_COMPONENT_APP_ID, --组件应用，填20003

BIC.VAL_COMPONENT_CODE, --组件代码，还未创建，先填一个，然后创建，填CUX_ORGANIZATION

BIC.LOV_TYPE, --填POPLIST或STANDARD，也可以填NONE

BIC.OFFLINE_LOV_ENABLED_FLAG --离线编辑EXCEL表格时是否可用，填Y

FROM BNE_INTERFACE_COLS_B BIC

WHERE EXISTS (SELECT NULL

FROM BNE_INTERFACES_VL INTF,BNE_INTEGRATORS_VL INTG --集成器

WHERE BIC.INTERFACE_CODE = INTF.INTERFACE_CODE

AND INTF.INTEGRATOR_CODE = INTG.INTEGRATOR_CODE

AND INTG.USER_NAME = 'SGQ_WEBADI_DEMO')

AND BIC.INTERFACE_COL_NAME = 'P_ORGANIZATION_ID'

FOR UPDATE;





注意字段分别填写为注释中标明的值

理解如下字段：

1.VAL_ID_COL 传递给程序参数的字段，本列中只需要传值给P_ORGANIZATION，所以只填写ORGANIZATION_ID,如果还定义了P_CODE，则需要填写CODE

2.VAL_MEAN_COL 在EXCEL中显示的字段，本列中需要显示代码机构组织ID，则需要填写ORGANIZATION_ID，如果还显示机构组织代码，则填写CODE(传值还是给ORGNIZATION_ID，只是在界面上显示的是机构组织代码)

3.VAL_DESC_COL LOV中的说明字段，可以是一个，也可以是多个。

18.2 创建组件

SQL> SELECT B.APPLICATION_ID, B.VAL_COMPONENT_APP_ID, B.VAL_COMPONENT_CODE

FROM BNE_INTERFACE_COLS_B B

WHERE B.VAL_COMPONENT_CODE = 'SGQ_ORGANIZATION';

APPLICATION_ID VAL_COMPONENT_APP_ID VAL_COMPONENT_CODE

---------------- -------------------- ------------------------------

20003 20003 SGQ_ORGANIZATION

18.3向组件表插入记录

SQL> INSERT INTO BNE_COMPONENTS_B

(

APPLICATION_ID,

COMPONENT_CODE,

OBJECT_VERSION_NUMBER,

COMPONENT_JAVA_CLASS,

PARAM_LIST_APP_ID,

PARAM_LIST_CODE,

CREATED_BY,

CREATION_DATE,

LAST_UPDATED_BY,

LAST_UPDATE_LOGIN,

LAST_UPDATE_DATE

)

VALUES

(

20003,--对应的bne_interface_cols_b.val_component_app_id

'SGQ_ORGANIZATION',--bne_interface_cols_b.val_component_CODE

1,

'oracle.apps.bne.integrator.component.BneOAValueSetComponent',--oraCLE标准代码

20003,--参数应用ID

'SGQ_ORGANIZATION',--参数的代码名称,重要

-1,

SYSDATE,

-1,

-1,

SYSDATE

);

1 row inserted

SQL> commit;

Commit complete

18.4 向组件语言表插入记录

SQL> INSERT INTO BNE_COMPONENTS_TL

(

APPLICATION_ID,

COMPONENT_CODE,

LANGUAGE,

SOURCE_LANG,

USER_NAME,

CREATED_BY,

CREATION_DATE,

LAST_UPDATED_BY,

LAST_UPDATE_LOGIN,

LAST_UPDATE_DATE

)

VALUES

(

20003,--BNE_COMPONENTS_B.APPLICATION_ID

'SGQ_ORGANIZATION',--对应BNE_COMPONENTS_B.COMPONENT_CODE

'ZHS',

'ZHS',

'机构组织',

-1,

SYSDATE,

-1,

-1,

SYSDATE

);

1 row inserted

SQL> commit;

Commit complete

18.5 定义功能

路径：应用开发员-->功能,,

功能名称如下：SQL_WEBADI_PARAMETER

类型为:SSWA
servlet函数

参数：bne:page=BneParameter

HTML调用：BneApplicationService









18.6 加入菜单

应用开发员-->菜单，查找 DESKTOP INTEGRATION MENU 添加



18.7 定义参数

路径：Desktop Integrator--> SGQ_WEBADI_PARAMETER



18.8 选择Web应用产品桌面集成品，去掉Restrict to this application,下一步



18.9 下一界面



18.10 点击查找,使用Oracle系统的一个原有参数（比如COMP_AVG_JNL_FLAG）来创建客户应用的参数及属性。



18.11 点击右上角的复制 按钮



注意：Application 必须是当前系统应用的名称

code 必须与bne_components_b中的param_list_code一致。

保存退出。

18.12 再次进入 路径：Desktop Integrator--> SGQ_WEBADI_PARAMETER，进入当前系统客户化应用，去掉Restrict to the application



18.13 查找,输入SGQ_ORGANIZATION，查找后选择







18.14 修改Table Columns属性

SELECT T.VAL_OBJ_NAME,

T.VAL_ID_COL,

T.VAL_MEAN_COL,

T.VAL_DESC_COL,

T.INTERFACE_COL_NAME

FROM BNE_INTERFACE_COLS_B T

WHERE T.VAL_COMPONENT_CODE = 'SGQ_ORGANIZATION';



在VALUE中输入各个列名，用“,”分隔，注意这里的字段名必须是BNE_INTERFACE_COLS_B.VAL_OBJ_NAME,也就是ORG_ORGANIZATION_DEFINITIONS表的字段之一

并且出现在BNE_INTERFACE_COLS_B中的VAL_ID_COL,VAL_MEAN_COL或者VAL_DESC_COL中，否则不会显示。

18.15 修改TABLE_COLUMN_ALIASN属性



注意：这一步很重要，必须与18.14 table column的顺序相同，名称必须与以下相同 ，即PACKAGE的参数相同，否则不会返回EXCEL

SELECT BIC.INTERFACE_COL_NAME, BIC.VAL_OBJ_NAME, BIC.*

FROM BNE_INTERFACE_COLS_B BIC,

BNE_INTERFACES_VL INTF,

BNE_INTEGRATORS_VL INTG

WHERE BIC.INTERFACE_CODE = INTF.INTERFACE_CODE

AND INTF.INTEGRATOR_CODE = INTG.INTEGRATOR_CODE

AND BIC.INTERFACE_COL_TYPE = 1

AND INTG.USER_NAME = 'SGQ_WEBADI_DEMO';

18.16 修改table-select-column



注意：VALUE代表返回的字段，该字段必须与bne_interface_cols_b.interface_col_name保持完全一致。并且必须存在于bne_interface_col_b.val_obj_name所在的表的列中，或者使用在table column alias的参数属性中被指定假名。否则值列表挑选后，不会自动更新EXCEL表格中对应的项目。

18.17 修改table header



VALUE:机构组织ID（LOV中第一个字段题头的值）

18.18 修改 window-width



18.19 重启应用，因为LOV调用的是SERVLET类，必须重新加载方可生效，如果只修改了属性值，则不需要重启应用，只有UPDATE基表BNE_INTERFACE_COLS_B中的值的时候，才需要重启应用。

本示例环境为：(Oracle Applications 12.1.2 RDBMS 11.1.0.7.0)

系统应用名称为：XXT客户化应用

简称为：XXT