动态单据框架使用总结.docVIP

动态单据框架使用总结 1、引言 最近我们协同系统部办公自动化组开发了一个流程管理模块，使用了必威体育精装版的动态单据框架，现在这个模块已基本完成了一期的发布。整个开发过程，也是一个摸索和学习的过程，由于是一个新框架，说明文档和参考资料也不是很多，其间我们也遇到过不少问题，也走了一些弯路，现在将我在整个开发过程中的体会记录下来，以供自己和初次使用动态框架的同事参考。 2、动态框架简介 动态单据框架是直接基于JSF和ExtJS开发的，而不是在WAF框架之上开发的，所以在性能方面相对要好很多。动态单据框架主要功能是让我们可以通过设计器拖放和做一些配置来生成序时簿页面和单据编辑页面，而不需要像以前那样手工写bill.xhtml页面和后台管理的BillBean，这些工作框架都帮我们做好了，如果要做一些通用功能之外的自定义操作，我们也只需要写一个插件，并将操作写在插件中就可以实现了。这样就极大的简化了开发单据的过程，提高了开发效率。 3 、动态框架的使用 1、动态单据的基本用法 首先，创建所需实体。然后打开金碟EAS客户端，在功能菜单中选系统平台，再双击动态单据配置，如图： 然后再选择要放到哪个子系统之下，确定之后出现如下界面： 这就是我们设计动态单据的主界面了（做过Winform的朋友一定看出来了，这和Winform非常相似，也为我们提供相当易用的人机界面，包括工具栏上的一系列布局按钮，让我们使用起来相当方便），右边的子系统区域显示了刚才所选的子系统下的所有动态单列表，我们可以在这修改已存在的单据，也可以新建一个动态单据。点新建按钮，选择一个模板，确定就根据模板生成了一张新的动态单据，我们也可以创建自已的模板，过程和新建单据基本一致，只要最后修改一下数据库记录即可，后面会谈到这个。 设计单据的过程比较简单，从工具箱里拖出控件，在属性面板中修改相应的属性，再保存，就可以了，这里只是重点提一下单据和控件的绑定，其它的在这不多涉及。 首先要给单据绑定实体，选定单据（注意：不是选定控件，要选择最外面的框），然后在属性面板中点绑定实体右边的按钮（如左图），弹出选择业务对象对话框，在这里我们选择最开始创建的实体，确定，就完成了单据和实体的绑定。这样我们的这张动态单据的序时簿和编辑界面就可以显示和修改所绑定的实体的属性了。 然后点下面的操作列表，定义这张单可以执行的据所有操作（如下图）。这里框架给我们提供了20多种内置的操作。我们在这选了单据所具有的操作功能（比如说保存操作），后面才能在给按钮事件添加Action时调用单据的保存功能，这也包括在工具条上的按钮要调用单据功能的情况。 操作列表里的权限是指执行某一操作所必须的权限项，如果为某个操作配了权限项，则框架在执行这个操作之前会先验权，如果有相应权限则执行，没有则抛出异常并终止执行操作。检查工作流是指在执行操作前是否要先检查该记录有没有在工作流之中，如设置为检查则当该记录已在工作流中时给出提示并取消操作，不在工作流中才往下执行。 单据中的控件都要和实体的一个属性绑定，这样才能在单据编辑页面读出实体的属性值或在保存时将控件的值存入实体相应属性里。对于文本框和日期框等，当我们点绑定实体属性右边的安钮时，会自动找出该单据所绑定实体的所有字符属性或日期属性。下拉列表框则会找出所有枚举属性供选择。对于基础资料控件，除了绑定实体属性外，还要选择基础资料类型和关联的基础资料字段名，实际上就是指定当点击这个F7控件时，要去找哪个基础资料实体的哪个字段的值显示在控件上。 另外提一下默认值的问题，我们可以给单据的某个或几个字段设置默认值，这样当新建单据时会自动为这个字段给上默认值，这对于一些不能让用户修改的字段如创建人等特别有用。设置默认值只需要选中控件，在缺省值中填入要取的值即可。目前框架还没有提供让我们直接选择就能设好默认值的方法。我们只能手工输入表达式来达到这个目的，下面是几种常用的默认值表达式写法(照下面的输入即可，不用改动)： getUser(@CONTEXT, Person) 取当前登录的职员 getUser(@CONTEXT, User) 取当前登录的用户 getBillNumber(@CONTEXT,@THIS,@MAINORG) 自动生成单据编号 getDate() 取当前日期 getOrgUnit(@CONTEXT, LoginOrg, @MAINORGTYPE) 取当前登录组织 在创建并保存了单据之后，我们就可以看到单据的序时簿界面和单据编辑界面了。键入以下地址就可以查看了： HYPERLINK http://localhost:6888/easweb/dynform/demo.jsf http://localhost:688