OAF_OAF控件系列9 - 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. 创建测试描述性弹性域表

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

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

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

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

三、案例测试

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

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

Thanks and Regards

<b>ERP技术讨论群: 288307890</b>

<b>技术交流，技术讨论，欢迎加入</b>

<b>Technology Blog Created By Oracle ERP - 鲍新建</b>