2014-06-06 BaoXinjian
一、摘要
在OAF编译文件时,系统会通过XMLImport将所编译的XML文件,编译到数据库中,也就是MDS(Meta data Service),元数据库
而在OAF在展现给用户时,系统将存放MDS的内容,再通过程式组合成XML页面定义文件,并进行渲染
所以MDS可以存放了OAF页面的定义,所以二次开发时,在编译XML文件后,并不需要XML文件存放在服务器上
这个和Form Builder的fmx 和 fmb文件有类似性,fmx为编译后的问题,fmb是代码文件,在执行时只需要fmx文件
而OAF在页面文件做的更加彻底,直接存放在数据库中,但是很多java class包还是通过文件调用的方式,本文只做页面定义文件相关的MDS的解释
- 与MDS相关的Table
- jdr_paths --存储OAF页面路径(目录树)
- jdr_components --存储OAF组件树
- jdr_attributes --存储OAF组件的attribute
- jdr_attributes_trans --存储OAF组件的翻译,多语言或国际化的实现基础
- 与MDS相关的script
- jdr_mds_internal
- jdr_utils
- jdr_custom_internal
- jdr_docbuilder
二、导出OAF页面设计的XML定义
在OAF页面开发中,开发人员使用JDeveloper可视化工具来设计Web页面,页面有一个个组件嵌套组合而成,最后形成一个XML格式的页面定义文件。
在EBS中可以通过Abort this Page 的功能来查找出页面相关的信息,如页面结构、个性化、页面上下文、Java系统属性、预置文件等等,
利用这个功能查询出页面的路径:
然后切换到Output标签页,可以看到OAF页面的XML定义,如果页面定义信息过多,可以增加Buffer Size后再次运行,如下便是PO Document Types页面的定义信息,
从页面定义信息中可以得知OAF页面的组成,所使用的AM, Region使用的CO等信息,通过这个方法可以分析和查看标准的OAF页面和功能.
Step1. 使用About This Page
Step2. 获取Page的定义link
Step3. 通过jdr_util.print_documents查看Page定义的xml文件
三、OAF页面元信息存储结构
实现上在使用XMLImporter导入OAF页面信息的时候,XMLImporter解析OAF页面定义XML文件,然后将页面信息分别存储在下图的几个表中。
OAF页面元数据主要存储在上图中的3个表中:
1. JDR_PATHS:存储了页面路径的结构以及OAF页面个性化的结构信息
/bxj/oracle/apps/ap/expense/webui/ExpenseSummaryPG这是OAF页面的路径,它会被拆分为树型结构存储在JDR_PATHS表中,请看下面:
其中/bxj/oracle/apps/ap/expense/webui都是属于PACKAGE类型, 而最后的ExpenseSummaryPG是DOCUMENT,即是一个XML文档
通过最后这个一系列的父子关系关联,组合成了一个完整的Page的路径
2. JDR_COMPONENTS:存储了页面组件信息,OAF页面组件被分解后存储在此表中
上面从JDR_PATHS表中查询出来类型为DOCUMENT的节点DocumentTypesPG,查询它的组件属性如下:
对比上面查询出来的结果和通过jdr_utils.printDocument(‘/bxj/oracle/apps/ap/expense/webui/ExpenseSummaryPG’)工具导出的XML文件内容就会发现,
JDR_COMPONENTS中的数据是将XML文件中的OAF组件分解得到的
3. JDR_ATTRIBUTES:存储了页面各组件的属性
使用下面的SQL查询出页面组件的属性信息
4. JDR_ATTRIBUTES_TRANS
存放了语言定义,之后再做OAF多语言开发中会详细介绍
5. 总结
从上面的OAF元数据存储不难看出,OAF开发完成后,使用XMLImporter工具导入OAF页面的时候,XMLImport工具将页面定义XML文件按照组件进行分解,
- 将文档的结构信息存储到JDR_PATHS中;
- 将组件信息保存到 JDR_COMPONENTS中;
- 组件的属性保存到JDR_ATTRIBUTES中;
- 多语言信息保存到JDR_ATTRIBUTES_TRANS中;
而当运行OAF页面的时候,
- OAF引擎根据 Function定义中的URL地址,即OAF页面的页面路径;
- 首先到JDR_PATHS表中查询出 DOCUMENT的节点;
- 然后再从JDR_COMPOENTS 和 JDR_ATTRIBUTES表中取得组件和属性信息后输出Web页面;
- 再根据语言环境确定是否要从JDR_ATTRIBUTES_TRANS中取值多语言信息;
所以发布OAF应用的时候, 页面定义文件是无需上传到JAVA_TOP下的.
熟悉了JDR相关的结构之后,对于我们理解OAF的工作原理,以及解决一些疑难杂症非常有帮助. 同时对于OAF页面的个性化也会涉及到这几张表.
Thanks and Regards
参考: 张礼军 http://oracleseeker.com/2009/08/11/explained_meta_data_for_page_of_oracle_application_framework/