NC5X-Web自助单据开发流程

HR自助服务单据开发快速入门用友软件股份有限公司北京分公司客户开发部2011年3月目录1、NC自助服务单据开发....................................................................................31.1.总体概述......................................................................................................31.2.开发环境搭建..............................................................................................31.2.1.配置Java运行时环境.......................................................................31.2.2.配置JAVA_HOME环境变量.............................................................31.2.3.下载并解开Dorado5开发包...........................................................41.2.4.安装Dorado5...................................................................................41.2.5.Eclipse开发环境搭建.......................................................................61.2.6.搭建项目工程....................................................................................61.3.自助单据开发流程......................................................................................71.3.1.建立数据模型....................................................................................71.3.2.导入数据字典....................................................................................81.3.3.单据模板初始化................................................................................91.3.4.导出Java源代码.............................................................................101.3.5.建立视图层ViewModel。..............................................................111.3.6.生成JSP页面..................................................................................131.3.7.建立后台控制类..............................................................................151.3.8.功能节点注册..................................................................................171.3.9.注册功能按钮..................................................................................201.3.10.按钮处理事件的定义.....................................................................231.3.11.单据属性设置.................................................................................24附录：..........................................................................................................................27轻量级参照实现方式：..............................................................................................27审批流配置注意点......................................................................................................27轻量级查询模板实现方式..........................................................................................29按钮动作前后台交互示例：......................................................................................31增加按钮动作处理......................................................................................311、NC自助服务单据开发1.1.总体概述NC自助服务模块使用的是BSTEK公司推出的Dorado5展现中间件技术。通过将Dorado和NC-UAP平台的整合，可以在自助服务中引用NC-UAP平台中的单据模板，提高了在自助下开发单据的效率。Dorado技术详细介绍请见BSTEK公司官网：开发环境搭建1.2.1.配置Java运行时环境通过Sun官网获取JDK开发包，下载的开发包解压缩到本地非中文名称的目录中；也可以直接使用NCHOME中自带的JDK开发包，如本机中NCHOME的JDK开发包D:\nchome56\nchome\ufjdk1.2.2.配置JAVA_HOME环境变量对于环境变量的配置就不用多说了，本机的配置如下：1.2.3.下载并解开Dorado5开发包通过如下的地址获取dorado5的开发包：将下载的zip文件解压缩到本地非中文名称的目录中，如本机的E:\dorado5.21.2.4.安装Dorado5在确保系统已经配置过JAVA_HOME的前提下，并双击运行dorado5开发包中的setup.bat文件，该文件进行dorado5开发包的文件初始化工作。（特别声明：绿色食品，setup.bat的所有操作都是针对开发包所在的目录作初始化工作，不会对该目录之外的内容进行修改。）首先会打开一个命令控制台，要你确认是否执行初始化的工作：按任意键继续初始化工作：这时候系统会在桌面上自动的生成一个dordo5studio的快捷启动图表，并在控制台中出现让你选择是否直接启动dorado的集成开发环境，也就是dorado5的studio。以下统称studio。如果选择y并按回车键确认打开studio，可以看到下图：1.2.5.Eclipse开发环境搭建Eclipse开发环境的搭建在此就不做介绍了，主要的环境有NC56、eclipse开发环境、nc56插件。1.2.6.搭建项目工程对于自助服务的开发，需要同时用到Eclipse和Dorado工程，对于项目工程需要将Eclipse工程目录和Dorado工程目录整合到一块，以便对在两个开发工具对同一工程进行开发。本例中使用的开发工程为NC-HR自助模块的源开发工程HR_WEB5.6_dev。在Eclipse中导入HR_WEB5.6_dev工程，如下：在Dorado集成开发平台中导入HR_WEB5.6_dev工程如下：1.3.自助单据开发流程在自助服务下开发的JSP界面，可将NC-UAP平台下的单据整合到自助服务中，这是通过将单据模板信息解析成Dorado控件来实现的，由于是根据单据模板信息表中的数据进行解析的，对于用元数据制作的单据模板，在自助服务界面目前还没有做到很好的兼容，解析过程中还没有增加对元数据的解析，故目前自助服务只能够对用数据字典制作的单据模板进行正确的解析，下面介绍在NC56中，如何用数据字典在自助服务下开发轻量级单据界面。1.3.1.建立数据模型根据具体的业务在PowerDesigner中建立对应的业务模型，本例中介绍的为休假计划的业务。1.3.2.导入数据字典具体的数据字典导入在【客户化】→【二次开发工具】→【系统管理工具】→【数据字典管理】节点来实现导入。1.3.3.单据模板初始化在完成数据字典导入之后，就可以在【客户化】→【二次开发工具】→【模板管理】→【单据模板初始化】节点通过数据字典制作相应的单据模板，具体的与NC5.2初始化单据模板一致。本例初始化完的单据模板卡片界面显示如下：1.3.4.导出Java源代码通过UAP集成开发平台导出Java源代码。在通过数据源生成VO代码之前，一定要保证在数据库中将数据模型对应的表结构建立，否则在选择数据库表处看不到单据对应的数据库表，具体的建表SQL脚本可以在建模时，通过PowerDesigner生成。选择完对应的数据库表，设置对应的VO信息以及对应到文件导出目录（%当前eclipse工程%/src/public包）后，点击“确定”按钮，即可完成对VO的导出。1.3.5.建立视图层ViewModel。ViewModel是一种用于封装界面逻辑和操作逻辑的对象。即视图中包含哪些数据、这些数据以什么方式展现、视图中包含哪些控件、这些控件会激发什么操作等等。我们可以把ViewModel看作是Dataset和各种控件的容器。ViewModel一般不用于定义各种控件最终在显示的布局，控件布局应通过其它方式进行定义。在通常情况下，我们利用JSP来完成对ViewModel中定义的控件进行布局。在Dorado集成开发平台中打开项目工程，在对应的目录下，右键鼠标，如下：选择新建“Module“，进入ViewModel新建向导。选择通用的视图模型对象（CommonViewModel）即可，点击“OK”，输入视图模型对象名称，即会在相应的目录下生成一个视图模型对象的XML配置文件，配置文件名称为[输入对象名称.view.xml],如本例在新建视图模型对象的时候输入的名称为LeavePlanOne,则生成的视图模型对象的名称为：LeavePlanOne.view.xml。1.3.6.生成JSP页面对于自助JSP页面是通过ViewModel生成的，具体生成JSP的操作如下图所示：选择相应的路径以保存生成的JSP文件。再生成JSP页面之后，需要对生成的JSP页面先进行简单的布局配置，如果需要配置其他在ViewModel中定义的控件显示，在