云之家消息发送异常排查
金蝶云社区-jjbear
jjbear
1人赞赏了该文章 5,013次浏览 未经作者许可,禁止转载编辑于2018年01月24日 14:02:20
summary-icon摘要由AI智能服务提供

本文概述了如何测试和排查金蝶云与云之家消息发送中的常见问题,包括消息发送失败时的错误码及其处理方法(如5004密钥验证失败、5001公共号不存在等),如何查看错误日志并记录发送日志进行分析,以及针对云之家消息待办转已办失败的解决方案,涉及公有云和私有云环境的参数设置调整。

一:查看能否正常发送云之家消息
进入金蝶云 打开云之家消息测试,选择业务审批公共号,选择接收人 发送待办消息,查看能否发送成功
当消息发送请求执行失败时,HTTP状态码返回以下错误:
• 5000:一般参数错误,如:from/to不完整、必须传入参数xxx
• 5001:公共号不存在或未审核
• 5002:数据长度超限错误,如:传入数据长度超过了1M
• 5003:发送的公司或用户错误,如:发送到其他企业,无发送用户或错误的openid
• 5004:公共号密钥验证失败,from.pubtoken=sha(from.no,from.pub,公共号.pubkey,from.nonce,from.time)
• 5005:发往公共号消息过多,请等x分钟
• 500:远程服务器返回(500)内部服务器错误
最常见就是碰到返回5004错误,其次5001,5003.
1.1、提示5004错误的处理办法:
注意:绑定公共号注意,有些公共号必须绑定在系统预置上才有效。例如想要使用业务审批的公共号,就应该打开系统预置的“ID=SYS_WORKFLOW”上。在公共号编码、公共号密钥字段分别填入公共号的账号、密钥进行绑定。另外,系统预置的ID不要修改;公共号列表里保存更新的编码、密钥即可,不要再点击发布


1.2 提示5001错误的处理办法:检查云之家上对应公共号是否启用。
注意:云之家公共号的管理员停用再次启用是需要团队的管理员确认的,下图是云之家团队管理员的界面:

1.3 提示5003错误的处理办法:检查云之家用户映射,分为2处地方。
第一、检查云之家用户映射列表,从云之家导出用户对照。

1.4 提示500错误的处理办法:发送待办消息需要填写上链接地址 。


第二、检查cloud用户列表,cloud用户的移动电话字段配置正确手机号。

2、如果是云之家私有云部署,请注意检查参数设置中的云之家公共号连接地址,需要向云之家私有云部署人员询问。
administrator用户登录cloud,打开【所有功能-公共设置-参数设置-移动平台】,截图中是公有云云之家的消息接口默认地址。

二:查看错误日志
使用Administrator进入金蝶云数据中心,打开 “云之家消息异常日志列表” 点击过滤 去掉过滤条件“是否发送成功” 点击确定,查看列表中是否有发送异常信息
问题一:


解决方法:进入webiste站点下打开web.config 添加下面的信息


三:记录日志进行查看,进入站点wbsite\app_data\common.config 在appsetting目录下添加如下数据,打开记录云之家消息发送日志开发,记录日志进行分析


一段时间后,进入website\app_data\log\XXXX-XX-XX\Cloud.logXXXX-XX-XX 下面cloud.log下查看是否有如下日志,对日志进行分析


如果有错误,通过上述方法进行错误排查四:云之家消息待办转已办失败

进入参数设置-》基础管理-》移动设置
1.公有云环境
去掉勾选云之家私有云
查看待办接口地址是否为 https://kingdee.yunzhijia.com/op ... do/open/action.json
2.私有云环境
必须勾选上 云之家私有云
修改待办接口地址为 https://私有云地址/pubacc/changeTodoMsgStatus


解决方案: 进入参数设置-》基础管理-》移动平台 勾选上 启用云之家消息推送