本文档描述了如何在使用金蝶云与云之家进行消息发送时,检查消息是否能正常发送、处理可能出现的错误码(如5000至5005),并给出了针对不同错误码的处理方法。同时,还介绍了如何查看错误日志、记录并分析日志,以及解决云之家消息待办转已办失败的问题,包括公有云和私有云环境下的接口地址配置和修改。
一:查看能否正常发送云之家消息
进入金蝶云 打开云之家消息测试,选择业务审批公共号,选择接收人 发送待办消息,查看能否发送成功
当消息发送请求执行失败时,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
解决方案: 进入参数设置-》基础管理-》移动平台 勾选上 启用云之家消息推送
推荐阅读