0405奥园aooffice项目_应用开发明源系统集成接口方案v1.0.pdfVIP

奥园 AoOffice 项目 明源系统集成接口方案 版本 1.0 系统名称 AoOffice 模块名称 明源轻应用集成 修订 Ver. No 日期 编制/修订 审核 批准 修改的章节号 V0.1 2015-4-22 黄泽波 新增 目录 1. 云之家轻应用开发架构3 1.1. 架构图及说明3 1.2. 参数说明3 2. 明源系统与云之家集成方案 4 2.1. 实现过程4 2.2. 用户关联方案4 2.3. 消息推送接口说明4 2.3.1. HTTP 请求地址4 2.3.2. HTTP 请求方式4 2.3.3. HTTP 内容类型4 2.3.4. 消息内容格式5 2.3.5. 消息内容组成5 2.4. 消息状态接口说明6 1. 云之家轻应用开发架构 1.1. 架构图及说明 1.2. 参数说明 轻应用通过云之家验证通过，返回的用户信息的JSON 格式默认为： 其中openid 需要通过是云之家用户的ID ，明源系统的用户需要和openid 进行绑定，appid 和eid 由金蝶 方提供。 轻应用页面可以接收以上传递过来的信息 2. 明源系统与云之家集成方案 2.1. 实现过程 云之家与明源系统的集成，云之家平台主要提供连接切入点，所有的页面逻辑需要明源系统提供，根据 上面云之家轻应用开发的架构说明，实现过程主要包括： 1、云之家用户与明源系统用户的关联 2、明源要提供待办列表、已办列表、打开、审批等页面 3、明源系统向云之家系统推送待办消息 （要包括打开待办页面的地址） 4、待办文件处理完成后，要把云之家的待办信息更改为已办 2.2. 用户关联方案 考虑到目前云之家与EAS 、OA 的用户已经实现了关联，而明源系统的用户账户和EAS 是一样的，所以 我们建议通过EAS 关联表实现云之家用户与明源系统用户的关联。EAS 与云之家的关联表： T_PM_EASXTUSERMAP 云之家用户ID 2.3. 消息推送接口说明 2.3.1. HTTP 请求地址 2.3.2. HTTP 请求方式 使用POST 方法进行请求 2.3.3. HTTP 内容类型 Content-Type: application/json 2.3.4. 消息内容格式 息内容使用符合JSON 规格的 格式，默认的字符编码格式为UTF-8 格式 2.3.5. 消息内容组成 消息内容由消息的 发、接收方、消息类型、 认证签名等不可见信息以及发布内容等可见信息组成。 { from: 方信息，格式为JSON 对象, to:接收方信息，格式为包含一至多个接收方信息JSON 对象的JSON 数组, type:消息类型，格式为整型, msg:发布到讯通的消息内容，格式为JSON 对象 } 1) from 的定义： { no: 方企业的企业 号(eID)，格式为字符串, pub: 使用的公共号ID ，格式为字符串, time: 时间，为currentTimeMillis() 以毫秒为 的当前时间 的字符串或数字, nonce:随机数，格式为字符串或数字, pubtoken:公共号加密串，格式为字符串。 } 2) to 的定义： [ { no:接收方企业的企业 号(eID)，格式为字符串, user:接收方的用户ID ，格式为包含OPENID 的JSON 数组