UAP新增按钮的实现

一、扩展说明

1.按钮扩展的实现有两种方法

- 按钮继承：NCAction，MenuAction

- 拦截器实现：ActionInterceptor

此处是通过按钮继承实现的

2.UAP扩展开发新增按钮一般就三步

- 功能注册找到对应的节点查看全局配置xml文件

- 新建action类，扩展xml文件

- 注册配置文件到功能注册节点下

此处以销售订单维护为例，效果如下

3.节点查找路径

- 功能注册节点

：动态建模平台 -> 开发配置 -> 功能管理 -> 功能注册

- 销售订单维护节点

：供应链 -> 销售管理 -> 销售订单 -> 销售订单维护

二、按钮实现

第一步 - 功能节点查看

1.新建UAP项目

新建销售po模块的UAP项目，新建组件命名自定义；

选中项目右键启动中间件服务；

本次扩展添加的按钮是销售订单维护节点下的。

进入功能注册找到采购订单维护节点

看到'B'部分参数注册内层红框就是当前节点的xml配置文件，这个后面要用到；

第二步 - 按钮类及配置文件实现

1.创建action类及xml扩展文件

在新建的项目中client下新建action类及xml配置文件；

命名最好规范化可以参考标准产品相似功能节点的命名

结构如下：

action类就是按钮对应的java类，该类继承NCAction，覆盖doAction()方法，按钮的响应后的逻辑操作可在此方法中编写；

xml文件就是扩展按钮的配置文件。

2.文件代码

AddTestAction.java

package nc.ui.extend.pubapp.action;

import java.awt.event.ActionEvent;

import nc.ui.pub.beans.MessageDialog;
import nc.ui.uif2.NCAction;
import nc.ui.uif2.UIState;
import nc.ui.uif2.editor.BillForm;
import nc.ui.uif2.model.AbstractAppModel;

public class AddTestAction extends NCAction { 
	 
	public AddTestAction() {
		super.setBtnName("按钮");
		super.setCode("code");
	}
	 
	private static final long serialVersionUID = -4417976703049420324L; 
	private BillForm editor; 
	private AbstractAppModel model; 

 
	@Override public void doAction(ActionEvent e) throws Exception {
		MessageDialog.showHintDlg(editor," 提示 "," 测试自己新按钮按下 ");
	}
	public BillForm getEditor() {
		return this.editor; 
	}
	public AbstractAppModel getModel() {
		return this.model; 
	}
	public void setEditor(BillForm editor) {
		this.editor = editor; 
	}
	public void setModel(AbstractAppModel model) {
		this.model = model;
		model.addAppEventListener(this);
	}
	@Override
	protected boolean isActionEnable() {
		return this.model.getUiState() == UIState.NOT_EDIT;
	}
} 

<?xml version="1.0" encoding="GBK"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">
	<!--  插入按钮 -->
	<bean class="nc.ui.pubapp.plugin.action.InsertActionInfo"> 
		<property name="action" ref ="AddTestAction" />
		
		<!-- 这是插入按钮的目标位置配置   addMenuGroup即为查找的目标按钮  在其后插入测试按钮-->
		<property name="target" ref="addMenuGroup" />
		<property name="pos" value="before" />
		<property name="actionContainer" ref="actionsOfList" /><!-- 卡片，列表 -->
		<property name="actionType" value="notedit" /><!-- notedit 或 edit -->
	</bean>
	
	<bean class="nc.ui.pubapp.plugin.action.InsertActionInfo">
		<property name="action" ref ="AddTestAction" />
		<property name="target" ref="addMenuGroup" /><!-- 目标按钮 -->
		<property name="pos" value="before" /><!-- 位置 -->
		<property name="actionContainer" ref="actionsOfCard" /><!-- 卡片，列表 -->
		<property name="actionType" value="notedit" /><!-- notedit 或 edit -->
	</bean>
	
	<bean id="AddTestAction" class="nc.ui.extend.pubapp.action.AddTestAction">
		<property name="model" ref="manageAppModel" />
		<property name="editor" ref="billFormEditor" />
		
	</bean>
 </beans>

3.xml配置中的参数说明

<bean class="nc.ui.pubapp.plugin.action.InsertActionInfo"> 标识了扩展新增按钮
< bean class="nc.ui.pubapp.plugin.action.ReplaceActionInfo">替换按钮配置
<bean class=" nc.ui.uif2.uiextend.ActionExtInfo">删除按钮配置
<property name="target" ref="addMenuGroup" /> 
<property name="pos" value="before" />新增按钮AddTestAction在按钮addMenuGroup的前面
<bean id="AddTestAction" class="nc.ui.extend.pubapp.action.AddTestAction">
<property name="model" ref="manageAppModel" />
<property name="editor" ref="billFormEditor" />
</bean>
id就是作为一个按钮在xml配置文件中的标识，
class是按钮对应的的Java类
model是销售订单维护节点的xml配置文件中注册的AppModel
editor也是在该节点的xml配置文件中；

以上model，editor，目标按钮都是在xml配置中找；这个xml就是上面功能节点销售订单维护下的参数注册中的saleorder_config.xml配置文件；

找源码有个快捷键Ctrl+Shift+T，会弹出输入框，输入查找的文件名点击确认即可；

打开文件后，可以找到actions，选一个作为目标按钮即可；

关于model可以去查或者按照已有的action跟它配置的model，editor保持一致即可；

第三步 - 配置文件注册

1.注册配置文件到功能节点

就是把xml的全路径配置到销售订单维护节点下的参数注册中；

注意参数的命名有一定的规范，一般PluginBeanConfigFilePath加下划线后跟01,02这样；

到此完成新增按钮；到供应链的销售订单维护打开，此时按钮已被添加成功。

另：如果是二级按钮，或者按钮组；注意选择目标按钮后，将<property name="actionType" value="notedit" />中的notedit换成edit即可。