xFrame框架formDefine配置方法

xframe3.8.2下载地址：
[url]http://download.csdn.net/detail/qixf1011/4447460[/url]

[size=large]FormDefine详细配置手册
1. 适用人群
FormDefine是xFrame框架中最具特色的功能。若需大幅度提升开发效率，务必熟悉本手册中的操作过程。
本文以车辆管理系统为例，介绍FormDefine配置方式。
2. 准备工作
 已安装Oracle8i以上版本（含Oracle8i）；
 已安装tomcat；
 已安装eclipse，建议同时安装myeclipse；
 xFrame框架已配置完毕，且正常工作；
 已安装后toad或sqldev等oracle前台工具；
3. 配置过程
2.1 创建表
在车辆管理系统中，需要使用一个表t_car_fee来存放车辆交费记录。
T_car_fee表
[img]http://dl.iteye.com/upload/attachment/0071/3136/57912140-d3b3-3ebb-85ed-c3e458044548.jpg[/img]
 在创建Table时，请填写各字段的comments，它们是显示在界面的必要信息，对FormDefine是必需的。
 每个表中都需要createby,createdate,lastmodifyby,lastmodifydate, status,id共六个字段，如果是子表还需要填写baseid字段关联主表。
创建表格之后，使用soft/soft（系统初始用户和密码）登录到Oracle前台工具（本文指sqldev），如下图。右击Procedures，点击Test，运行一次。

[img]http://dl.iteye.com/upload/attachment/0071/3138/6179c274-5a18-33a3-9ae9-faf60852fba2.jpg[/img]

图 1刷新comments的存储过程
若此Procedure显示为编译错误，可通过sys账号执行授权：
grant select on sys.dba_objects to soft;
再用soft登录即可。
2.2 进入FormDefine
使用管理员账号登录系统，验证码全是英文，且不分大小写。
[img]http://dl.iteye.com/upload/attachment/0071/3136/57912140-d3b3-3ebb-85ed-c3e458044548.jpg[/img]

图 2 xFrame登录
登录成功页码如下图：
[img]http://dl.iteye.com/upload/attachment/0071/3148/fa5cf431-0b1f-3b90-860f-e895ebede181.jpg[/img]

图 3 xFrame登录成功后界面
2.3 配置FormDefine
a) Form级
直接输入下面地址进入配置页，如下图所示：
http://yourip:8080/xframe/formAction.do?actionFlag=preFormDefine
[img]http://dl.iteye.com/upload/attachment/0071/3142/634f97c3-719c-38a4-b1bb-47d766370ff1.jpg[/img]

图 4 FormDefine工具首页
在表名中填写t_car_fee，按回车，并按下图填写表单级信息：

当前主要使用的模板有如下几类：
模板名 跳转路径 功能
formDefine /formAction.do 新增、查看、修改
queryFormDefine /query.do 新增、查看、删除
multiFormDefine /formAction.do 修改
queryMultiFormDefine /query.do 审核
若需要创建如下图所示的查询界面，填写模板queryFormDefine。
[img]http://dl.iteye.com/upload/attachment/0071/3146/4f0564d3-7f20-383d-a5f3-34ed7894288c.jpg[/img]

图 5配置查询界面的效果一例
层样式表示界面展示几列，选择3列表示三个字段并列展示。缺省值为2。
b) Field级
填写表名按回车后，将带出如下图所示的界面，它们是创建表时指定的字段及comments。
[img]http://dl.iteye.com/upload/attachment/0071/3152/d8d2e2c7-732a-3cf0-98f2-09c64e356360.jpg[/img]

图 6 Field级配置1

[img]http://dl.iteye.com/upload/attachment/0071/3150/a91c25df-df8d-3ba8-ba46-e8f795e718af.jpg[/img]

图 7 Field级配置2
说明：
序号：数字类型，“可见”字段将按此数字从小到大展示。
只读：在界面上此字段不可修改，“可见”时生效。
可空：非必填字段。若不可空，界面显示此字段后有一个红色“*”。
查询：使用queryFormDefine模板时生效。
缺省查询：在查询条件中显示。
类型：必需指定。同一字段，在不同模板中可以有几种类型。如在查看界面中，除textarea外，所有字段均可以采用text类型。
下拉选择：当类型为select时，即为下拉列表时，下拉项的名称。定义为check_status之后，需要在基础数据表中新增check_status项，具体操作见脚注 。
缺省值：对下拉选择项，指定一个默认选项。
关联方法：用户自定义的方法名，需要继承BaseAction并实现。由于涉及二次开发编码部分，此处不深入说明。
显示文本：通常使用comments即可。
小数位：用来指定数字类型的长度。
c) Button级
界面上需要按钮时，点击“新增”，如下图：

[img]http://dl.iteye.com/upload/attachment/0071/3144/d22aff3b-b4c4-32d9-a2ac-422d9d7da752.jpg[/img]

图 8 Button级配置
按钮文本当前只支持“保存”、“关闭”、“新增”、“修改”、“删除”、“查看”、“审核”、“驳回”、“同意”等名称，且不能填写空格。
跳转路径：表示点击按钮后执行的动作。可参照DB中附带的FormButton表配置。
路径参数：在页面之间跳转时，通过queryString传递，采用“名称1=名称1,名称2=名称2”的形式。若本页面中的baseid需要传到主页中作为id使用，则填写id=baseid。此处是二次开发的扩展点。
按钮类型：主要有两类，即查询界面中的datalist行级button，以及界面中保存类型。
2.4 修改FormDefine配置
若需要修改已配置好的FormDefine，需提供formId，并在地址栏直接输入下面地址进入配置页，如下图所示。xxx表示formId。
http://yourip:8080/xframe/formAction.do?actionFlag=preFormDefine&formId=xxx
修改操作步骤与初始配置相同。
2.5 配置功能菜单
 设置功能名称
用管理员登录，进入系统管理->功能模块管理->点击<新增>，找出上面配置的formId及跳转类型，参照下图填写：
[img]http://dl.iteye.com/upload/attachment/0071/3158/47f92113-35c1-3b2f-b519-c4bd42e773cf.jpg[/img]

图 9 新增功能点
功能名称：新增车辆缴费。
功能地址URL：注意区分大小写。
 将功能点加入菜单
用管理员登录，进入系统管理->操作菜单配置->子节点配置。如下图所示：
[img]http://dl.iteye.com/upload/attachment/0071/3156/26034af7-5c84-369b-9288-c6d2062602ed.jpg[/img]

图 10 配置菜单项1
点击“新增车辆缴费”，加入右侧模块，点提交。
[img]http://dl.iteye.com/upload/attachment/0071/3160/4c5aa18d-636e-36db-b085-c50d067403ef.jpg[/img]

图 11 配置菜单项2
点击提交，退出。
 授权给角色
用管理员登录，进入系统管理->人员权限配置。点击“权限配置”，将功能点授权角色。
[img]http://dl.iteye.com/upload/attachment/0071/3166/fd4827d4-02aa-3d36-bdfe-ff32edec034d.jpg[/img]

图 12 将功能点授权给角色
 将用户加入角色
用管理员登录，进入系统管理->人员权限配置。点击“人员配置”，将用户加入角色。
[img]http://dl.iteye.com/upload/attachment/0071/3162/7aeca610-ec0a-383f-b850-a3a853660de8.jpg[/img]

图 13 将人员加入角色
4. 验收效果
配置完毕后，点击左侧cache管理，分别刷新base和FormDefine两类缓存,再退出IE，重新使用已授权的用户（或管理员）登录。可看到上面配置的效果。
[img]http://dl.iteye.com/upload/attachment/0071/3168/66586258-cdd0-30ec-b1e2-dd7016462324.jpg[/img]

图 14 生成页面效果图

小结：
 使用xFrame框架，配置出来的界面简洁美观，5分钟即可配置一个复杂的界面，且能满足MIS系统的基本应用需求。
 xFrame稳定性强，易扩展。
 xFrame学习成本非常低，二次开发非常容易。
若需要学习在此基础上的二次开发，请参见《xFrame框架二次开发手册》。[size=large][/size]