用友NCUAP单据开发手册.docx

1、用友NCUAP单据开发手册用友NC客户化开发手册NC-UAP 5.7用友NC-UAP作者：*2012-7-10初级开发开发环境搭建一、配置nchomebin文件夹下ncSysConfig.bat1、配置数据源（通常情况下：design为默认数据源名称，如果有两个数据库以上，需要配置多个数据源）2、配置端口（这里配置端口参考nchomeconfserver.xml）二、配置eclipse开发工具1、配置MDE Development（Window-Preferences-MDE Development） 选择nchome所在位置、检查数据库连接是否通过、设置数据源为默认数据源、点击ok设置完成。

2、设置端口（与nchomebin文件夹下ncSysConfig.bat配置端口一致）2、配置Installed JERs注意：nchomeufjdkjrelibplugin.jar和nchomeufjdklib tools.jar为必选插件，不然启动客户端的时候会报错。点击确定，完成配置（最好留下当前在用的JERs，其他全部Remove掉）3、建立Module Project （选择Module Project-填写Project Name-Module Name-点击Finish）工程建立完成后如下图：4、配置eclipse内存-Dnc.exclude.modules=$FIELD_EX_MO

3、DULES -Dnc.runMode=develop -Dnc.server.location=$FIELD_NC_HOME -DEJBConfigDir=$FIELD_NC_HOME/ejbXMLDExtServiceConfigDir=$FIELD_NC_HOME/ejbXMLs -Xms768m -Xmx768m表设计(PowerDesigner建模)建表ts char(19) null default convert(char(19),getdate(),20), 特别注意 建表时必须加ts和drdr smallint null default 0 主表建表脚本：create tabl

4、e dj_loan ( pk_loan char(20) not null, pk_corp char(4) null, pk_busitype char(20) null, pk_billtype varchar(4) null, vbillstatus smallint null, vbillno varchar(30) null, dbilldate char(10) null, voperatorid char(20) null, dmakedate char(10) null, vapproveid char(20) null, dapprovedate char(10) null,

5、 vapprovenote varchar(512) null, vdealerid char(20) null, vdeptid char(20) null, vmemo varchar(2048) null, vdef1 varchar(100) null, vdef2 varchar(100) null, vdef3 varchar(100) null, vdef4 varchar(100) null, vdef5 varchar(100) null, vdef6 varchar(100) null, vdef7 varchar(100) null, vdef8 varchar(100)

6、 null, vdef9 varchar(100) null, vdef10 varchar(100) null, vreserve1 varchar(100) null, vreserve2 varchar(100) null, vreserve3 varchar(100) null, vreserve4 varchar(100) null, vreserve5 varchar(100) null, vreserve6 varchar(100) null, vreserve7 varchar(100) null, vreserve8 varchar(100) null, vreserve9

7、varchar(100) null, vreserve10 varchar(100) null, pk_account char(20) null, pk_hall char(20) null, vmkno varchar(30) null, nloanmny decimal(20,8) null, dloandate char(10) null, nloanquota decimal(20,8) null, nsignquota decimal(20,8) null, drepaydate char(10) null, vmarkername varchar(40) null, vrepay

8、name varchar(40) null, nrepaymny decimal(20,8) null, nrepayinterestmny decimal(20,8) null, vsecurity varchar(40) null, dtrdate char(10) null, iloantype varchar(20) null, vhandperson varchar(40) null, iscount char(1) null, isuse char(1) null, constraint pkpm_noncontfee primary key nonclustered (pk_lo

9、an)，ts char(19) null default convert(char(19),getdate(),20), 特别注意 建表时必须加ts和drdr smallint null default 0 )Go子表建表脚本:create table dj_loan_b ( pk_loan_b char(20) not null, pk_loan char(20) null, vmemo varchar(100) null, vdef1 varchar(100) null, vdef2 varchar(100) null, vdef3 varchar(100) null, vdef4 var

10、char(100) null, vdef5 varchar(100) null, vdef6 varchar(100) null, vdef7 varchar(100) null, vdef8 varchar(100) null, vdef9 varchar(100) null, vdef10 varchar(100) null, vreserve1 varchar(100) null, vreserve2 varchar(100) null, vreserve3 varchar(100) null, vreserve4 varchar(100) null, vreserve5 varchar

11、(100) null, vreserve6 varchar(100) null, vreserve7 varchar(100) null, vreserve8 varchar(100) null, vreserve9 varchar(100) null, vreserve10 varchar(100) null, vsourcebilltype varchar(4) null, vsourcebillid char(20) null, vsourcebillrowid char(20) null, inumber int null, vrepayperson varchar(40) null,

12、 nrepaymny decimal(20,8) null, nrepayinterest decimal(20,8) null, nsurplusmny decimal(20,8) null, drepaydate char(10) null, dtrdate char(10) null, isshareholder char(1) null, pk_mkrepay char(20) null, constraint pkpm_costbill_b primary key nonclustered (pk_loan_b)，ts char(19) null default convert(ch

13、ar(19),getdate(),20), 特别注意 建表时必须加ts和drdr smallint null default 0 )go导入数据字典VO生成第一步：二次开发工具-UAP集成开发工具- UAP集成开发工具第二步：工具和选项-根据数据源生成VO第三步：选择数据库表-把主子表拉到相应位置-点击确定 第四步：把生成的VO拷贝到eclipse开发工具中（src/public文件夹下）功能注册说明：nc.ui.study.h101.ClientUI 为客户端入口类，ClientUI名字一般都是写成这个，nc.ui.study.h101.为每个功能节点对应的包名。自定义菜单说明：新建的节点，

14、系统一般都会把它归纳在其他节点上面去，这样分配权限的时候就找不到对应的节点进行分配权限，所以一般需要在自定义菜单这里点击恢复默认结构，这样在分配权限的时候才能看到对应的节点。分配权限说明：权限管理-权限分配-保存单据类型注册说明：二次开发工具-单据管理-单据类型管理单据模板生成说明：二次开发工具-模板管理-单据模板初始化第一步：填写单据模板类型（如果第一次则需要填写，一般跟单据类型一致）、选择主表和子表、点击增加按钮（如果是第一次则点击增加，否则点击修改按钮）第二步：选择主表和子表修改页签项目编辑和项目重新排序Ctrl+S保存（第一次保存需要填写模板标题和节点号）查询模板生成生成查询模板单据分

15、配查询模板VO对照主表子表动作脚本执行动作脚本sql语句Insert into PUB_BUSICLASS(ACTIONTYPE,CLASSNAME,DR,ISBEFORE,PK_BILLTYPE,PK_BUSICLASS,PK_BUSINESSTYPE,PK_CORP,TS)Values(APPROVE,N_H101_APPROVE,0,N,H101,0001AA000000000H1011,null,null,2011-09-09 10:01:05);Insert into PUB_BUSICLASS(ACTIONTYPE,CLASSNAME,DR,ISBEFORE,PK_BILLTYPE

16、,PK_BUSICLASS,PK_BUSINESSTYPE,PK_CORP,TS)Values(DELETE,N_H101_DELETE,0,N,H101,0001AA000000000H1012,null,null,2011-03-21 11:10:02);Insert into PUB_BUSICLASS(ACTIONTYPE,CLASSNAME,DR,ISBEFORE,PK_BILLTYPE,PK_BUSICLASS,PK_BUSINESSTYPE,PK_CORP,TS)Values(UNAPPROVE,N_H101_UNAPPROVE,0,N,H101,0001AA000000000H

17、1013,null,null,2011-03-21 11:09:32);Insert into PUB_BUSICLASS(ACTIONTYPE,CLASSNAME,DR,ISBEFORE,PK_BILLTYPE,PK_BUSICLASS,PK_BUSINESSTYPE,PK_CORP,TS)Values(EDIT,N_H101_EDIT,0,N,H101,0001AA000000000H1014,null,null,2011-03-21 11:09:53);Insert into PUB_BUSICLASS(ACTIONTYPE,CLASSNAME,DR,ISBEFORE,PK_BILLTY

18、PE,PK_BUSICLASS,PK_BUSINESSTYPE,PK_CORP,TS)Values(WRITE,N_H101_WRITE,0,N,H101,0001AA000000000H1015,null,null,2011-03-21 11:09:22);Insert into PUB_BUSICLASS(ACTIONTYPE,CLASSNAME,DR,ISBEFORE,PK_BILLTYPE,PK_BUSICLASS,PK_BUSINESSTYPE,PK_CORP,TS)Values(SAVE,N_H101_SAVE,0,N,H101,0001AA000000000H1016,null,

19、null,2011-03-21 11:09:22);代码修改代码copy聚合VO修改类名：nc.vo.ps.bz1002. MyBillVOpublic void setChildrenVO(CircularlyAccessibleValueObject children) if (children = null | children.length = 0) super.setChildrenVO(null); else / super.setChildrenVO(children);/单表 super.setChildrenVO(StockItemsVO) children);/ 主子表 修

20、改ClientUICtrl单据类型 public String getBillType() return “H101; 获取单据VO信息 public String getBillVoName() return new String MyBillVO.class.getName(), StockVO.class.getName(), StockItemsVO.class.getName() ; 子表PK public String getChildPkField() return pk_stock_id; 没子表时返回null保存主子表单表头或单表体public class ClientUIC

21、trl extends AbstractManageController implements ISingleController 主子表public class ClientUICtrl extends AbstractManageController 实现了implements ISingleController接口，只保存单表头或单表体设置默认值public void setDefaultData() throws Exception BillField fileDef = BillField.getInstance(); UFDate dmakedate = ClientEnviron

22、ment.getInstance().getDate(); String billtype = getUIControl().getBillType(); String pkCorp = ClientEnvironment.getInstance().getCorporation().getPrimaryKey(); fileDef.getField_BillStatus(); /取操作员 String pk_manager = ClientEnvironment.getInstance().getUser().getPrimaryKey() ; getBillCardPanel().setH

23、eadItem(pk_corp, pkCorp); /公司主键 getBillCardPanel().setHeadItem(vbillstatus, new Integer(IBillStatus.FREE).toString();/单据状态 默认为自由态 getBillCardPanel().setHeadItem(voperatorid, pk_manager); /制单人 getBillCardPanel().setHeadItem(dmakedate, dmakedate); /制单日期 getBillCardPanel().setHeadItem(pk_billtype, bill

24、type); /单据类型 设置单据号到这个阶段，单据的增删改查功能操作基本完成。中级开发增加自定义按钮按钮IDpackage nc.ui.ps.bz.button;/* * 功能：公共自定义按钮接口 * * 创建日期：2010-6-4 创建人：赖利荣 * * 修改日期： * * 修改内容： * * 单位：珠海用友软件有限公司 版本1.0V */public interface UserDefButton /* * 导入按钮 2010-6-4 */ public final static int fileInt = 510; /* * 导出按钮 2010-6-4 */ public final

25、static int fileOut = 511; /* * 文件管理 */ public final static int fileIO = 512;按钮VOpackage nc.ui.ps.bz.button;import nc.vo.trade.button.ButtonVO;/* * 功能： * * 创建日期：2010-6-4 创建人：赖利荣 * * 修改日期： * * 修改内容： * * 单位：珠海用友软件有限公司 版本1.0V */public class UserDefButtonVO /* * 功能：导入按钮 * * 创建日期：2010-6-4 创建人：赖利荣 * * 修改日期

26、： * * 修改内容： * * return */ public ButtonVO getFileInt() ButtonVO btVO = new ButtonVO(); btVO.setBtnNo(UserDefButton.fileInt); btVO.setBtnCode(导入); btVO.setBtnName(导入); btVO.setHintStr(导入); btVO.setBtnChinaName(导入); btVO .setOperateStatus(new int nc.ui.trade.base.IBillOperate.OP_ALL ); btVO.setBusines

27、sStatus(new int nc.vo.trade.pub.IBillStatus.ALL ); return btVO; /* * 功能：导出按钮 * 创建日期：2010-6-4 创建人：赖利荣 * 修改日期： * 修改内容： * return */ public ButtonVO getFileOut() ButtonVO btVO = new ButtonVO(); btVO.setBtnNo(UserDefButton.fileOut); btVO.setBtnCode(导出); btVO.setBtnName(导出); btVO.setHintStr(导出); btVO.setB

28、tnChinaName(导出); btVO .setOperateStatus(new int nc.ui.trade.base.IBillOperate.OP_ALL ); btVO.setBusinessStatus(new int nc.vo.trade.pub.IBillStatus.ALL ); return btVO; /* * 功能：文件管理按钮 * 创建日期：2010-6-4 创建人：赖利荣 * 修改日期： * 修改内容： * return */ public ButtonVO getFileIntOut() ButtonVO btVO = new ButtonVO(); btVO.setBtnNo(UserDefButton.fileIO); btVO.setChildAry(new int UserDefButton.fileIn