1. 简介
云助手-泛微应用的集成
1.1. 功能说明
云助手泛微应用的集成，只需要简单的配置对应参数，即可完成与泛微应用的对接。 集成之前请先与泛微方确认是否可以直接使用此方案，如果是泛微Ecology KB补丁包版本：KB8100170400以上，咨询泛微那边荣盛项目团队并移植该方案，可直接集成上线
1.2. 方案列表
功能导航：设置中心》集成到第三方OA》集成方案选择
页面向下滚动，选择“泛微一键集成
2. 具体方案说明
2.1. 主界面展示
2.2. 功能说明
泛微集成方案支持发送消息和用户认证。 通过是否发送消息开关来控制是否发送消息,通过配置“泛微密钥”（即泛微提供的secrect）实现用户身份认证。
注意：此处如果PC端已经和泛微OA做过消息推送，则无法再使用移动的消息推送，否则推送的消息会重复，这种情况应该联系项目二开团队修改PC端的消息服务，让该服务推送PC消息的同时也可以推送移动的消息。此处的移动消息推送，特别针对，客户只用泛微移动端的场景，或者移动端用泛微，PC端用其他产品的场景。
集成参数说明
| 参数 | 说明 |
|---|---|
| 泛微密钥 | 泛微与云助手进行集成身份认证时所需的密钥，如 YFehjP。该密钥由泛微生成，填写到明源云助手配置中。从泛微app打开云助手页面时，云助手会根据该密钥+认证算法，校验用户身份的有效性。 |
| 泛微syscode | 泛微app用来识别第三方（比如云助手）消息的标识。云助手推送待办/已办消息到泛微app时，需要携带该标识。默认为 mysoft，如泛微系统先行定义了该标识，可以泛微定义为准，修改集成参数。 |
| 泛微消息来源标识 | 云助手推送消息时泛微的消息来源标识，具体参考泛微后台设置，或以泛微实施人员提供为准(适用消息类型应用，如管理简讯) |
| 泛微消息接口地址 | 云助手推送消息时调用的泛微应用接口。格式通常为 http://{泛微应用地址:端口}/services/ServiceMessageCustom?wsdl，具体参考泛微后台设置，或以泛微实施人员提供为准(适用消息类型应用，如管理简讯) |
| 泛微待办接口地址 | 云助手推送待办时调用的泛微应用接口。格式通常为 http://{泛微应用地址:端口}/rest/ofs/receiveTodoRequestByJson，具体参考泛微后台设置，或以泛微实施人员提供为准(适用待办类型应用，如移动审批) |
| 泛微已办接口地址 | 云助手推送已办时调用的泛微应用接口。格式通常为 http://{泛微应用地址:端口}/rest/ofs/processDoneRequestByJson，具体参考泛微后台设置，或以泛微实施人员提供为准(适用待办类型应用，如移动审批) |
| 管理简讯，移动审批是否推送消息 | 应用消息开关，控制应用是否需要发送消息 |
| 泛微是否推送消息 | 集成消息的总开关，控制整个集成是否需要发送消息，只有总开关开启才会检测应用的消息开关 |
注意：若要开启消息推送，需要先将“消息设置-是否推泛微送消息”一项设置为 “开启”。
3. 常见问题
3.1. 您的认证信息失效，请重新登录客户端!
出错现象
出错原因：集成身份认证失败
解决方案
1、泛微密钥设置错误。
2、泛微请求url地址中缺少如下参数：（loginid，stamp，token）
3.2. 登录的用户账号在明源ERP中不存在
出错现象
出错原因：第三方登录用户不在erp中，或者在erp中，但该用户编码被禁用。
解决方案
1、换一个明源中有的用户编码登录;
2、在明源中增加一个这样的用户编码.
3、查看是否用户编码被禁用，如禁用则解除禁用或者换一个非禁用的用户编码。
3.3. 泛微免登开发
在泛微中点击明源流程的时候，需要给我们原始的url后追加三个参数, 如：原始消息的链接为https://www.fdccloud.com/xxx/xxx?a=1,在泛微app点击我们的消息时候最终的跳转链接为https://www.fdccloud.com/xxx/xxx?a=1&loginid=zhangsan&stamp=1570866496&token=xxxxx
- loginid：账号code 如：zhangsan
- stamp: 当前时间戳 如：1570866496 精确到秒
token：根据算法生成的值
token生成算法： token = sha1(秘钥+loginid+stamp)；
备注：
- 秘钥是泛微和明源协商好的，注意保密，集成参数中泛微密钥选项用来保存
- "+"为链接符
- loginid和stamp是变量，根据场景来替换真实的值
- 算法中的拼接顺序不能变