NCC业务和通知消息配置

最新推荐文章于 2023-03-22 00:15:45 发布
最新推荐文章于 2023-03-22 00:15:45 发布
阅读量3k 收藏 8
点赞数 2
分类专栏： NCC开发文档 文章标签： java 后端
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_42894264/article/details/110292685
版权

NCC业务和通知消息配置

·目录

业务和通知类消息

以任务分配为例

1、注册消息类型

  • 打开“动态建模平台->开发配置->消息管理->消息模板类型注册”，在业务消息的企业报表模块下新建一个消息模板分类
    在这里插入图片描述
  • 这里预置了两个业务函数字段，这里的字段是靠系统预置和元数据字段无法满足消息内容配置的时候，需要通过新增的这个自定义变量去实现。如果没有需求的话可不预置

2、注册消息模板

  • 新建好了之后在“动态建模平台->客户化配置->同一沟通平台->消息模板-全局”中就能看到上一步建好的分类，然后在对应分类下新建一个消息模板
    在这里插入图片描述
  • 可以看到右侧有三个页签，系统变量是平台预置好的，不需要关心，元数据和业务函数是我们预置的，具体实现参考第5步。

3、注册业务消息配置信息

  • 设置好模板之后，打开“动态建模平台->客户化配置->同一沟通平台->业务消息配置”节点
    在这里插入图片描述
  • 左树是不能新增的，这里需要我们自己去写SQL插入，我这里的插入SQL如下：
insert into pub_msgres_reg (CODE, CREATIONTIME, CREATOR, DR, FOLDERNAME, INNERCODE, METAID, MODIFIEDTIME, MODIFIER, MODULEID, MSGTEMPTYPE_CODE, NAME, PK_BILLTYPECODE, PK_MSGRES_REG, RESID, TS) values ('ufoe_taskassign', null, '~', 0, '', null, '766e7c90-2de7-415a-8d3f-4c690721aa2f', null, '~', '1820', 'TASKASSIGN', '任务分配', 'UFOE', '1001ZE10000000000001', '', '2020-11-14 17:25:24');
  • 其中“MSGTEMPTYPE_CODE”字段是第1步里面新建的那个分类的编码，我这里是“TASKASSIGN”
    在这里插入图片描述
  • 数据插入之后就可以在“业务消息配置”左边树里看到数据了
  • 然后配置好消息模板和消息接收人，然后就可以开始编写代码了
    在这里插入图片描述

4、代码实现

注：代码可参考nccloud.ufoepub.msg.utils.UfoeBuziMsgUtils类

/**
 * 发送NCC消息-任务分配
 * 
 * @param taskAssignVO
 * @param sender        消息发送人
 * @param pk_group      集团主键
 * @return
 * @throws BusinessException
 */
public static void sendNCCMessage(TaskAssignVO taskAssignVO, String sender, String pk_group) throws BusinessException {
	UfoeBuziMsgDTO dto = new UfoeBuziMsgDTO();
	// 构造消息体
	dto.setSender(sender);
	// 消息发送时间取当前时间
	dto.setSendtime(new UFDateTime());
	// 发送通知消息
	dto.setMsgsourcetype(UfoeMsgConsts.MSG_TYPE_NOTICE);
	dto.setPk_group(pk_group);
	dto.setPk_org(taskAssignVO.getPk_receiveorg());
	//设置跳转单据传递的参数
	dto.setParam("pk_org=" + taskAssignVO.getPk_receiveorg());
	// 设置应用编码，用于跳转
	dto.setAppcode(UfoeMsgConsts.APPCODE_RECEIVETASK);
	// 设置消息类型
	dto.setMsgType(UfoeMsgConsts.MSG_TYPE_NOTICE);
	//设置单据主键（用于消息状态设置时定位该消息）
	dto.setBillid(taskAssignVO.getPk_taskassign());

	// 构造消息配置信息
	dto.setMsgrescode(UfoeMsgConsts.MSG_CONFIG_TASKASSIGN);
	// 设置接收的组织
	dto.setPkorgs(new String[] { taskAssignVO.getPk_receiveorg() });
	// 给元数据字段赋值
	dto.setBillVO(taskAssignVO);
	// 给业务函数字段赋值
	dto.setCalculater(new TaskAssignBusiVarCalculater(taskAssignVO));
	UfoeBuziMsgUtils.sendBuziMsgReturnReceiver(dto);
}

其中有一个params字段，可以设置用户自定义的参数，用于页面跳转时的传参。以“key=value”的形式传递，多个参数之间用“&”隔开。不过要注意的是，如果发送的是业务消息，需要在前面加一个“?”

5、业务函数字段的设置

  • 业务函数是消息配置时，系统预置字段和元数据字段无法满足消息模板配置的需求时，需要预置额外的字段去实现
  • 业务函数字段需要实现nc.message.templet.bs.IMsgVarCalculater接口或者继承平台的nc.message.templet.bs.AbstractBusiVarCalculater类，里面对业务函数字段值进行解析并赋值，详情请参考： nccloud.ufoepub.msg.calculater.TaskAssignBusiVarCalculater
/**
 * 翻译任务分配中的业务函数字段
 * @author youjw11
 *
 */
public class TaskAssignBusiVarCalculater extends AbstractBusiVarCalculater {

	//个性化规则
	private static final String PERSONALRULE = "personalRule";
	//任务所属节点类型
	private static final String TASKNODETYPE = "taskNodeType";
	
	Map<String, String> varMap = new HashMap<String, String>();

	public TaskAssignBusiVarCalculater(TaskAssignVO taskAssignVO) {
		
		StringBuffer personalRule = new StringBuffer();
		
		if (taskAssignVO.getFlag_reassign().booleanValue() == true) {
			personalRule.append(nc.vo.ml.NCLangRes4VoTransl.getNCLangRes().getStrByID("1820001_0","01820001-1059")/*@res "接收组织可再分配、"*/);
		}
		else {
			personalRule.append(nc.vo.ml.NCLangRes4VoTransl.getNCLangRes().getStrByID("1820001_0","01820001-1060")/*@res "接收组织不可再分配、"*/);
		}
		if (taskAssignVO.getFlag_privfml().booleanValue() == true) {
			personalRule.append(nc.vo.ml.NCLangRes4VoTransl.getNCLangRes().getStrByID("1820001_0","01820001-1061")/*@res "可进行个性化公式设置、"*/);
		}
		else {
			personalRule.append(nc.vo.ml.NCLangRes4VoTransl.getNCLangRes().getStrByID("1820001_0","01820001-1062")/*@res "不可进行个性化公式设置、"*/);
		}
		if (taskAssignVO.getFlag_privprint().booleanValue() == true) {
			personalRule.append(nc.vo.ml.NCLangRes4VoTransl.getNCLangRes().getStrByID("1820001_0","01820001-1063")/*@res "可进行个性化打印设置"*/);
		}
		else {
			personalRule.append(nc.vo.ml.NCLangRes4VoTransl.getNCLangRes().getStrByID("1820001_0","01820001-1064")/*@res "不可进行个性化打印设置"*/);
		}
		
		String sendOrgName = OrgUtil.getOrgName(taskAssignVO.getPk_assignorg());

		//设置个性化规则的值
		varMap.put(PERSONALRULE, personalRule.toString());
		//设置任务所属节点类型
		varMap.put(TASKNODETYPE, sendOrgName);
	}

	@Override
	public String calculateValue(String express) {
		if (varMap.containsKey(express)) {
			if (StringUtils.isEmpty(express)) {
				return "";
			}else {
				return varMap.get(express);
			}
		}
		return "";
	}

	public Map<String, String> getVarMap() {
		return varMap;
	}

	public void setVarMap(Map<String, String> varMap) {
		this.varMap = varMap;
	}
}

6、消息设置已读/未读和删除

  • 业务类消息又称代办消息，需要代码处理消息的已读未读，如果业务执行完毕，则需要设置消息为已读，如果业务回退，需要主动将消息删除

  • 通知消息只需要关注发送和删除，如果业务操作进行了逆操作，需要将发出去的消息删除

  • 下面介绍两个改变消息状态的方法

    方法1：用平台封装好的接口
    代码处理
    • 消息的状态改变可以调用：

    nccloud.message.itf.INCCMessageUtil.setMsgRead(String msgType,String pk_message);

    • 消息的删除的话则调用：

    nccloud.message.itf.INCCMessageUtil.setMsgDeleted(String msgType,String pk_message);

    定位消息
    • 正常情况下我们需要先获取消息的主键，这样才能定位到对应的消息进行删除，可调用 nccloud.message.itf.INCCMessageUtil.getNCCMessage(NCCMessageVO msgVO, String msgType) 方法去先将需要改变状态的消息找出来
    方法2：直接调用底层接口
    代码处理
    • 消息的状态改变可以调用：

    nccloud.message.itf.IMessageManageService.setRead(Map<String, Object> params, boolean isRead, String datasource)

    • 消息的删除的话则调用：

    nccloud.message.itf.IMessageManageService.setDelete(Map<String, Object> params, boolean isDelete, String datasource)

    参数解释
    • param 是一个map类型，用于拼接whereSql，用来过滤出需要删除的消息，param参数中可用的key，调用的时候可以根据需要自行组装
    key含义可取值
    isread是否已读“R”
    userId和userIds接收人主键和数组主键或主键数组
    message_type消息类型“todo”、“notice”、“prealert”、“approve”
    pk_message和pk_messages消息主键和消息主键数组主键或主键数组
    pk_message_usersm_msg_user表主键主键
    pk_detail和pk_details单据明细主键和数组主键或主键数组
    billid和billids单据主键和数组主键或主键数组
    • isRead 和 isDelete 是boolean类型的，标志该消息设置成已读还是未读，设置删除还是恢复删除
    • datasource 设为null，跟代码发现该字段没用上
    • 详情请参考实现类： nccloud.message.bs.MessageManageServiceImpl

7、业务消息发送与页面跳转原理

消息发送原理
  • 消息发送无非就是构造 nccloud.message.vo.NCCMessage ，这个类里面含有消息的所有数据，包括消息内容、发送方信息、接收方信息等所有信息
  • 但是业务消息内容和接收方都是通过读取“业务消息配置”节点来实现的，这个时候就需要用到 nc.buzimsg.vo.BuziMsgSendingContext 。通过设置它的信息来匹配配置信息，从而取出消息模板配置的内容。元数据和业务函数的值就是通过这个类里面的billVO和calculater两个字段来赋值的
    在这里插入图片描述
  • 通过调用平台消息发送接口 nccloud.buzimsg.itf.IBuziMsgSending 来发送消息，我们只需要设置好上面两个类相应的值，就能匹配到相应的配置信息，从而进行消息的发送。
消息跳转原理
  • 消息跳转的话在 nccloud.message.vo.NCCMessage 的成员变量 nccloud.message.vo.NCCMessageVO 类中可设置消息体的跳转信息
通知消息的跳转

  • 我们先来看看前端代码
    在这里插入图片描述

  • 当消息体里面传了应用编码，但是没传单据类型的时候，可直接跳转到对应的小应用，并将一些配置信息拼接进去。
    在这里插入图片描述

  • 也可以在detail字段中拼接“PURL”，如果这个里面指定了跳转信息，则直接跳过去，否则就按设置的单据类型跳转。

  • 现在我们来看后端代码
    在这里插入图片描述

  • 结合前后端代码，总结一下detail字段的格式为：

    单据主键@单据类型编码@单据号@appcode@PURL=appcode=应用编码&pagecode=页面编码

    • 数据不一定要全，但是格式得按这个来
业务消息的跳转
  • 前端代码：
    在这里插入图片描述
  • 先会判断传入的params中是否有“|”字符，有就代表需要选择打开的交易类型，会弹一个框，选择需要跳转的交易类型
    如果没有该字符则直接按传入的信息跳转
    在这里插入图片描述
    前端代码中的this.state.message对应的就是后端代码中的NCCMessage里的NCCMessageVO里面的信息，具体开发过程需要传递字段的话可参考前端代码拼接的字段去设置想要的值
liyou0101
关注
专栏目录
NCC增加按钮前段样例（弹窗）
07-05
ncc前段代码样例纯属搬运
【案例6】NC安装部署常见问题
热门推荐
Z.Virgil的博客
03-11 2万+
目录 问题1：Too many open files 问题现象 解决办法 问题2：图形化报错 问题现象 解决办法 问题3：nmc启动报环境不符合 问题现象 解决办法 问题4：64位系统安装了32位的软件 问题现象 解决办法 问题5：参数配置 问题6：部署EJB，SOAPConnectorClient异常 问题现象 解决办法 问题7：重置拒绝会话证书存储 问...
nc发送消息通知
∑'αγαπώ的博客
09-14 716
nc发送消息通知
NCC往消息中心发送消息
qq_28909907的博客
04-20 887
NCC往消息中心发送消息 1、使用工具类：nccloud.message.util.MessageCenter nccloud.message.util.MessageCenter.sendMessage(NCCMessage[]) 2、组装参数 NCCMessage msg = new NCCMessage(); ​ //NCCMessageVO消息实体VO，下有不同类型消息实体VO，（都在同一个包下）此处用的是通知消息NCCNoticeMessageVO NCCNoticeMessageVO
02 NCC定时任务开发
GEIGEGOGOGO的博客
10-27 1768
NCC定时任务开发
NCC自定义参照开发
juner_aspasia的博客
03-22 1100
2. 后台类 nc.ui.arap.pub.ref.CustCrossRefModel 3. 前台js home\hotwebs\nccloud\resources\arap\refer\pub\CustCrossGridRef\index.js 4. 添加鉴权文件及权限控制文件 home\hotwebs\nccloud\WEB-INF\extend\yyconfig\modules\wcy\authorize\wcy_authorize.xml home\hotwebs\nccloud\WEB-INF
ncc外部接口开发
qq_25310483的博客
03-08 1283
ncc2005接口开发
NC/NCC api生成物料档案，编码必填问题
Cc_Rain
08-13 1654
通过NC自带的openapi生成物料档案，接口验证编码必填，客户需求 要按照系统的编码规则自动生成。 解决方法： 传入参数 物料编码字段 赋值：material_temp_code
NCC环境搭建与配置.pdf
01-12
《NCC环境搭建与配置》是一份详细的指南，主要针对NCC（可能是某种特定的软件或平台）的开发和测试环境的建立与配置。这份文档适用于具有中级及以上技术水平的实施/开发顾问，确保他们能够成功地搭建并配置NCC环境。...
NC，NCC业务插件注册资料
最新发布
10-31
NC、NCC业务插件注册资料 NC、NCC业务插件注册资料是指在软件开发中使用的插件注册机制，它允许开发者创建自己的业务插件并将其注册到系统中，以便在业务流程中使用。下面是该资料的详细知识点： 插件注册 插件...
NCC开发从前端到后端，单点登录，OpenAPI，业务插件注册，及前后端代码分析
11-15
包括：单点登录，OpenAPI，业务插件注册，及前后端代码分析， 按钮功能注册，及分析代码调整逻辑，单据的逻辑，和导入导出功能等功能开发介绍
NC预警及后台任务使用说明
04-07
NC预警 后台任务 使用说明
NC65消息通知.rar
03-25
NC65消息通知功能，发送业务消息，审批消息，消息通知
NCC-OpenAPI示例文档.zip
04-14
开发OpenAPI流程及说明 1.UAP与Restlet框架的集成 UAP在Restlet框架之上，选择了官方JAX-RS扩展，并且在扩展的基础上与NC进行了集成。 主要jar包 modules/uapws/pubuapfw_restframeworkLevel-1.jar UAP平台的扩展主要集中在uap.ws.*中,同时还少量修改了官方的jax-rs代码。 资源部署（类似与UPM的注册，注册为.rest文件） 资源访问计数及计时 Restful对应的Servlet uap.ws.rest.servlet.UAPRSServerServlet：处理token、usercode、datasource等环境变量。 UAPRestJaxRsApplication:application级别的参数，只有第一次调用servlet时会执初始化 将上述配置的信息移入hotwebs/nccloud工程项目下 相应的配置信息如下：
NCC环境配置(最详细).docx
09-07
NCC环境配置(最详细).docx
NCC开发资料（需要可下载）
04-12
开发者可以利用NCC提供的服务组件快速构建业务逻辑，例如，通过NCC的云数据库服务来存储和操作数据，使用工作流引擎实现业务流程自动化。 4. **云服务集成** NCC平台允许开发者集成多种云服务，如存储服务、消息...
NC65系统发送消息通知，并且附带附件
tsw_921010的博客
02-21 1382
代码如下 File file = new File("C:\\Users\\m\\Desktop\\采购需求20220315日上线.txt");//附件文件地址 FileAttachment fileAttachment = new FileAttachment(file); AttachmentSetting attachmentSetting = null; try { AttachmentVO vo...
NC65费用管理报销单提交按钮新增业务插件开发步骤
东风流浪
11-21 2142
1、业务插件注册，找到并选中财务-费用管理-借款报销单 点击新增事件类型按钮，新增事件类型 ,事件类型编码：ERM1016 ，事件类型名称：提交后 2、新增业务插件 插件名称：提交后，插件全类名：实现了nc.bs.businessevent.IBusinessListener接口的插件类名称 3、修改系统产品代码 找到借款报销类单据表头业务类nc.bs.arap.bx.B...
NC后台任务代码及相关配置
kon_mio的博客
12-28 1641
一、后台代码 后台任务的接口需要继承IBackgroundWorkPlugin类,重写executeTask方法,前台启动后台任务就会自动调用这个方法 @Override public PreAlertObject executeTask(BgWorkingContext bgwc) throws BusinessException { // 获取前台配置的参数 String name = bgwc.getKeyMap().get("name"); // 一个参数有多个值可以再对字符串
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值