用友UAP单据开发(参照部分)

UAP单据开发(参照部分)编制人：编制日期：2012年10月目录1.功能概述...................................................................................................................................32.参照结构图...............................................................................................................................33.参照分类...................................................................................................................................46.参照设计...................................................................................................................................46.1.数据库注册参照模型类...............................................................................................46.2.NC模型和参照关联.....................................................................................................46.3.列表型参照Model设计..............................................................................................56.4.树型参照Model设计..................................................................................................76.5.左树右表型参照Model设计......................................................................................97.参照使用.................................................................................................................................107.1.实体层使用参照.........................................................................................................117.2.单据模板设置参照.....................................................................................................117.3.代码动态挂接参照.....................................................................................................127.4.自定义参照.................................................................................................................127.4.1.简单自定义参照.............................................................................................137.4.2.复杂自定义参照.............................................................................................137.5.设置参照多选.............................................................................................................138.重要类说明.............................................................................................................................138.1.UIRefPane中的设置:..................................................................................................138.2.refModle中的设置.....................................................................................................14适用对象：会制作单据模板，想进一步了解参照的使用1.功能概述参照控件一般在界面上表现形式是控件上有个，用户点击后，弹出对话框，用户选择数据后，数据回写到控件上，显示信息是text值，后台存有value值。这个和下拉框有些类似，但下拉框适用于数据条数少的，例如：请假方式，可能只有事假，婚假，病假，这几种形式，而参照适用于大批量数据，例如用户选择，可能涉及到集团选人的情况。同时参照也支持多选的情况，但下拉框一般不做成多选。2.参照结构图这个图示控件和参照绑定之间的关系，参照控件在界面上就是UIRefPane，它绑定的参照类需要继承…RefModel图1UIRefPaneUFRefManageIRefUINew2AbstractRefModel（表）系统默认实现UFRefGridTreeUIAbstractRefDialog例如银行类型BanktypeDefaultRefModellAbstractRefTreeModel（树）AbstractRefGridTreeModel（树表）例如部门档案DeptDefaultRefModel例如客商档案CustomerDefaultRefModelAbstractRefGridTreeBigDataModel（大数据树表参照）（树表）例如会计期间.AccPeriodDefaultRefModel3.参照分类系统默认有4种参照，他们分别是列表型、树型、左树右表型、大数据量树表型，同时可以自定义参照，除复杂自定义参照外，其他参照近需要定义RefModel即可，进行数据库注册，和控件的关联，平台会用对话框来展示这些数据，用户选择数据后，回写用户选择的数据，无需用户自己写对话框来展示数据。复杂的自定义参照，就需要用户来些对话框去展示自己的数据，以及界面布局1.表型：列表展示，它继承AbstrarctRefModel2.树型：tree树型结构显示，它继承AbstractRefTreeModel3.树表型：左边是树，右边是表，适合数据量比较大的，它继承AbstractRefGridTreeModel4.大数据量树表型：左边是树，右边是表，适合数据量比较大的，它继承AbstractRefGridTreeBigDataModel5.自定义参照，他和默认继承的类继承方式是一样的，只是不用数据库注册，在单据模板那里直接可以使用这个自定义参照。6.参照设计6.1.数据库注册参照模型类你可以先确定好类名，或者先写好Model类也可以，请修改code，metadatatypename,modulename,name,pk_refinfo,refclass，完整实例如下：INSERTINTOdbo.bd_refinfo(code,dr,isneedpara,isspecialref,metadatatypename,modulename,name,para1,para2,para3,pk_refinfo,refclass,refsystem,reftype,reserv1,reserv2,reserv3,resid,residpath,ts,wherepart)VALUES('dept100',0,NULL,NULL,'dept','demo','销售部门列表型参照测试',NULL,NULL,NULL,'Dept2000000000XYHJ','nc.ui.demo.ref.SaleDeptRefModel',NULL,0,NULL,NULL,NULL,'销售部门列表型参照测试','ref','2011-11-1115:01:24',NULL)6.2.NC模型和参照关联例如，给部门设计参照，设计完NC模型后，在参照页签中，选择【设置参照】，会弹出参照对话框，从对话框中选择上面数据库注册的参照模型类，这样你设计的参照模型类就挂接到实体上了，当别的实体引用部门后，就可以给部门挂接参照。步骤如下：图21.在NC模型设计器中，在引用模型中找到uap\meta\general_interface.bmf业务接口IBDObject拖到你的元数据界面上，建立业务接口和你的实体的业务接口属性映射，例如id和实体pk的关联，参照要求必须实现这个接口，才能使用参照2.设置参照，在参照那里选择设置参照，找到你数据库注册的那个参照6.3.列表型参照Model设计下面就是列表型参照设计的一个实际例子，同时注意红色字体部分，就是如何显示上级的，因为上级是个pk，所以要根据pk获取它的名称来显示。列表型图示如下，点击部门，显示下面的部门列表，同时支持多选。完整代码如下。图3publicclassSaleDeptRefModelextendsAbstractRefModel{publicSaleDeptRefModel(){reset();}publicvoidreset(){setRefNodeName(部门);setFieldCode(newString[]{code,name,mnecode,pk_fatherorg});setFieldName(newString[]{编码,名称,助记码,上级部门});setHiddenFieldCode(newString[]{pk_dept,displayorder,innercode});setPkFieldCode(pk_dept);setRefCodeField(code);setRefNameField(name);setTableName(DeptVO.getDefaultTableName());setMnecode(newString[]{mnecode,name});setAddEnableStateWherePart(true);setResourceID(dept);setFilterRefNodeName(newString[]{业务单元});setOrderPart(displayorder,code);resetFieldName();//获取上级部门Stringfomula_dept=name-getColValue(org_dept,name,p