快速开发工具基础介绍

1、U8知识库文档U8开发之快速开发工具知识库属性适用产品单据、列表等相关产品，不适用报表、工作流支持版本V11.0 ; V890; V10.0; V10.1; 行业通用关键字最后更新时间作者摘要U8快速开发工具是针对客户化开发的特点，基于U8平台而开发的一套简化、快速、高效的U8单据开发工具。使用快速开发工具开发的单据与U8标准单据风格一致，可通过数据库脚本的简单调整设置单据上字段格式（文本、日期、参照、下拉框）等。使用快速开发工具开发的单据可以注册单据插件实现复杂逻辑编写。快速开发工具是基于VB 6.0 开发工具，依据用友U8单据开发原理开发的适用于客户化快速、高效、简单、易学的特点而开发的一

2、套工具。目前快速开发工具分为V890、V10.1、V11.0 三个版本。什么是快速开发工具？ 快速开发工具包含三部分：1、 快速开发工具基础安装包：安装快速开发工具所用到的基类；2、 使用快速开发工具完成的Demo样例：安装Demo样例后，开发人员可以参照Demo样例的数据库脚本，快速完成客户化单据脚本。3、 脚本抽取工具：使用快速开发工具完成的单据都是通过大量的数据库脚本来实现的，因此使用数据库脚本抽取工具可以直接抽取单据用到的脚本。目标本文主要介绍如何安装及使用快速开发工具，如何设置单据模板的下拉、参照，如何设置自定义按钮，挂接客户化开发代码，如何使用快速开发工具设置单据列表。快速开发工具

3、可以做什么？ 快速开发工具主要是用来做U8的客户化单据开发。1. 数据字典略。如何安装快速开发工具？1. 安装基础安装包（890/10.0/10.1/11.0）安装包依据U8产品版本的不同而有相应的适用版本安装KK-U8110-201303212339-EFBASE.msi文件进入安装界面 重启机器。安装完成后会在U8的安装目录下出现KK文件夹，此处存放快速开发工具。2. 安装Demo样例配合快速开发工具，我们提供了Demo样例。安装KK-U8110-201303220000-EFDEMO.msi 输入数据库连接密码，选择要升级的账套。 安装完成后，在U8的安装目录下生成脚本文件。如下图所示：

4、脚本包含Demo样例的单据脚本、视图脚本、物理表脚本等。进入U8企业应用平台基础设置基础信息系统启用，启用“培训DEMO模块”，如下图所示：启用该模块后，在U8业务工作供应链模块下会出现“培训DEMO模块”。如下图所示：双击菜单，进入单据新增界面，如下图所示：3. 脚本抽取工具配合U8快速开发方法，在快速开发工具基础安装包中包含脚本抽取工具。如下图所示：运行脚本抽取工具输入数据库sa密码，点击登录，跳转到查询界面。1：选择账套；2、输入要查询单据的menu_id(支持模糊查询)；3、点击抽取按钮（可分别选择单据、列表、权限、菜单）到此为止，快速开发工具及样例都已安装完成。快速开发工具应用以下以

5、新增“DEMO业务单3”单据为例进行讲解。1. 创建“DEMO业务单3”菜单首先，以“DEMO 业务单1”为范例，使用脚本抽取工具抽取“DEMO 业务单1”的菜单脚本，如下图所示：选择“菜单”页签，勾选“DEMO 业务单1”（支持按照单据名称、CardNum模糊查询），点击“抽取”按钮，此时在上面窗体出现对应出菜单脚本，将脚本考入文本编辑器：DEMO业务单1 预置菜单脚本 -当前工具版本 V11.2.5 脚本创建时间:2013-03-22 16:18:43- 创建菜单脚本GO- select * from UA_Menu where cMenu_id='EF'IF NOT EX

6、ISTS (select * from UA_Menu where cMenu_id='EF') BEGIN delete from UA_Menu where cMenu_id='EF'insert into UA_Menu (cMenu_Id,cMenu_Name,cMenu_Eng,cSub_Id,IGrade,cSupMenu_Id,bEndGrade,cAuth_Id,iOrder,iImgIndex,Paramters,Depends,Flag,IsWebFlag,cImageName)values('EF','培训DEMO模

7、块',Null,Null,0,'SCMG','0','','-8000',0,Null,Null,Null,Null,Null)END GO- select * from UA_Menu where cMenu_id='EF02'IF NOT EXISTS (select * from UA_Menu where cMenu_id='EF02') BEGIN delete from UA_Menu where cMenu_id='EF02'insert into UA_Men

8、u (cMenu_Id,cMenu_Name,cMenu_Eng,cSub_Id,IGrade,cSupMenu_Id,bEndGrade,cAuth_Id,iOrder,iImgIndex,Paramters,Depends,Flag,IsWebFlag,cImageName)values('EF02','业务单据',Null,Null,1,'EF','0','','1010',4,Null,Null,Null,Null,Null)END GO- select * from UA_Menu whe

9、re cMenu_id='EF0201'IF NOT EXISTS (select * from UA_Menu where cMenu_id='EF0201') BEGIN delete from UA_Menu where cMenu_id='EF0201'insert into UA_Menu (cMenu_Id,cMenu_Name,cMenu_Eng,cSub_Id,IGrade,cSupMenu_Id,bEndGrade,cAuth_Id,iOrder,iImgIndex,Paramters,Depends,Flag,IsWebFla

10、g,cImageName)values('EF0201','DEMO业务单1',Null,Null,2,'EF02','1','','1010',4,Null,Null,Null,Null,Null)END GO依据以上'DEMO业务单1'菜单脚本，修改为“DEMO业务单3”的菜单脚本，如下：DEMO业务单3预置菜单脚本IF NOT EXISTS (select * from UA_Menu where cMenu_id='EF0203') BEGIN delete

11、from UA_Menu where cMenu_id='EF0203'insert into UA_Menu (cMenu_Id,cMenu_Name,cMenu_Eng,cSub_Id,IGrade,cSupMenu_Id,bEndGrade,cAuth_Id,iOrder,iImgIndex,Paramters,Depends,Flag,IsWebFlag,cImageName)values('EF0203','DEMO业务单',Null,Null,2,'EF02','1','','1

12、010',4,Null,Null,Null,Null,Null)END GO参考附录DEMO单据3菜单.sql同理可以预置“DEMO业务单3列表”的菜单脚本，参考附录DEMO单据3列表菜单.sqlDEMO业务单3列表- select * from UA_Menu where cMenu_id='EF0303'IF NOT EXISTS (select * from UA_Menu where cMenu_id='EF0303') BEGIN delete from UA_Menu where cMenu_id='EF0303'insert

13、 into UA_Menu (cMenu_Id,cMenu_Name,cMenu_Eng,cSub_Id,IGrade,cSupMenu_Id,bEndGrade,cAuth_Id,iOrder,iImgIndex,Paramters,Depends,Flag,IsWebFlag,cImageName)values('EF0303','DEMO业务单3列表',Null,Null,2,'EF03','1','','1010',4,Null,Null,Null,Null,Null)END GO将调整好的

14、菜单脚本在账套库中执行。重新登录U8企业应用平台，则能看到新增的“DEMO业务单3”及列表菜单，如下图所示：2. 创建“DEMO业务单3”单据使用脚本抽取工具抽取“DEMO业务单1”的单据脚本，以“DEMO业务单1”的脚本为范例制作“DEMO业务单3”的脚本，如下图所示：将上面窗体的脚本考到文本编辑器中。将“DEMO业务单1”的单据脚本进行如下几步修改：a) 全局替换“EF0201”为“EF0203”（将demo1的菜单、cardnum等标识替换为demo3的）b) 全局替换“DEMO业务单1”为“DEMO业务单3”（将demo1的菜单名称换成demo3的）c) 全局替换“EF0301”为“E

15、F0303”（将demo1的列表菜单换为demo3的列表菜单）“DEMO业务单3”单据脚本参考附录DEMO单据3.sql将下面窗体脚本拷贝到文本编辑器中（V11.0 的按钮脚本在UfMeta库中，V11.0 之前版本则没有此脚本）将“EF0201” 全局替换为“EF0203”，在数据库的UfMeta库中执行。参考附录DEMO业务单3按钮meta.sql经过以上操作“DEMO业务单3”就完成了。通过快速开发工具制作的脚本，系统自动生成对应的列表（V11.0的快速开发工具包含列表过滤条件的生成，V11.0之前版本，列表过滤条件需要手工设置）3. 设置下拉菜单项尽管快速开发工具样例中预置了几个下拉框

16、字段，但客户的需求复杂多样，往往需要更多的下拉框字段，下面介绍如何设置下拉框字段：a) 启用表头某项例如启用表头str10字段，显示名称为“下拉框示例”，对他进行布局，保存单据模板，如下图所示：启用表头项后要重新抽取脚本以获取最新单据脚本。在最新的单据脚本中执行下面的操作。b) 修改VoucherItems_Base里面被启用字段的参照类型，ReferType4注意：1 UAP档案参照，2 数值参照，3 日期参照，4 下拉参照，5 无参照，7、自定义参照、8、多文本输入框、10 、附件参照修改VoucherItems_Base 表insert into VoucherItems_Base (V

17、T_ID,CardNum,CardItemNum,CanNotSelect,ShowIt,LinkIt,LinkTbl,LinkField,TableName,FieldName,FieldType,ReferType,ReferTable,CardSection,CanModify,MaxLength,MaxShowLen,NumPoint,IsNull,CanDelete,UserCheck,UserPrompt,FormatChar,IsMain,NeedSum,CalcField,AliasNum,isSelfDef,COX,COY,Width,Height,TabIndex,Defa

18、ultValue,IsFixedLenght,FormatData,PrintCaption,PrintUpcase,PrintInterval,DataSource,EnterType,DataRule,ValidityCheck,ReserveSegTitlePos,BuildArchives,ReferReturnField,cmemo,nBorder,EnumType,IsEnum,EnumTypeString,bZeroAllowable,iFlags,vValueDefault,refObject,AutoFillRule,Catalog,bsplit,IsJoinQuery,bE

19、xtended,bIMFld,bAutoComplete)values(VT_ID,'EF0203','58','0','0',0,Null,Null,'','str10',1,4,Null,'T','1',20,2000,0,'0',1,Null,Null,'1','0',0,'0',0,1,58,58,2000,250,58,'','0','','

20、;1','0','',0,0,'','0','1','0',Null,'',0,Null,'0',Null,'1',0,'',Null,Null,0,'0','0',0,0,'0')c) 增加sa_voucherfieldconfig中记录，其中refertype 4在sa_voucherfieldconfig表加记录insert into sa_voucherfieldconfi

21、g (cardnumber,cardsection,fieldname,refertype,refername,referdefaultfilter,refermultilines,referdispmode,referfilterfields,fillselectsql,cellchecksql,mustinputtype,rowcolchange,addnewdefaultvalue,copyclear,errresid,iautojusttype,refershowstyle,filterfields,fieldtype,refautodisp)values('EF0203

22、9;,'T','str10','4','EF0203_str10',Null,'0',1,Null,Null,'select * from code where (ccode=''retvalue'' or ccode_name=''retvalue'')',Null,Null,Null,'0','科目录入不正确或者没有权限或者被停用，请检查！',Null,0,'ccode,ccode_name&

23、#39;,Null,'0')d) 增加aa_enum记录其中EnumType 值要与sa_voucherfieldconfig表的refername字段一致 增加aa_enum 表记录insert into aa_enum (EnumType,EnumCode,LocaleId,EnumName,EnumIndex,cProjectNO)values('EF0203_str10','甲','ZH-CN','甲',0,'U870')insert into aa_enum (EnumType,EnumC

24、ode,LocaleId,EnumName,EnumIndex,cProjectNO)values('EF0203_str10','乙','ZH-CN','乙',1,'U870')insert into aa_enum (EnumType,EnumCode,LocaleId,EnumName,EnumIndex,cProjectNO)values('EF0203_str10','丙','ZH-CN','丙',2,'U870')完成以上脚

25、本修改后，在SQL中执行，参考附录:DEMO单据3.sql,重新打开demo3单据，如下图所示：4. 设置参照项快速开发工具样例中预置了一部分基本参照，例如部门档案、人员档案、存货档案、仓库档案等，但是客户的需求形形色色，如何设置个性化的参照呢？下面介绍如何设置参照：a) 启用表头某项例如启用表头str11、str12字段，显示名称为存“产品编码”、“产品名称”，对他进行布局，保存单据模板，如下图所示：启用表头项后要重新抽取脚本以获取最新单据脚本。在最新的单据脚本中执行下面的操作。b) 修改VoucherItems_Base里面被启用字段的类型，ReferType1修改VoucherItems

26、_Base 表insert into VoucherItems_Base (VT_ID,CardNum,CardItemNum,CanNotSelect,ShowIt,LinkIt,LinkTbl,LinkField,TableName,FieldName,FieldType,ReferType,ReferTable,CardSection,CanModify,MaxLength,MaxShowLen,NumPoint,IsNull,CanDelete,UserCheck,UserPrompt,FormatChar,IsMain,NeedSum,CalcField,AliasNum,isSel

27、fDef,COX,COY,Width,Height,TabIndex,DefaultValue,IsFixedLenght,FormatData,PrintCaption,PrintUpcase,PrintInterval,DataSource,EnterType,DataRule,ValidityCheck,ReserveSegTitlePos,BuildArchives,ReferReturnField,cmemo,nBorder,EnumType,IsEnum,EnumTypeString,bZeroAllowable,iFlags,vValueDefault,refObject,Aut

28、oFillRule,Catalog,bsplit,IsJoinQuery,bExtended,bIMFld,bAutoComplete)values(VT_ID,'EF0203','59','0','1',0,Null,Null,'','str11',1,1,Null,'T','1',20,2000,0,'0',1,Null,Null,'1','0',0,'0',0,1,240,1680,2000,250

29、,59,'0,0','0','','1','0','',0,0,'','0','1','0',Null,'',0,Null,'0',Null,'1',0,'',Null,Null,0,'0','0',0,0,'0')insert into VoucherItems_Base (VT_ID,CardNum,CardItemNum

30、,CanNotSelect,ShowIt,LinkIt,LinkTbl,LinkField,TableName,FieldName,FieldType,ReferType,ReferTable,CardSection,CanModify,MaxLength,MaxShowLen,NumPoint,IsNull,CanDelete,UserCheck,UserPrompt,FormatChar,IsMain,NeedSum,CalcField,AliasNum,isSelfDef,COX,COY,Width,Height,TabIndex,DefaultValue,IsFixedLenght,F

31、ormatData,PrintCaption,PrintUpcase,PrintInterval,DataSource,EnterType,DataRule,ValidityCheck,ReserveSegTitlePos,BuildArchives,ReferReturnField,cmemo,nBorder,EnumType,IsEnum,EnumTypeString,bZeroAllowable,iFlags,vValueDefault,refObject,AutoFillRule,Catalog,bsplit,IsJoinQuery,bExtended,bIMFld,bAutoComp

32、lete)values(VT_ID,'EF0203','60','0','1',0,Null,Null,'','str12',1,1,Null,'T','1',20,2000,0,'0',1,Null,Null,'1','0',0,'0',0,1,3120,1680,2000,250,60,'0,0','0','','1','0

33、9;,'',0,0,'','0','1','0',Null,'',0,Null,'0',Null,'1',0,'',Null,Null,0,'0','0',0,0,'0')c) 增加sa_voucherfieldconfig 表记录注意修改中refertype,refername两个字段在sa_voucherfieldconfig表加记录insert into sa_voucherfieldconfig

34、(cardnumber,cardsection,fieldname,refertype,refername,referdefaultfilter,refermultilines,referdispmode,referfilterfields,fillselectsql,cellchecksql,mustinputtype,rowcolchange,addnewdefaultvalue,copyclear,errresid,iautojusttype,refershowstyle,filterfields,fieldtype,refautodisp)values('EF0203'

35、,'T','str11','1','ProductRef',Null,'0',1,Null,Null,'select * from person PersonEntity_Person left join department on PersonEntity_Person.cdepcode=department.cdepcode where (cpersoncode=''T,cpersoncode'' or cpersonname=''T,t_cpersonc

36、ode'')',Null,Null,Null,'0','U8.SA.USSASERVER.clscommcheck.00418',Null,0,'cpersoncode,cpersonname',Null,'0')insert into sa_voucherfieldconfig (cardnumber,cardsection,fieldname,refertype,refername,referdefaultfilter,refermultilines,referdispmode,referfilterf

37、ields,fillselectsql,cellchecksql,mustinputtype,rowcolchange,addnewdefaultvalue,copyclear,errresid,iautojusttype,refershowstyle,filterfields,fieldtype,refautodisp)values('EF0203','T','str12','1','ProductRef',Null,'0',1,Null,Null,'select * from perso

38、n PersonEntity_Person left join department on PersonEntity_Person.cdepcode=department.cdepcode where (cpersoncode=''T,cpersonname'' or cpersonname=''T,t_cpersonname'')',Null,Null,Null,'0','U8.SA.USSASERVER.clscommcheck.00418',Null,0,'cpersoncod

39、e,cpersonname',Null,'0')以上脚本中的refername字段取自参照设计器中的产品参照，参照编码为'ProductRef'd) 增加SA_ReferFillConfig中的记录，设定参照值，显示值等 在sa_referfillconfig表加记录insert into SA_ReferFillConfig (cardnumber,fieldname,cardsection,refername,sourcefieldname,destfieldname,breferfill,bcellcheckfill,bclear,bcheckch

40、ange,changemsg)values('EF0203','str11','T','ProductRef','cInvCode','str11','1','1','1',0,Null)insert into SA_ReferFillConfig (cardnumber,fieldname,cardsection,refername,sourcefieldname,destfieldname,breferfill,bcellcheckfill,bcl

41、ear,bcheckchange,changemsg)values('EF0203','str11','T','ProductRef','cInvName','str12','1','1','1',0,Null)insert into SA_ReferFillConfig (cardnumber,fieldname,cardsection,refername,sourcefieldname,destfieldname,breferfill,bcellc

42、heckfill,bclear,bcheckchange,changemsg)values('EF0203','str12','T','ProductRef','cInvCode','str11','1','1','1',0,Null)insert into SA_ReferFillConfig (cardnumber,fieldname,cardsection,refername,sourcefieldname,destfieldname,brefe

43、rfill,bcellcheckfill,bclear,bcheckchange,changemsg)values('EF0203','str12','T','ProductRef','cInvName','str12','1','1','1',0,Null)其中参照'ProductRef'用的栏目项可以通过以下方式来查询完成以上脚本修改后，在SQL中执行，参考附录：DEMO单据3.sql，重新打开demo3单据，如下图所示：5. 增加

44、自定义按钮例如在“DEMO业务单3”上增加参照领料申请单，脚本如下：在AA_FormButtons_base表加记录在AA_FormButtons_lang表加记录在AA_FormButtonMenus_base表加记录在AA_FormButtonMenus_lang表加记录insert into AA_FormButtons_base (cFormCode,cButtonKey,cGroup,cPic,cToolBarType,iToolBarStyle,iOrder,iheightRow,cHotKey,cAuthid,iVoucherCtlIndex,ctoolbarPosIndex,c

45、ResID,cTipResID,cSubID,cProjectNO,cForegroundColor,cBackgroundColor,cSetGroup,iSetGroupRow,ProcessObjectName,FunctionKey)values('EF0203','MakeVoucher','EF0203_P_20','Add','PortalToolbar',5,30,3,'Ctrl+G','',0,'P','','',&#

46、39;EF','U870','','','EF0203_P_20_10',1,'','')insert into AA_FormButtons_lang (cFormCode,localeid,cButtonKey,cCaption,cToolTip,cSubID,cProjectNO)values('EF0203','zh-CN','MakeVoucher','参照领料申请单','参照领料申请单','E

47、F','U870')insert into AA_FormButtonMenus_base (cFormCode,cButtonKey,cMenuKey,iOrder,cParentKey,igrade,cAuthid,cResID,cSubID,cProjectNO,cForegroundColor,cBackgroundColor,iMenuType,ProcessObjectName,FunctionKey)values('EF0203','MakeVoucher','MakeVoucher',10,'

48、9;,0,'','','EF','U870','black','',0,'','')insert into AA_FormButtonMenus_lang (cFormCode,localeid,cButtonKey,cMenuKey,cCaption,cToolTip,cSubID,cProjectNO)values('EF0203','zh-CN','MakeVoucher','MakeVoucher'

49、;,'领料申请单','领料申请单','EF','U870')参考附录：DEMO业务单3按钮meta.sql将以上脚本执行到UFMeta_999账套，如下图所示：重新打开“DEMO业务单3”，如下图所示：参照按钮的逻辑将在快速开发工具_如何进行参照生单开发.docx文档中介绍。6. 增加插件逻辑功能通过快速开发工具可以快速创建U8单据，可以通过数据库脚本的修改完成单据上简单功能，但是更复杂的逻辑无法通过脚本设置完成，则需要通过后台代码来实现。快速开发工具的插件代码基于Vb 6.0 开发工具。a) 调试插件前台代码启用VB创建“Act

50、iveX DLL”工程b) 调试插件前台代码根据用户的实际业务创建的实现对应的前端UI业务函数接口 将U8安装目录下的“. U8SOFTKKEFBASEXML”的文件“UI_UserConfig.xml”复制到“. U8SOFTKKEFBASE”下修改“. U8SOFTKKEFBASE UI_UserConfig.xml”在<userdll>Interface_demo.Cls_UI_interface</userdll>节点指定插件的文件名和类名在<userfunction>Userdll_Init</userfunction>节点指定当前插件

51、实现的接口名称参考附录：Interface_EFMO7. 创建单据列表以上介绍的是如何使用快速开发工具创建单据，该单据的列表由系统自动生成。实际应用中往往是根据某些逻辑创建列表，而不需要建立单据。现在介绍不创建单据，仅创建列表的操作方法。参考快速开发工具的“DEMO 业务单1”例子，快速开发工具抽取的脚本有一部分是“预置单据列表数据以下部分脚本为工具自动生成，不需要手工预置”这部分即为单据列表的脚本。一个单据列表包含五部分组成：1、 菜单2、 栏目3、 视图4、 过滤5、 相关脚本以下以创建发货单列表为例。a) 创建发货单列表菜单参照以上介绍的创建菜单的方法。创建发货单列表菜单- 发货单列表I

52、F NOT EXISTS (select * from UA_Menu where cMenu_id='EF0304') BEGIN delete from UA_Menu where cMenu_id='EF0304'insert into UA_Menu (cMenu_Id,cMenu_Name,cMenu_Eng,cSub_Id,IGrade,cSupMenu_Id,bEndGrade,cAuth_Id,iOrder,iImgIndex,Paramters,Depends,Flag,IsWebFlag,cImageName)values('EF03

53、04','发货单列表',Null,Null,2,'EF03','1','','1010',4,Null,Null,Null,Null,Null)END GO在数据库中执行以上脚本，如下图所示：b) 创建视图本例以产品中的发货单列表为例，故直接使用原发货单列表的视图（如果是自己开发的单据列表，只需在listfrom 字段输入视图名称即可）。通过以上方式获得发货单的列表视图，将列表视图对应在下面的脚本中。视图对应脚本insert into sa_voucherlistconfig (ckey,listfrom,

54、defaultfilter,filtername,subsysid,columnkey,menuid,maintbl,detailtbl,mainkey,detailkey,showsumoption,canmodify) values('EF0304','Sales_FHD_T inner join Sales_FHD_W_ZHD on Sales_FHD_T.dlid=Sales_FHD_W_ZHD.dlid','','AR10903','EF','AR10903',Null,Null,Null

55、,Null,Null,'0','0') -c) 创建栏目可以使用产品中发货单列表的栏目，也可以自己创建栏目，将栏目的key值赋给columnkey字段即可。本例采用产品的发货单列表栏目。打开UAP工具栏目设计器，得到发货单列表的栏目key01d) 创建过滤可以使用产品中发货单列表的过滤条件，也可以自己创建过滤条件，将过滤的key值赋给filtername字段即可。本例采用产品的过滤条件。打开UAP工具过滤设计器，得到发货单列表的过滤keySA_01e) 创建列表脚本修改以上脚本：视图、栏目、参照对应脚本insert into sa_voucherlistconfig (ckey,listfrom,defaultfilter,filtername,subsysid,columnkey,menuid,maintbl,detailtbl,mainke