NC5X-Web自助单据开发流程规范规范

1、HR自助服务单据开发快速入门用友软件股份有限公司北京分公司客户开发部2011年3月目 录 TOC o 1-3 h z u NC自助服务单据开发总体概述NC自助服务模块使用的是BSTEK公司推出的Dorado 5展现中间件技术。通过将Dorado和NC-UAP平台的整合，可以在自助服务中引用NC-UAP平台中的单据模板 ，提高了在自助下开发单据的效率。Dorado技术详细介绍请见BSTEK公司官网：开发环境搭建配置Java运行时环境通过Sun官网获取JDK开发包，下载的开发包解压缩到本地非中文名称的目录中；也可以直接使用NCHOME中自带的JDK开发包，如本机中NCHOME的JDK开发包D:nc

2、home56nchomeufjdk配置JAVA_HOME环境变量对于环境变量的配置就不用多说了，本机的配置如下：下载并解开Dorado5开发包通过如下的地址获取dorado5的开发包：，如本机的E:安装Dorado 5在确保系统已经配置过JAVA_HOME的前提下，并双击运行dorado 5开发包中的文件，该文件进行dorado5开发包的文件初始化工作。（特别声明：绿色食品，的所有操作都是针对开发包所在的目录作初始化工作，不会对该目录之外的内容进行修改。）首先会打开一个命令控制台，要你确认是否执行初始化的工作：按任意键继续初始化工作：这时候系统会在桌面上自动的生成一个dordo5 studio

3、的快捷启动图表，并在控制台中出现让你选择是否直接启动dorado的集成开发环境，也就是dorado5的studio。以下统称studio。如果选择y并按回车键确认打开studio，可以看到下图：Eclipse开发环境搭建Eclipse开发环境的搭建在此就不做介绍了，主要的环境有NC56、eclipse开发环境、nc56插件。搭建项目工程对于自助服务的开发，需要同时用到Eclipse和Dorado工程，对于项目工程需要将Eclipse工程目录和Dorado工程目录整合到一块，以便对在两个开发工具对同一工程进行开发。本例中使用的开发工程为NC-HR自助模块的源开发工程。在Eclipse中导入工程，

4、如下：在Dorado集成开发平台中导入工程如下：自助单据开发流程在自助服务下开发的JSP界面，可将NC-UAP平台下的单据整合到自助服务中，这是通过将单据模板信息解析成Dorado控件来实现的，由于是根据单据模板信息表中的数据进行解析的，对于用元数据制作的单据模板，在自助服务界面目前还没有做到很好的兼容，解析过程中还没有增加对元数据的解析，故目前自助服务只能够对用数据字典制作的单据模板进行正确的解析，下面介绍在NC56中，如何用数据字典在自助服务下开发轻量级单据界面。建立数据模型根据具体的业务在PowerDesigner中建立对应的业务模型，本例中介绍的为休假计划的业务。导入数据字典具体的数据

5、字典导入在【客户化】【二次开发工具】【系统管理工具】【数据字典管理】节点来实现导入。单据模板初始化在完成数据字典导入之后，就可以在【客户化】【二次开发工具】【模板管理】【单据模板初始化】节点通过数据字典制作相应的单据模板，具体的与初始化单据模板一致。本例初始化完的单据模板卡片界面显示如下：导出Java源代码通过UAP集成开发平台导出Java源代码。在通过数据源生成VO代码之前，一定要保证在数据库中将数据模型对应的表结构建立，否则在选择数据库表处看不到单据对应的数据库表，具体的建表SQL脚本可以在建模时，通过PowerDesigner生成。选择完对应的数据库表，设置对应的VO信息以及对应到文件导

6、出目录（%当前eclipse工程% / src / public 包）后，点击“确定”按钮，即可完成对VO的导出。建立视图层ViewModel。ViewModel是一种用于封装界面逻辑和操作逻辑的对象。即视图中包含哪些数据、这些数据以什么方式展现、视图中包含哪些控件、这些控件会激发什么操作等等。我们可以把ViewModel看作是Dataset和各种控件的容器。ViewModel一般不用于定义各种控件最终在显示的布局，控件布局应通过其它方式进行定义。在通常情况下，我们利用JSP来完成对ViewModel中定义的控件进行布局。在Dorado集成开发平台中打开项目工程，在对应的目录下，右键鼠标，如下

7、：选择新建“Module“，进入ViewModel新建向导。选择通用的视图模型对象（Common ViewModel）即可，点击“OK”，输入视图模型对象名称，即会在相应的目录下生成一个视图模型对象的XML配置文件，配置文件名称为输入对象名称.,如本例在新建视图模型对象的时候输入的名称为LeavePlanOne,则生成的视图模型对象的名称为：。生成JSP页面对于自助JSP页面是通过ViewModel生成的，具体生成JSP的操作如下图所示：选择相应的路径以保存生成的JSP文件。再生成JSP页面之后，需要对生成的JSP页面先进行简单的布局配置，如果需要配置其他在ViewModel中定义的控件显示，

8、在定义完控件后再做详细的页面布局。对于使用NC-UAP平台的单据模板时，对应管理型界面的JSP界面配置如下： 建立后台控制类新建视图模型后台控制类，由于本例中开发的是带审批流的自助界面，具体的后台控制类应继承。对于后台控制类的基本配置如下：package class LeavePlanOne extends PFViewModel /* * 返回单据VO */Overridepublic AggregatedValueObject toBillAggVO() throws Exception 其他的本人也没用过，组建详细使用说明请见dorado 5 组件详解 )组件Command的method

9、属性用于指定调用服务器接受类的指定方法的方法名(默认为视图模型中的方法名，即视图ViewModel的关联的后台控制类中的方法)。对于按钮在前台页面响应事件，是通过定义JS来实现的，具体响应的JS函数的名称在后台按钮工厂类中已经定义。单据属性设置对于带审批流的单据，需要在UAP平台中进行一些审批流相关属性的设置，这与中的设置类似，具体的设置步骤如下:第一步：单据类型定义如上图，输入“类型代码”、“类型名称”、“节点编号”，完成后点击“保存”按钮保存定义的单据类型信息。（其中：此处定义的“类型代码”最好和单据模板定义步骤定义的单据模板编码一致，否则在后面会遇到意想不到的问题。）第二步：单据号设置如

10、上图，设置单据号的生成规则。第三步：单据动作定义第四步：单据动作脚本设置如上图，在此处对于单据的动作脚本进行编辑，具体的脚本可以直接从其他定义的单据动作脚本拷贝过来即可（因为笔者没有找到在何处去自动生成系统默认的单据动作脚本，只能通过此方法来实现）。在编辑完动作脚本后，在NCHOME对应的模块目录下的META-INFvarsource会生成相应的动作脚本类。第五步：单据VO对照具体的VO对照关系设置如下图：附录：轻量级参照实现方式：对于自助开发下的单据中字段的参照与业务系统中有所不同，具体设置字段为参照的步骤如下：第一步：在单据模板中，将参照的字段的数据类型设置为参照，参照类型设置具体的参照编

11、码，如下图。第二步：配置具体的参照，参照的配置是通过XML文件来配置的，参照主要有三种展现类型：GRID、TREE、TREEGRID。具体的配置请见当前工程的homerefbusiness文件，为休假类别参照的XML配置文件。第三步：设置具体的参照配置文件与参照类型编码的映射关系，对于映射关系的设置，目前还没有具体的配置界面，只能够通过在后台表hrss_ref_map表中去配置具体的映射关系，下图为休假类别参照对照配置。审批流配置注意点要想在自助模块顺利使用审批流，需要在工程中做如下配置：第一步：设置和审批有关的字段的对应关系，通过集成PFConfig类来配置具体的字段对应关系。（见）第二步：

12、配置 Hrss 单据信息，通过实现接口来进行配置。(详见第三步：配置Hrss单据注册类，用于将自定义的单据信息注册到Hrss单据集中。package class LeavePlanPfConfigExtImpl implements IHrssPfConfigExt public IConfigMeta getPfConfigExt() / TODO Auto-generated method stubreturn new IConfigMeta new LeavePlanConfigMeta(),new LeavePlanOneMeta();在定义完具体的后台注册实现类后，需要在UPM文件（

13、）中进行配置。第四步：配置审批流后台处理类。第五步：定义审批流。“提交”动作按钮特别说明：1、如果在ViewModel的后台控制类中，重写AggregatedValueObject toBillAggVO()方法返回的类型为HYBillVO，则需要在聚合VO（AggLeaveplanHVO）定义相关的接口实现类，以配置具体的在审批流字段的具体对应关系。2、如果重写AggregatedValueObject toBillAggVO()方法返回的类型为HRAggVO，则需要重写”提交“按钮的动作脚本需要重新定义，由具体的审批流后台实现类完成具体提交字段的更新。轻量级查询模板实现方式第一步：定义查询

14、控件MarmotQuery。属性设置分别如下,其中category属性设置的为对应的后台查询模板的ID。第二步：注册查询模板信息。由于自助模块查询模板的注册在UAP平台还没有对应的前端操作界面，只能够通过在后台数据库，向查询模板信息表中注册的模板信息。首先：向mmt_query_category表中注册查询模板的基本信息，其中categroy字段为对应查询模板的ID，与第一步中查询控件中的category一致。其次：向mmt_query_template_fields表中插入具体查询模板中具体的查询字段的基本信息。最后：在注册完查询模板基本信息之后，在视图控制ViewModel中，添加“查询”

15、按钮对应的前端响应JS事件。/* * 查询按钮响应事件 */function onSearch() ();到此，就完成了在自助模块下查询模板的配置和开发，最终的效果如下：按钮动作前后台交互示例：增加按钮动作处理首先“增加”按钮在系统默认工厂处理类中定义如下：NEW, 增加, null, onNew, , “新增一条记录”则“增加”按钮在前台页面响应的JS函数的方法为function onNew()。本例中在前台视图模型中定义的“增加”按钮的JS响应函数如下：/* * 增加按钮响应事件 */function onNew() if(_templetType = _MANAGE_BILL & _currentTemplet = _LIST_BILL) onShowCard(); /调用RPCCommand与后台进行交互，获取新增单据时画面上所需的信息 (); setBillRea