第三方app集成流程助手轻应用
问题描述:
云之家上的流程助手全员标准轻应用能否集成到第三方app上?比如泛微、致远OA等。
解决方案:
本文的集成方式已经不推荐使用,请前往查看新的集成方式:第三方app集成移动BOS
前言:
第三方app打开流程助手服务器的主页,主页会调用到eas接口,eas那边需要做的是首先做身份验证(即会访问app做身份验证),然后返回数据到流程助手服务器显示。
身份验证逻辑:token做单点登录,token可以第三方app生成,也可以自行开发加密生成,访问流程助手主页时带上token,流程助手会请求解密接口tokenurl(现场开发)获取eas用户信息,接口返回正确的eas用户信息后,流程助手身份验证并登陆eas,第三方app的集成登陆完成。
1、部署流程助手
部署文档:http://mbos.kingdee.com/doc/wiki.html?key=workflowDeploy
先按照文档部署,只执行链接中【步骤一】、【步骤二】和【步骤三】即可,不需要登录EAS门户安装部署;若此前按照此方法部署过流程助手,则可忽略,建议按照【步骤一】、【步骤二】和【步骤三】检查一下是否有相关私包和补丁。
2、流程助手页面说明
注:到部署页面输入eid的时候(下面eid均举例为123456),需要总部提供的标识第三方APP的eid,须现场提供客户名称、外网地址。
流程助手主页:
配置链接:http://bos.kingdee.com/workflow/main.html?eid=123456&appid=10036&token= XXXXXXX
打开应用是链接效果是(添加了token做单点登录):http://bos.kingdee.com/workflow/main.html?eid=123456&appid=10036&token= XXXXXXX
流程助手待办页:
配置链接:http://bos.kingdee.com/workflow/dealWithNotice.html?eid=123456&appid=10036
打开应用是链接效果是(添加了token和assignid):
一、第三方集成流程助手开发与配置
1.接口开发
1)第三方app进入流程助手接口accessurl
第三方app在打开链接会携带token
tokenurl接口(现场开发)能根据第三方app的token解析到对应的eas用户信息,则这个accessurl接口可以不用自己开发,第三方app配置的链接用流程助手的主页即可:https://bos.kingdee.com/workflow/main.html?eid=123456&appid=10036
第三方app在打开链接不携带token
现场需要开发accessurl供第三方app调用,接口的逻辑为:
获取到第三方app用户对应的eas用户,把eas的usernumber加密成一个字符串,也就是toke值,比如:usernumber加密后为W23WEGYWEWETEUREVD,然后接口响应跳转到流程助手的主页:https://bos.kingdee.com/workflow/main.html?eid=123456&appid=10036&token=W23WEGYWEWETEUREVD
Ps: usernumber就是eas数据库中表t_pm_user的fnumber字段,即eas用户的登录名
2)解析eas用户信息接口tokenurl
此接口流程助手调用,会把token值带上,接口的逻辑为根据这个token解析出usernumber,返回JSON的格式数据,如下:
{
“status”:“0”, --0 就是成功
“message”:“” --成功的时候传递usernumber (也就是eas登录的账号),失败的时候传递失败信息
}
这个接口确保能在eas服务器上访问即可,不要求公网访问,在网页访问测试
http://ip:port/a.action?token=XXXXXXX,看返回的数据是否正确,
2.修改EAS服务端配置文件
配置文件:eas/server/properties/XTServiceConfig.xml
修改说明:
配置OtherApp
在XTServiceConfig.xml 的 config节点下增加一个configitem节点:
tokenurl为接口名称。比如http://a.action?token=XXXXXXX,则值为http://ip:port/a.action
appid跟secret可根据业务场景配置,业务场景用不到使用默认的配置即可
<!--应用的AppSecret--> <configitem name="OtherApp"> <attribute key="tokenurl" value="http://ip:port/a.action "/> <attribute key="appid" value="10036" /> <attribute key="secret" value="gydasgdasdotwe156456daswer" /> </configitem> |
如图:
配置数据中心
添加数据库信息配置,复制添加下图标记部分,然后修改eid、数据中心代码、数据库类型。
3.配置映射
把eid和eas的portal外网的ip端口发给总部对接老师,需要在云端进行注册,至此完成流程助手轻应用跟第三方app的集成
第三方app集成流程助手轻应用
本文2024-09-22 20:35:09发表“eas cloud知识”栏目。
本文链接:https://wenku.my7c.com/article/kingdee-eas-114584.html