第三方系统向泛微OA系统推送消息
以下操作案例中关于第三方系统向泛微OA系统的移动端和电脑端版本推送消息说明:
• 移动端使用的是泛微系统登录账号(工号)来最终实现消息的推送
• 电脑端使用的是泛微系统用户表中的id字段来最终实现消息的推送
一、移动端消息推送
1、超级管理员账号,登录移动端门户管理平台
2、消息中心--消息类型创建
-
配置完成后,会自动生成消息标识Id;然后根据外部系统推送示例,实现移动端消息推送。
-
实现移动端消息推送,必须要消息标识Id和e-mobile消息推送密钥
消息标识Id:新建消息类型成功后,会自动生成消息标识Id
消息推送密钥:“服务器管理”—“系统状态”—服务器属性:e-mobile消息推送密钥
-
请勿必保证license值是有效可用的,否则会导致调用接口失败
-
以上都配置完成后,修改调用程序中对应的相关参数,可能首次调用接口无法接收到消息,请先多次调用后。
二、电脑端消息推送
1、超级管理员账号,登录协同办公平台
2、后端应用中心
页面右上角更多,点击 后端应用中心
3、配置允许调用工作流程WebService服务权限的IP地址
- 页面地址为:/workflow/UserList.jsp
4、配置允许调用人力资源WebService服务权限的IP地址
-
需要在OA的/Ecology/WEB-INF/prop/HrmWebserviceIP.properties配置文件中配置调用接口客户端的IP,调用接口时传入的参数ip包涵在此配置文件才能调用人力资源WebService服务的所有接口。
5、流程引擎--表单管理--表单管理,创建自定义表单
- 点击“新建”按纽,弹出新建表单模态窗,填写“表单名称”,最后点击“保存”按纽。
- “批量删除”按纽旁边文本框中输入填写的表单名称,点击搜索,查询添加的表单,然后编辑该表单
- 维护表单相关字段信息
6、流程引擎—路径管理—路径设置,创建流程
- 选择流程放在哪个路径目录下,然后点击目录文件夹,再点击“添加”按纽,填写路径流程信息
- 基础设置--基本信息,只需要填写“路径名称”、“对应表单”2个字段,其它可以不添加或修改
- 流转设置--节点信息,--编辑,添加流程节点,只需要添加“创建“、“归档“ 2 个节点
- 给节点,添加操作者,如下图所示
- 给节点,设置表单内容,如下图所示
- 流转设置--出口信息,添加出口信息即流程结束节点,如下图所示
7、查看流程Id(非常重要)
- 调用创建流程接口时,需要使用流程Id(workflowId)
- 调用创建流程接口时,需要创建人Id(creatorId),该值对应的是泛微OA系统用户表中的用户Id
8、门户--个人办公,配置消息显示
附.net代码
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
/// <summary> /// 调用泛微OA系统接口 /// </summary> public class EcologyManager { ILog log = log4net.LogManager.GetLogger("EcologyManager"); static String basePushUrl = ConfigurationManager.AppSettings["EcologyMobilePushUrl"]; static String key = ConfigurationManager.AppSettings["EcologyMobilePushKey"];//emobile后台的推送秘钥 static String messageUrl = ConfigurationManager.AppSettings["EcologyMobileMessageUrl"]; static String messageTypeId = ConfigurationManager.AppSettings["EcologyMobileMessageTypeId"]; static String workflowServiceUrl = ConfigurationManager.AppSettings["EcologyWorkflowServiceUrl"]; static String hrmServiceUrl = ConfigurationManager.AppSettings["EcologyHrmServiceUrl"]; static String workflowId = ConfigurationManager.AppSettings["EcologyWorkflowId"]; static String workflowLevel = ConfigurationManager.AppSettings["EcologyWorkflowLevel"]; static String hrmIpAddress = ConfigurationManager.AppSettings["EcologyHrmIpAddress"]; /// <summary> /// 向泛微移动端推送消息 /// </summary> /// <param name="message">消息</param> /// <param name="receiverId">接收者的loginid,多用户使用英文半角逗号分开</param> /// <returns></returns> public void PushMobileMessage(string message, string receiverId) { try { //url = url ?? messageUrl + "?account=" + receiverId; string badge = "1"; //消息数量+1 HttpClient httpClient = new HttpClient(); httpClient.DefaultRequestHeaders.Add("user-agent", "Mozilla/5.0 (Windows NT 6.1; rv:8.0.1) Gecko/20100101 Firefox/8.0.1"); Dictionary<string, string> para = new Dictionary<string, string>(); para.Add("messagetypeid", messageTypeId);//在mobile后台注册的消息类型id para.Add("module", "-2"); //标示属于自定义消息 para.Add("url", messageUrl); string paraJson = Sheng.Kernal.JsonHelper.Serializer(para); StringBuilder sendMsg = new StringBuilder(); if (message.Length > 100) message = message.Substring(0, 100) + "..."; sendMsg.Append(receiverId); sendMsg.Append(message); sendMsg.Append(badge); sendMsg.Append(paraJson); sendMsg.Append(key); string hash = Md5Hex(sendMsg.ToString()); List<KeyValuePair<String, String>> paramList = new List<KeyValuePair<String, String>>(); paramList.Add(new KeyValuePair<string, string>("userid", receiverId)); paramList.Add(new KeyValuePair<string, string>("msg", message)); paramList.Add(new KeyValuePair<string, string>("badge", badge)); paramList.Add(new KeyValuePair<string, string>("para", paraJson)); paramList.Add(new KeyValuePair<string, string>("hash", hash)); HttpResponseMessage response = httpClient.PostAsync(new Uri(basePushUrl), new FormUrlEncodedContent(paramList)).Result; log.Info($"Ecology移动端消息推送:{Environment.NewLine}用户工号:{receiverId },消息内容:{message };{Environment.NewLine}接口响应结果:{Sheng.Kernal.JsonHelper.Serializer(response)}"); } catch (Exception ex) { log.Error($"Ecology移动端消息推送:{Environment.NewLine}用户工号:{receiverId },消息内容:{message };{Environment.NewLine}接口异常,异常信息:{ex.Message},异常堆栈信息:{ex.StackTrace}"); } } /// <summary> /// 向泛微电脑端推送消息 /// </summary> /// <param name="title">消息标题</param> /// <param name="ecoloryUserId">消息接收人</param> public void PushPCMessage(string title, int ecoloryUserId) { try { //主字段 WorkflowRequestTableField[] wrti = new WorkflowRequestTableField[1]; //字段信息 wrti[0] = new WorkflowRequestTableField(); WorkflowRequestTableRecord[] wrtri = new WorkflowRequestTableRecord[1];//主字段只有一行数据 wrtri[0] = new WorkflowRequestTableRecord(); wrtri[0].workflowRequestTableFields = wrti; WorkflowMainTableInfo wmi = new WorkflowMainTableInfo(); wmi.requestRecords = wrtri; WorkflowBaseInfo wbi = new WorkflowBaseInfo(); wbi.workflowId = workflowId; WorkflowRequestInfo wri = new WorkflowRequestInfo();//流程基本信息 wri.creatorId = ecoloryUserId.ToString();//接收人 wri.requestLevel = workflowLevel; //0 正常,1重要,2紧急 wri.requestName = title;//流程标题 wri.workflowMainTableInfo = wmi;//添加主字段数据 wri.workflowBaseInfo = wbi; //执行创建流程接口 WorkflowService workflowService = new WorkflowService(); workflowService.Url = workflowServiceUrl; String requestid = workflowService.doCreateWorkflowRequest(wri, ecoloryUserId);//接收人 log.Info($"Ecology电脑端消息推送;{Environment.NewLine}泛微USERID:{ecoloryUserId },消息内容:{title }{Environment.NewLine}接口响应结果:{requestid}"); } catch (Exception ex) { log.Error($"Ecology电脑端消息推送;{Environment.NewLine}泛微USERID:{ecoloryUserId },消息内容:{title }{Environment.NewLine}接口异常,异常信息:{ex.Message},异常堆栈信息:{ex.StackTrace}"); } } /// <summary> /// 根据工号获取泛微用户信息 /// </summary> /// <param name="workCode">工号</param> /// <returns></returns> public EcologyUser GetEcologyUserByWorkCode(string workCode) { EcologyUser ecologyUser = new EcologyUser(); try { //调用泛微OA系统人力资源接口 //需要在泛微OA系统的安装目录 /Ecology/WEB-INF/prop/HrmWebserviceIP.properties 配置文件中配置调用接口客户端的IP(=hrmIpAddress),否则无法调用人力资源相关接口 HrmService hrmService = new HrmService(); hrmService.Url = hrmServiceUrl; //获取泛微所有用户 string resultXml = hrmService.getHrmUserInfoXML(hrmIpAddress, "", "", "", "", ""); log.Info("调用泛微OA人力资源getHrmUserInfoXML接口,接口返回数据:" + resultXml); if (string.IsNullOrWhiteSpace(resultXml) || resultXml == "<UserBean-array/>") { return ecologyUser; } //xml转成List List<EcologyUser> userBeanList = Sheng.Kernal.JsonHelper.XmlToList<EcologyUser>(resultXml, "UserBean-array"); if (userBeanList.Any() == false) { return ecologyUser; } ecologyUser = userBeanList.FirstOrDefault(x => x.WorkCode == workCode); } catch (Exception ex) { log.Error("调用泛微OA人力资源getHrmUserInfoXML接口异常,异常信息:" + ex.Message + Environment.NewLine + ex.StackTrace); } return ecologyUser; } private static string Md5Hex(string data) { MD5CryptoServiceProvider md5 = new MD5CryptoServiceProvider(); byte[] dataHash = md5.ComputeHash(Encoding.UTF8.GetBytes(data)); StringBuilder sb = new StringBuilder(); foreach (byte b in dataHash) { sb.Append(b.ToString("x2").ToLower()); } return sb.ToString(); } }