UAP培训案例课堂案例操作手册扩展开发

1、NC-扩展开发培训课程NC-UAP61扩展开发操作手册开发前准备本次培训下面只要做以下几步，如果是新库，后面有详细步骤。a).用集团管理员登录b).按下面路径找到用户节点c.打开节点后查询，找到dev用户，选中dev点修改。d.修改studio中开发者信息如果是新的项目需要按以下几部操作。a).系统管理员登陆，应用管理平台>应用资产管理>开发者管理。添加开发者信息，确定开发层次（领域级，行业级，本地化级，伙伴级，客户级），此层次是开发人员所处的曾是，如果做扩展开发一定是红色部分的一个。b).建立用户，身份类型为<开发者>，身份选择第一步添加的开发者，生效日期尽量往前，否

2、则studio中关联时可能找不到用户c).Studio中关联添加的研发者，最下面填写密码，与用户密码一致，如果不填写密码，后面发布元数据会有问题。d).如果是进行行业扩展，需要修改uaphomeierpbin 中配置文件<industry_config.xml>内容,，如果不是进行行业扩展，跳过该步骤。内容如下： <?xml version="1.0" encoding="UTF-8"?><!DOCTYPE properties SYSTEM "<properties><entry key=&qu

3、ot;belongNCIndustryCode">行业</entry></properties>该配置文件在加载元数据时会被读取，系统读取会把发布的领域的及该配置文件的行业的元数据元数据信息，该行业信息可以通过下面sql查询select bi.pk_industry, from bd_industry bi order by bi.pk_industry 把查询出来需要扩展的行业信息，例如下面为部分查询的结果0综合控股集团1流程制造业101 装备制造 把0,1,101替换行业即可。详细扩展步骤实体扩展属性扩展及子实体扩展需求描述：1.客户为

4、了更好的预测报价单可能产生的费用，对报价单界面字段的要求。A).需要在在报价单单据的表头增加标识【是否含费用信息】、【费用金额】等字段， B).表体增加一个新页签【费用信息】。 具体步骤：1).打开 【uap MDP】设计器,打开后的界面如下2).在左边找到自己定义的组件。点击右键，弹出下面的对话框，点击【增量开发实体组件】3).点击后的画面如下：说明：组件所对应的元数据文件，在studio的帮助文档找到，如果不想找的到帮助文档中找可以通过下面的语句查询出来，但还需要自己到home中查找具体的路径，此sql只是查到对应的元数据文件名称。-查组件的名称select t.ownmodule 模块,

5、 t.displayname 实体名称, bmf文件名,space 模块 from md_component t where t.displayname like '%报价单%' order by ts desc 还需要到uaphomemodulesXX模块METADATA 的路径下查找元数据模型在METADATA中的具体的位置，在上图查找时使用。4). 找到对应的元数据,确定后会在你选择的组件下生成一个元数据模型。5).点击确定后会有如下图：6).双击该模型，则会在右侧出现7).点击“报价单表头”，在下面添加属性，属性名称必须以点击添加时以默认字符为结

6、尾：增加的属性见下表：对应编码字段名称类型bcludefee是否含费用信息布尔ntotalfeemny费用总金额数字nfeenote费用说明字符pk_salequotation消费信息源属性Array注意：a).新增属性的访问策略为”nc.md.model.access.NCBeanAccessor”。 b).属性扩展时，增加的属性必须填写扩展表，此处填写扩展表ext_table_h_301。消费信息源属性pk_salequotation扩展表一列不填写 c).动态属性表示勾上，如下图 8).增加费用信息子实体方法同标准单据子实体(增加属性，组合主实体等)。字段如下：对应编码字段名称类型pk_

7、ext_b子表主键字符icvexpensepsn报销人参照用户dfeedate费用日期日期dexpensedate报销日期日期ndetailfeemny费用金额数字vfeeaddress地址字符vnote备注字符vbdef1自定义项1字符vbdef2自定义项2字符注意：A).所有属性勾上动态属性 B).新增子实体数据访问类型：NCVOC).类名为：nc.vo.extend.entity.ExtBVO_301，类名需要以所属层次及机构编码或者行业编码结尾，如果不正确会有提示D).新增子实体名称,默认表名 此处设置为：ext_table_b_301 ，后缀命名同上。 显示名称：费用信息E).子实体

8、扩展时每个属性的名称不以后缀结尾，并且每个属性的扩展表不填写9). 启动中间件，点右键选择【发布元数据】。10).选中子实体,点击右键生成JAVA源代码11).点右键选择【生成建库脚本并执行】。12).重启客户段，清除缓存,否则生成单据模版时看不到新加的子实体13).生成单据模板a).新增单据模板，新增模板的页签编码需要与标准产品模板编码一样，因标准产品的代码中可能用到页签编码。 此处表头增加一个新分组，编码为headExtTab 名称为：费用信息b).新扩展的页签编码使用:bodyExtTab,页签名称：费用信息，按下图设置 d).新增的模版，需要在增加新的单据模板后需要到【功能节点默认模板

9、设置】节点进行分配，这样在集团初始化时系统会按照资产层次及国家地区的优先级把该模版分配初始化的集团。如下图：前台扩展说明：基于pubapp提供的扩展方式，入口类为：nc.ui.pubapp.uif2app.ToftPanelAdaptorEx的扩展按钮扩展替换按钮扩展需求描述：界面修改按钮要求A).每个报价单能管理对应的文档，客户要要把卡片界面的刷新按钮替换为【文档管理】按钮，用与单个文档操作（上传，下载等操作）。具体步骤：1).增加新的文档管理按钮 nc.ui.extend.pubapp.action.ExtDocManageAction，继承平台提供的文档管理按钮，重写可用性方法。2).添

10、加配置文件<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE beans PUBLIC "-/SPRING/DTD BEAN/EN" "/dtd/spring-beans.dtd"><beans><!- 替换 按钮配置 -><bean class="nc.ui.pubapp.plugin.action.ReplaceActionInfo"&g

11、t;<property name="actionContainer" ref="xxxxx" /><property name="actionType" value="xxxx" /><property name="target" ref="xxxx" /><property name="action" ref=" xxxx " /></bean><!文档管理 按钮 -&

12、gt;<bean id="docManageAction" class="nc.ui.extend.pubapp.action.ExtDocManageAction"><property name="model" ref="manageAppModel" /></bean></beans>3).注册扩展配置文件，在功能注册节点注册，非行业扩展的可增加参数名称为:PluginBeanConfigFilePath, 也可使用: PluginBeanConfigFilePa

13、th_开始后面加字符行业扩展参数名称:PluginBeanConfigFilePath_Industry行业编码_CountryZone本地化编码，实现不同集团不同行业加载不同的行业的扩展配置文件。 插入按钮扩展需求描述：界面修改按钮要求B).要求在编辑报价单时能批量选择附件。具体步骤：1).增加按钮:nc.ui.extend.pubapp.action.ChooseFileAction2).添加配置文件<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE beans PUBLIC "

14、-/SPRING/DTD BEAN/EN" "/dtd/spring-beans.dtd"><beans><!- 替换 按钮配置 -><bean class="nc.ui.pubapp.plugin.action.ReplaceActionInfo"><property name="actionContainer" ref="xxxxx" /><property name="ac

15、tionType" value="xxxx" /><property name="target" ref="xxxx" /><property name="action" ref=" xxxx " /></bean><!文档管理 按钮 -><bean id="docManageAction" class="nc.ui.extend.pubapp.action.ExtDocManageAction&

16、quot;><property name="model" ref="manageAppModel" /></bean><!插入按钮配置 -><bean class="nc.ui.pubapp.plugin.action.InsertActionInfo"><property name="actionContainer" ref=" xxxx " /><property name="actionType"

17、value=" xxxx " /><property name="target" ref=" xxxx " /><property name="pos" value=" xxxx " /><property name="action" ref=" xxxx " /></bean> <bean id="chooseFileAction" class="nc.ui.ext

18、end.pubapp.action.ChooseFileAction"><property name="model" ref="ManageAppModel" /></bean></beans>3).注册扩展配置文件，注册规则同替换按钮扩展 拦截按钮扩展需求描述：界面修改按钮要求C)点击【保存】按钮后，先把数据保存，再把选择的文件上传到服务器作为报价单的附件。具体步骤：1).增加保存拦截扩展类extend.ui.so.m30.action.SaveActionInterceptor2). 添加配置文件&

19、lt;?xml version="1.0" encoding="UTF-8"?><!DOCTYPE beans PUBLIC "-/SPRING/DTD BEAN/EN" "/dtd/spring-beans.dtd"><beans><!- 替换 按钮配置 -><bean class="nc.ui.pubapp.plugin.action.ReplaceActionInfo"><

20、property name="actionContainer" ref="xxxxx" /><property name="actionType" value="xxxx" /><property name="target" ref="xxxx" /><property name="action" ref=" xxxx " /></bean><!文档管理 按钮 -><

21、;bean id="docManageAction" class="nc.ui.extend.pubapp.action.ExtDocManageAction"><property name="model" ref="manageAppModel" /></bean><!插入按钮配置 -><bean class="nc.ui.pubapp.plugin.action.InsertActionInfo"><property name=&q

22、uot;actionContainer" ref=" xxxx " /><property name="actionType" value=" xxxx " /><property name="target" ref=" xxxx " /><property name="pos" value=" xxxx " /><property name="action" ref="

23、; xxxx " /></bean> <bean id="chooseFileAction" class="nc.ui.extend.pubapp.action.ChooseFileAction"><property name="model" ref="ManageAppModel" /></bean><!- 拦截 按钮配置 -><bean class="nc.ui.pubapp.plugin.action.ActionIn

24、terceptorInfo"><property name="target" ref="xxxx" /><property name="interceptor" ref="xxxxx" /></bean><bean id="interceptorForFile" class="nc.ui.extend.pubapp.action.SaveInterceptorForFile"><property name=

25、"billForm" ref="billFormEditor" /><property name="chooseAction" ref="chooseAction" /></bean></beans>nc.ui.pubapp.uif2app.eventAppUiStateChangeEvent.javaUI状态改变OrgChangedEvent.java组织改变PubAppEvent.java事件基类nc.ui.pubapp.uif2app.event.cardCardBo

26、dyAfterEditEvent.java卡片表体编辑后CardBodyAfterRowEditEvent.java卡片表体行编辑后CardBodyAfterSortEvent.java卡片表体排序后CardBodyBeforeBatchEditEvent.java卡片表体批编辑前CardBodyBeforeEditEvent.java卡片表体编辑前CardBodyBeforeSortEvent.java卡片表体排序前CardBodyMenuActionEvent.java卡片表体菜单点击CardBodyRowChangedEvent.java卡片表体行选择改变CardBodyRowEditE

27、vent.java卡片表体行编辑后CardBodyTabChangedEvent.java卡片表体页签改变CardBodyTotalEvent.java卡片表体汇总计算CardHeadTailAfterEditEvent.java卡片表头表尾编辑后CardHeadTailBeforeEditEvent.java卡片表头表尾编辑前3).注册扩展配置文件，注册规则同替换按钮扩展UI事件扩展需求描述：新增表头属性及页签后客户要求的界面逻辑控制：A).【是否含费用信息】如果选中则：【费用信息】页签及表头的【费用说明】能编辑且【费用信息】页签不能为空；如果取消则清空表头的【费用说明】并且不能编辑，保存时

28、把【费用信息】的填写信息清空。B).表头扩展的【费用总金额】为【费用信息】页签表体的费用金额合计。 C).【费用信息】页签的【费用日期】不能早于【报销日期】。具体步骤：1增加类：a).增加表头编辑后处理事件：nc.ui.extend.pubapp.editor.head.HeadAfterEditDistributeb).增加表体编辑前处理事件：nc.ui.extend.pubapp.editor.body.BodyBeforeEditDistributec).增加表体编辑后处理事件：nc.ui.extend.pubapp.editor.body.BodyAfterEditDistribute

29、d).增加卡片表体合计事件：nc.ui.extend.pubapp.editor.body.CalculatorHeadFeeDistribute 这些类都实现了接口：nc.ui.pubapp.uif2app.event.IAppEventHandler2). 添加配置文件<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE beans PUBLIC "-/SPRING/DTD BEAN/EN" "/dtd/

30、spring-beans.dtd"><beans><!- 替换 按钮配置 -><bean class="nc.ui.pubapp.plugin.action.ReplaceActionInfo"><property name="actionContainer" ref="xxxxx" /><property name="actionType" value="xxxx" /><property name="

31、target" ref="xxxx" /><property name="action" ref=" xxxx " /></bean><!文档管理 按钮 -><bean id="docManageAction" class="nc.ui.extend.pubapp.action.ExtDocManageAction"><property name="model" ref="manageAppMod

32、el" /></bean><!插入按钮配置 -><bean class="nc.ui.pubapp.plugin.action.InsertActionInfo"><property name="actionContainer" ref=" xxxx " /><property name="actionType" value=" xxxx " /><property name="target"

33、ref=" xxxx " /><property name="pos" value=" xxxx " /><property name="action" ref=" xxxx " /></bean> <bean id="chooseFileAction" class="nc.ui.extend.pubapp.action.ChooseFileAction"><property name="

34、;model" ref="ManageAppModel" /></bean><!- 拦截 按钮配置 -><bean class="nc.ui.pubapp.plugin.action.ActionInterceptorInfo"><property name="target" ref="xxxx" /><property name="interceptor" ref="xxxxx" /></be

35、an><bean id="interceptorForFile" class="nc.ui.extend.pubapp.action.SaveInterceptorForFile"><property name="billForm" ref="billFormEditor" /><property name="chooseAction" ref="chooseAction" /></bean><!- UI事件监听 -

36、><bean id="ExEventHandlerMediator" class="nc.ui.pubapp.uif2app.model.AppEventHandlerMediator"><property name="model" ref="manageAppModel" /><property name="handlerGroup"><list><!- 表头编辑后事件监听 -><bean class="nc.u

37、i.pubapp.uif2app.event.EventHandlerGroup"><property name="event"value="xxxxx" /><property name="handler"> <bean class="xxxxx" /></property></bean><!- 表体编辑前事件监听 -><bean class="nc.ui.pubapp.uif2app.event.EventH

38、andlerGroup"><property name="event"value="xxxxx" /><property name="handler"><bean class="xxxxx" /></property></bean><!- 表体编辑后事件监听 -><bean class="nc.ui.pubapp.uif2app.event.EventHandlerGroup"><prope

39、rty name="event"value="xxxxx" /><property name="handler"><bean class="xxxx" /></property></bean><!卡片合计事件监听 -><bean class="nc.ui.pubapp.uif2app.event.EventHandlerGroup"><property name="event"value=&q

40、uot;xxxxx" /><property name="handler"><bean class="xxxxx" /></property></bean></list></property></bean></beans>3).注册扩展配置文件，注册规则同插入按钮扩展。后台扩展功能描述：报价审核要求：A).点击审核按钮后需要时需要校验表头新扩展的【费用合计金额】与表头原有的【总金额合计】的大小，如果【费用合计金额】大于【总金额合计】，则表头费用说明必须填写。B).报价单审核通过后，如果存在报销人员怎在系统中给相关报销人“发送通知消息”。具体步骤：1增加类：1).增加类nc.bs.extend.b