11993-2019金蝶国际软件集团有限公司④内部公开请勿外传董彪2020年8月1993-2018金蝶国际软件集团有限公司金蝶云星空BOS专题中级课-移动平台集成2疑惑企业微信可以收到超时提醒吗？钉钉可以进行业务审批吗？云之家消息处理后，仍然存在，怎么办？…好多问题？？？第三方平台怎么接入金蝶云星空？3Content010203总体介绍开发平台集成（云之家、企业微信、钉钉）第三方平台集成常见问题分析04答疑054总体介绍–移动平台集成及消息推送流程图5总体介绍–标准轻应用和自建轻应用的区别标准轻应用金蝶云星空预置的标准应用，如：业务审批、掌上报销、移动销售等。特性：1.无需创建，不可编辑或删除；2.不需要配置应用id和应用密钥；3.不需要配置应用的链接；4.通过星空应用管家配置数据中心；适用于：云之家、企业微信；自建轻应用企业自建轻应用，可以是移动单据、移动表单或其他类型的导航页面。特性：1.自行创建，可编辑删除；2.需要配置应用id和应用密钥；3.需要配置应用的链接；4.通过管理中心启用默认数据中心；适用于：云之家、企业微信、钉钉、第三方平台；6Content010203总体介绍移动平台集成第三方平台集成常见问题分析04答疑057移动平台集成–总体介绍15423集成步骤金蝶云星空中创建移动轻应用，配置公网地址和消息开关开放平台中创建轻应用（云之家、企业微信、钉钉）金蝶云星空中配置开放平台中的应用金蝶云星空中建立应用映射并生成配置链接开放平台中修改链接、发布测试8移动平台集成–创建移动轻应用创建移动轻应用I.Administrator登录金蝶云星空-->移动轻应用管理-->新增轻应用；9移动平台集成–设置系统公网地址及消息开关移动平台参数设置I.Administrator登录金蝶云星空-->参数设置-->基础管理-->移动平台-->输入系统公网地址；II.如需接受对应移动平台消息，请开启对应的开关10移动平台集成-详细介绍云之家企业微信第三方钉钉•支持发送待办消息•支持待办转已办•支持发送普通消息•支持公有云•支持发送待办消息•支持发送普通消息•支持公有云•服务号不支持消息•支持发送待办消息•支持发送普通消息•支持公有云•支持发送待办消息•支持发送普通消息•公有云集成使用第三方方式11移动平台集成–云之家集成获取EID和密钥I.管理员登录云之家后台：https://www.yunzhijia.com进入您的团队；II.管理中心-->团队概况，获取EID；III.管理中心-->系统设置-->系统集成-->下载密钥；IV.云之家标准轻应用集成，请参考：https://vip.kingdee.com/article/1702061、云之家后台获取云之家团队EID和密钥12移动平台集成–云之家集成新增轻应用I.管理员登录云之家-->进入创建的团队-->管理中心-->轻应用管理-->新建应用；II.获取请轻应用的appid和appsecret；2、云之家后台新增云之家轻应用13移动平台集成–云之家集成参数设置I.Administrator登录金蝶云星空-->参数设置-->基础管理-->移动平台-->输入EID和私钥以及，系统公网地址；II.如需接受云之家消息，请勾选“发送云之家消息”；3、金蝶云星空设置系统公网地址、消息开关、团队EID、私钥。14移动平台集成–云之家集成云之家轻应用I.Administrator登录金蝶云星空-->云之家轻应用列表-->新增轻应用；4、金蝶云星空中配置云之家轻应用15移动平台集成–云之家集成移动轻应用I.Administrator登录金蝶云星空-->移动轻应用管理-->修改轻应用；5、金蝶云星空生成轻应用链接16移动平台集成–云之家集成设置轻应用链接I.Administrator登录云之家后台-->管理中心-->轻应用管理-->您创建的轻应用-->修改；6、云之家中设置轻应用中移动端的链接17移动平台集成–云之家集成访问路径I.进入手机端云之家-->切换到创建的团队-->企业自建应用-->访问刚创建的轻应用；7、访问轻应用18移动平台集成-详细介绍云之家企业微信第三方钉钉•支持发送待办消息•支持待办转已办•支持发送普通消息•支持公有云•支持发送待办消息•支持发送普通消息•支持公有云•服务号不支持消息•支持发送待办消息•支持发送普通消息•支持公有云•支持发送待办消息•支持发送普通消息•公有云集成使用第三方方式19移动平台集成–企业微信集成获取企业IDI.管理员登录企业微信后台：https://work.weixin.qq.com/进入您的企业-->我的企业；II.企业微信标准应用集成，请参考：https://vip.kingdee.com/article/686345210080317441、企业微信后台获取企业ID20移动平台集成–企业微信集成创建应用I.应用管理-->应用-->自建-->创建应用；II.创建成功后，获取应用id：AgentId和应用密钥：Secret。2、企业微信后台创建应用21移动平台集成–企业微信集成设置网页授权I.应用管理-->创建的应用-->开发者接口-->网页授权及JS-SDK；3、企业微信后台设置应用网页授权及JS-SDK。22移动平台集成–企业微信集成企业微信集成设置I.Administrator登录金蝶云星空-->基础管理-->移动设置-->企业微信集成配置；II.配置企业微信应用相关信息；4、金蝶云星空配置企业微信应用23移动平台集成–企业微信集成生成链接I.Administrator登录金蝶云星空-->移动轻应用管理-->修改轻应用；5、金蝶云星空生成轻应用链接24移动平台集成–企业微信集成设置链接I.管理员登录企业微信后台-->应用管理-->您的应用-->工作台应用主页或自定义菜单-->输入上文获得的链接；6、企业微信中设置应用的工作台链接或菜单链接25移动平台集成–企业微信集成访问轻应用I.进入企业微信-->切换到创建的团队-->工作台-->访问刚创建的轻应用；7、访问轻应用26移动平台集成-详细介绍云之家企业微信第三方钉钉•支持发送待办消息•支持待办转已办•支持发送普通消息•支持公有云•支持发送待办消息•支持发送普通消息•支持公有云•服务号不支持消息•支持发送待办消息•支持发送普通消息•支持公有云•支持发送待办消息•支持发送普通消息•公有云集成使用第三方方式27移动平台集成–钉钉集成获取CorpIDI.管理员登录钉钉开放平台：https://open-dev.dingtalk.com/进入您的企业II.钉钉集成金蝶云星空公有云，需要使用第三方平台集成的方案(钉钉端应用需要设置“服务器出口IP”,而公有云是共享IP)1、钉钉后台获取企业ID：CorpID28移动平台集成–钉钉集成创建应用I.应用开发-->企业内部开发-->H5微应用-->创建应用；II.创建成功后，获取应用凭证：AgentId、AppKey、AppSecret。2、钉钉后台创建应用29移动平台集成–钉钉集成设置出口IPI.应用开发-->企业内部开发-->H5微应用-->进入您的应用-->开发管理；3、钉钉后台设置服务器出口IP。30移动平台集成–钉钉集成钉钉集成设置I.Administrator登录金蝶云星空-->基础管理-->移动设置-->钉钉集成设置；II.业务审批为系统预置标准应用，直接选择即可，其他应用需要自建III.配置钉钉应用相关信息，并生成轻应用链接；4、金蝶云星空配置钉钉应用31移动平台集成–钉钉集成移动轻应用I.管理员登录钉钉后台-->应用开发-->企业内部开发-->H5微应用-->进入您的应用-->开发管理；5、钉钉中设置应用的首页地址并发布32移动平台集成–钉钉集成访问路径I.进入钉钉-->切换到创建的团队-->工作台-->访问刚创建的轻应用6、访问轻应用33Content010203总体介绍移动平台集成第三方平台集成常见问题分析04答疑0534移动平台集成–第三方平台集成注意事项：I.适用版本：7.xPT-146850及以上补丁（2020年8月27日）；II.该方案适用钉钉集成金蝶云星空公有云；III.如果不需要使用消息推送功能，只需要实现单点登录即可；1.接入流程与注意事项：35移动平台集成–第三方平台集成2.1参数设置I.Administrator登录金蝶云星空，搜索表单：第三方系统登录授权，点击新增，记录应用id和密钥；II.实际单点登录用户名，需要根据第三方系统登录用户，找对应的金蝶云星空用户；2、单点登录。36移动平台集成–第三方平台集成2.2代码实现I.开发者获取上文提到的应用id，应用密钥，以及当前登录用户名；II.生成单点登录的链接，并通过中转页面中进行跳转，c#代码示例如下：2、单点登录。37移动平台集成–第三方平台集成2.2代码实现I.生成base64字符串II.生成签名；III.生成时间戳；IV.Json中的参数名，严格区分大小写；2、单点登录。38移动平台集成–第三方平台集成3.1集成配置I.Administrator登录金蝶云星空后台，搜索表单：第三方平台集成配置；II.关联的金蝶云轻应用，选择：业务审批3、消息推送设置。39移动平台集成–第三平台集成3.2参数设置I.Administrator登录金蝶云星空-->参数设置-->基础管理-->移动平台-->输入系统公网地址；II.如需接受第三方消息消息，请开启“发送第三方消息”；3.消息推送设置40移动平台集成–第三方平台集成3.1消息推送接口I.开发者需要实现Kingdee.BOS.Mobile.Contract.IOtherPlatformMessage中的Send接口，如右上图所示：II.同时提供了一个实现的伪类，供参考，如右下图所示；3、消息推送实现。41移动平台集成–第三方平台集成3.2参数及返回值定义I.返回参数MobileMessage类的定义，如右上图所示：II.返回类型MobileResponse的定义，如右下图所示；3、消息推送实现。名称描述类型Title待办任务标题StringText待办任务内容StringSourceType消息类型StringSourceId待办任务idStringStatus消息状态枚举，待办todo=1；已办done=2MsgStatusUses接受者用户列表List名称描述类型Errcode返回结果：0成功，小于0失败LongErrmsg错误信息String42移动平台集成–第三方平台集成3.3.注意事项：a.message中的users为消息接收者的金蝶云星空的用户id列表，当消息类型为待办转已办时候，该用户id可能为：PUSH_ALL_USERS；b.开发者需要自己维护：第三方系统与金蝶云星空系统的用户映射列表；c.推送的消息体中不包含url，消息打开的链接需要开发者，根据单点登录的方案自助生成，详见下文；d.该消息为异步发送，如果立即查询金蝶云星空系统中待办任务及流程相关数据，可能会遇到相关数据查询不到情况；若遇到该问题，可以做一个间隔重试的操作。43Content010203总体介绍移动平台集成第三方平台集成常见问题分析04答疑0544移动平台集成–常见问题分析配置问题I.管理中心中，启用了“移动设置”的数据中心与实际不匹配；II.移动平台参数启用设置中，消息开关未开启；III.移动平台单据启用设置中，未包含对应的单据，或者未启用移动审批；IV.企业微信应用未勾选“启用工作流”（企业微信）；1、收不到待办消息，怎么办（云之家、企业微信、钉钉）？45移动平台集成–常见问题分析用户映射问题V.用户映射不对，未绑定或者绑定错误；VI.金蝶云星空中的云之家、企业微信、钉钉用户映射中的需要包含该用户；VII.用户映射中的openid需要与云之家、企业微信，钉钉通讯录中保持一致；1、收不到待办消息，怎么办（云之家、企业微信、钉钉）？46移动平台集成–常见问题分析服务器屏蔽问题IX.服务器屏蔽了与云之家、微信、钉钉的相关的域名或请求；X.测试办法：在服务器上打开右边链接，未屏蔽的话，会返回一个json数据包；1、收不到待办消息，怎么办（云之家、企业微信、钉钉）？1、云之家请求地址：https://yunzhijia.com/gateway/newtodo/open/generatetodo.json?accessToken2、企业微信请求地址：https://qyapi.weixin.qq.com/cgi-bin/get_jsapi_ticket?access_token3、钉钉请求地址：https://oapi.dingtalk.com/topapi/workrecord/add?access_token=ACCESS_TOKEN47移动平台集成–常见问题分析原因排查I.管理中心中，启用了“移动设置”的数据中心与实际不匹配；II.外网访问端口与内网访问端口不一致；2、待办消息打开报错，怎么办（云之家、企业微信、钉钉）？•Administrator金蝶云星空管理中心-->数据中心-->移动应用管理-->移动应用设置：48移动平台集成–常见问题分析待办没有转已办I.首先确认，pc端是否该任务已处理，如果未处理，可能是实际并未审批；II.该消息可能为测试服务器或者账套发送，与实际实用的服务器和账套不一致；III.需要保持一致；IV.已确认是其他账套发的无效的消息，点击忽略即可；3、为什么待办消息处理后，仍停留在待审批里面（云之家）？49附录：论坛相关知识贴移动bos云之家集成：自建轻应用移动bos企业微信集成：自建轻应用移动BOS钉钉集成：金蝶云私有云移动平台第三方系统集成方案V2.0企业微信收不到待办通知的原因排查50答疑时间答疑51Thanksterimakasih感謝谢谢ありがとうขอบคุ ณ1993-2019金蝶国际软件集团有限公司
