自定义右下角弹窗多场景运用实例
场景需求:
金蝶云星空系统右下角弹窗有2个场景举例:
1、用户普通通知消息弹窗:在某个功能操作后,不即时弹窗,指定用户将通知消息数据储存起来,设置消息失效时间,待用户登录后,以及心跳事件时读取数据并弹窗
2、给自己即时弹窗(多样化):在某个功能操作后,根据需求自定义组合内容,给自己弹窗
以下根据给出的插件案例依次介绍
一、用户普通通知消息弹窗
描述:该场景当前方案是借用系统自带的广播消息功能,将数据插入广播消息表(T_BAS_BROADCASTMSG)中,在系统用户登录后,以及正常心跳事件,都会根据消息的失效时间获取并且弹出
样式:(c#)
public override void ButtonClick(ButtonClickEventArgs e) { base.ButtonClick(e); if (e.Key.EqualsIgnoreCase("FSendMsgTest")) { var meta = FormMetaDataCache.GetCachedFormMetaData(this.View.Context, "BAS_BROADCASTMSG");//广播消息 var dataObj = new DynamicObject(meta.BusinessInfo.GetDynamicObjectType()); dataObj["FCREATEDATE"] = DateTime.Now; dataObj["FTITLE"] = new LocaleValue("消息标题"); dataObj["FCONTENT"] =new LocaleValue("消息内容测试"); dataObj["FCreatorId_Id"] = this.View.Context.UserId; dataObj["FSendType"] = 1; dataObj["FIsSendBroadcast"] = true; dataObj["FFailureTime"] = DateTime.Now.AddHours(0.5);//预计半小时后失效,预计该消息什么时候失效 //如果是指定用户,则需要设置指定用户数据,如全部所有用户,则不需要下面逻辑 //====== long[] senduserid = new long[] { 100063 }; DynamicObjectCollection revier = dataObj["FReceiver"] as DynamicObjectCollection; if (revier != null) { foreach (long userid in senduserid) { DynamicObject robj = new DynamicObject(revier.DynamicCollectionItemPropertyType); robj["FReceiver_Id"] = userid; revier.Add(robj); } } //====== BusinessDataServiceHelper.Save(this.View.Context, dataObj); } }
说明:上面案例中:
1、FFailureTime字段是指消息的失效时间,该值越短越好,目前系统该广播消息,是没有已读,未读设计,也没有弹出次数的记录设计,这个是通知消息,根据这个失效时间大于当前系统时间,满足条件者始终都会弹出来,也即一个消息会不停的重复弹出,直到失效过了失效时间为止
2、据上第1点的描述,如果想弹出一次,后面不弹,或者有已读未读,或者用户想看到已读的消息等等,就不能用此方案,建议可以研究借用工作流信息中心功能的普通消息功能,但是这种方式的消息不能右下角弹出
三、给自己即时弹窗(多样化)
描述:该弹窗是程序中,调用封装的弹窗接口,将信息实时弹窗出来,弹出的支持不同场景和运用
1、普通通知消息弹窗,样例(c#)
public override void ButtonClick(ButtonClickEventArgs e) { base.ButtonClick(e); if (e.Key.EqualsIgnoreCase("FShowNormlMsg")) { string msg = string.Format("客户编号{0}的订单{1}审核流程已经提交成功,请及时联系{2},催促审核!", "00001", "DD000001", "0755-12345678"); Kingdee.BOS.DataEntity.LowerRightPopMsgEntity popmsg = new DataEntity.LowerRightPopMsgEntity(); popmsg.Title = string.Format("订单{0}发送提醒", "DD000001"); popmsg.Content = msg; popmsg.LinkContent = ""; popmsg.StackBroadMillss = 2000; popmsg.ID = this.View.UserParameterKey + "_ShowNormlMsg"; ViewCommonAction.LowerRightPopMsssage(this.View, new List<DataEntity.LowerRightPopMsgEntity>() { popmsg }); } }
2、带链接交互弹窗,样例(c#)
public override void ButtonClick(ButtonClickEventArgs e) { base.ButtonClick(e); if (e.Key.EqualsIgnoreCase("FShowCallLinkMsg")) { LowerRightPopMsgEntity popmsg = new DataEntity.LowerRightPopMsgEntity(); popmsg.ID = this.View.UserParameterKey + "_ShowCallLinkMsg"; popmsg.Title = "带链接弹窗消息"; popmsg.Content = string.Format("带链接弹窗消息,您的订单{0}已经发送成功,可点击查看详情,查看更多该订单详细内容", "DD000001"); popmsg.LinkContent = "查看详情"; popmsg.FireLinkEvent = true; popmsg.StackBroadMillss = 2000; popmsg.TargetPageId = this.View.PageId; JSONObject dataobj = new JSONObject(); dataobj["billno"] = "DD000001"; popmsg.LinkTag = dataobj.ToJSONString(); ViewCommonAction.LowerRightPopMsssage(this.View, new List<DataEntity.LowerRightPopMsgEntity>() { popmsg }); } } public override void CustomEvents(CustomEventsArgs e) { base.CustomEvents(e); //点击带链接的弹窗的查看详情链接事件 if (e.Key.EqualsIgnoreCase(this.View.UserParameterKey + "_ShowCallLinkMsg") && e.EventName.EqualsIgnoreCase("ButtonClick")) { JSONObject objdta = JSONObject.Parse(e.EventArgs); this.View.ShowMessage("点击查看详情弹出的订单号是" + objdta.GetValue<string>("billno")); } }
说明:
LowerRightPopMsgEntity属性功能,可F12查看具体解释和说明
三、系统弹窗弹出规则
1、系统弹窗有即时弹窗,也即根据服务端的逻辑写法,即时弹出
2、系统弹窗堆栈式弹窗,如上给的实例都是自动堆栈弹窗,增加体验效果,例如:系统同一时间接受了4个弹窗,为了更加体验,弹完第一个,等第一个弹窗关闭,接着弹第二个。。。。依次类推,堆栈式的弹窗,后面再来多个弹窗都是堆栈排队
3、所有的弹窗默认自动关闭(打开弹窗默认20s自动关闭),属性可设置popmsg.AutoCloseInterval = 0也即永久不会自动关闭,必须需要用户点击右上角的×,进行关闭弹窗
4、根据不同的写法,两种方式弹出可同时支持
自定义右下角弹窗多场景运用实例
本文2024-09-23 03:47:05发表“云星空知识”栏目。
本文链接:https://wenku.my7c.com/article/kingdee-k3cloud-161081.html