首页 > 代码库 > OAF_OAF控件系列8 - Description Flexfiled描述性弹性域的实现(案例)

OAF_OAF控件系列8 - Description Flexfiled描述性弹性域的实现(案例)

2014-06-17 Created By BaoXinjian

技术分享一、摘要


OAF的弹性域的实现基本和Form的弹性域实现的大体思路是一致的,在注册Table和弹性域完全一样,之后通过控件去实现具体的弹性域显示

Form的弹性域初始化基本都在trigger when-new-form-instance中

OAF的弹性域初始化基本都在processRequest中,或者在processRequest调用AM中的初始化方法

 

1. 网上的一个例子                       

根据表FWK_TBX_EMPLOYEES生成实体对象EmployeeEO以后,

设置EmployeeEO的动态属性组(Dynamic Attribute Groups),添加一个说明性弹性域的值,Application Sort Name值为AK,FlexField Name值为FWK_TBX_EMPLOYEES,其他值保持默认即可,

点 击确定,然后可以在Custom Properties里查看到多了几个属性和值:DFF1_DESCRIPTIVE_FLEXFIELD_NAME、 DFF1_APPLICATION_NAME、DFF1_DAG_NAME、DFF1_CONTEXT_ATTRIBUTE_NAME这几个属性,保持默 认,点击确定。

根据EmployeeEO生成一个视图对象EmpFullVO,除了要在页面上填写的一些字段外,还必须包括AttributeCategory和Attribute1…Attribute15这几个字段。

新 建一个页面,把需要通过页面录入值的字段添加了页面上。然后在页面上添加一个item,设置其ID为DF,Item Style为flex。(值得注意的是,在messageComponentLayout里是不能添加flex项的,所以要先添加一个 messageLayout,然后在messageLayout里添加flex项)设置View Instance:EmpFullVO1, Appl Short Name: AK , Name:FWK_TBX_EMPLOYEES, Type:descriptive。如果只是显示的话,设置Read Only:true。如果要指定说明性弹性域的上下文和段,可以在Segment List里设置:上下文|段1|段2。

 

2. 说明性弹性域必须设定的四个属性

  • View Instance:EmpFullVO1
  • Appl Short Name: AK 
  • Name:FWK_TBX_EMPLOYEES
  • Type:descriptive

否则系统会找不到该flex定义

 

3. 代码完全定义

如果不用手工添加flex控件的方式,也可以通过代码实现完全弹性域的代码控制,主要用与根据条件动态设定弹性域的相关属性和出现与否

public void processRequest()

{

OADescriptiveFlexBean dffBean = (OADescriptiveFlexBean)       
createWebBean(pageContext, DESCRIPTIVE_FLEX_BEAN, null, "DescFF");   
webBean.addIndexedChild(dffBean);   
dffBean.setAttributeValue(OAWebBeanConstants.VIEW_USAGE_NAME,"FlextestVO1");   
dffBean.setAttributeValue(OAWebBeanConstants.FLEXFIELD_APPLICATION_SHORT_NAME,  "FND");   
dffBean.setAttributeValue(OAWebBeanConstants.REGION_APPLICATION_ID,  new Integer(0));   
dffBean.setAttributeValue(OAWebBeanConstants.FLEXFIELD_NAME,"SimpleFlex");   

OADescriptiveFlexBean dffBean = (OADescriptiveFlexBean)webBean.findIndexedChildRecursive("DescFF");  
flexBean.mergeSegmentsWithParent(pageContext); 

}

 

4. 注意点:

只说明了关于说明性弹性域的地方。

运行页面,当更换说明性弹性域的上下文时,页面会刷新,这样会导致am.invoke(“createEmployee”)被调用一次,这样我们点击保存按钮时,后台会多生成一条记录。

(即当前页面上的内容被缓存到服务器,然后再在页面上生成一个初使化的记录)为了防止这种情况发生,需要在调用am.invoke(“create_employee”)的代码时多添加一个判断,如下:

if(!pageContext.isFormSubmission() && pageContext.getParameter(FLEX_FORM_EVENT) == null)

  am.invoke(“createEmployee”);

 

技术分享二、案例实现


需求: 在Expense页面中新增一个描述性弹性域

1. 创建测试描述性弹性域表

 1 CREATE TABLE ap.bxj_apexp_report_header_all 2 ( 3    REPORT_HEADER_ID       NUMBER PRIMARY KEY, 4    REPORT_NAME            VARCHAR2 (240), 5    EMPLOYEE_ID            NUMBER, 6    DESCRIPTION            VARCHAR2 (240), 7    APPROVE_ID             NUMBER, 8    APPROVE_STATUS         VARCHAR2 (25), 9    APPROVE_WF_ID          NUMBER,10    REJECT_CODE            VARCHAR2 (25),11    CREATION_DATE          DATE,12    CREATED_BY             NUMBER,13    LAST_UPDATE_DATE       DATE,14    LAST_UPDATE_LOGIN      NUMBER,15    LAST_UPDATED_BY        NUMBER,16    TOTAL                  NUMBER,17    INVOICE_NUM            VARCHAR2 (50),18    ATTRIBUTE_CATEGORY     VARCHAR2 (150),19    ATTRIBUTE1             VARCHAR2 (150),20    ATTRIBUTE2             VARCHAR2 (150),21    ATTRIBUTE3             VARCHAR2 (150),22    ATTRIBUTE4             VARCHAR2 (150),23    ATTRIBUTE5             VARCHAR2 (150),24    CHART_OF_ACCOUNTS_ID   NUMBER,25    SEGMENT1               VARCHAR2 (150),26    SEGMENT2               VARCHAR2 (150),27    SEGMENT3               VARCHAR2 (150),28    SEGMENT4               VARCHAR2 (150),29    SEGMENT5               VARCHAR2 (150),30    ORG_ID                 NUMBER,31    REQUEST_ID             NUMBER,32    COMMENTS               VARCHAR2 (240)33 )

 

2. 通过ad_dd.register注册表和栏位

 1 BEGIN 2   ad_dd.register_table(SQLAP‘,BXJ_EXP_REPORT_HEADER_ALL‘,T‘,8,10,90); 3    4   ad_dd.register_column(SQLAP‘,BXJ_EXP_REPORT_HEADER_ALL‘,ATTRIBUTE_CATEGORY‘,1,VARCHAR2‘,150,Y‘,N); 5   ad_dd.register_column(SQLAP‘,BXJ_EXP_REPORT_HEADER_ALL‘,ATTRIBUTE1‘,2,VARCHAR2‘,150,Y‘,N); 6   ad_dd.register_column(SQLAP‘,BXJ_EXP_REPORT_HEADER_ALL‘,ATTRIBUTE2‘,3,VARCHAR2‘,150,Y‘,N); 7   ad_dd.register_column(SQLAP‘,BXJ_EXP_REPORT_HEADER_ALL‘,ATTRIBUTE3‘,4,VARCHAR2‘,150,Y‘,N); 8   ad_dd.register_column(SQLAP‘,BXJ_EXP_REPORT_HEADER_ALL‘,ATTRIBUTE4‘,5,VARCHAR2‘,150,Y‘,N); 9   ad_dd.register_column(SQLAP‘,BXJ_EXP_REPORT_HEADER_ALL‘,ATTRIBUTE5‘,6,VARCHAR2‘,150,Y‘,N);10   11   12   ad_dd.register_column(SQLAP‘,BXJ_EXP_REPORT_HEADER_ALL‘,CHART_OF_ACCOUNTS_ID‘,7,NUMBER‘,38,Y‘,N);  13   ad_dd.register_column(SQLAP‘,BXJ_EXP_REPORT_HEADER_ALL‘,SEGMENT1‘,8,VARCHAR2‘,150,Y‘,N);  14   ad_dd.register_column(SQLAP‘,‘BXJ_EXP_REPORT_HEADER_ALL‘,‘SEGMENT2‘,9,‘VARCHAR2‘,150,‘Y‘,‘N‘); 15   ad_dd.register_column(‘SQLAP‘,‘BXJ_EXP_REPORT_HEADER_ALL‘,‘SEGMENT3‘,10,‘VARCHAR2‘,150,‘Y‘,‘N‘); 16   ad_dd.register_column(‘SQLAP‘,‘BXJ_EXP_REPORT_HEADER_ALL‘,‘SEGMENT4‘,11,‘VARCHAR2‘,150,‘Y‘,‘N‘); 17   ad_dd.register_column(‘SQLAP‘,‘BXJ_EXP_REPORT_HEADER_ALL‘,‘SEGMENT5‘,12,‘VARCHAR2‘,150,‘Y‘,‘N‘); 18  19  20   DBMS_OUTPUT.PUT_LINE(‘Sucessfully Loading‘);21   COMMIT;22 EXCEPTION WHEN OTHERS THEN 23   DBMS_OUTPUT.PUT_LINE(‘SQLCode=‘||sqlcode);24   DBMS_OUTPUT.PUT_LINE(‘SQLErrm=‘||sqlerrm);25   ROLLBACK;26 END;

 

3. 在应用中查看和确认注册表和栏位是否成功

技术分享

 

4. 通过Register注册描述性弹性域,通过Segment定义描述性弹性域结构

技术分享

技术分享

 

5. 在OAF PG页面中新增一个Flex Type的Item如下

技术分享

 

技术分享三、案例测试


1. 查看弹性域已正常显示,输入值后保存

技术分享

2.  查看表中的弹性域栏位的值,确认无误

技术分享

 

技术分享

OAF_OAF控件系列8 - Description Flexfiled描述性弹性域的实现(案例)