OA系统工作台集成云星空轻分析功能

1、云星空新增OA移动端发布菜单

• 配置单点登录规则

1. 添加移动办公平台

轻分析管理员进入轻分析主题管理首页，点击管理---->发布管理---->移动轻应用---->设置---->移动轻应用管理

点击添加移动办公平台

输入移动办公平台ID、用户标识，上传移动办公平台图标后点击确定保存。移动办公平台ID由产品研发团队颁发，获取方式见附录；用户标识与下文第二步获取accessToken的请求参数appUserType的值所对应。

1. 星空新增第三方系统单点登录信息

管理员登录星空，点击系统管理，第三方系统登录授权。

点击新增，获取应用ID，按照提示获取星空应用ID，星空应用密钥，填写应用名称。

• 通过二次开发的方式获取轻分析移动端的H5页面链接

为了在移动办公平台APP上能看到发布到移动轻应用的卡片，需要通过二次开发来获取轻分析移动端的H5页面链接，二次开发的代码部署在客户自己的服务器上。如图所示，在移动办公平台APP上跳转至客户部署二开代码的服务器地址，再重定向到轻分析移动端H5页面链接。

接下来讲述通过二次开发的方法如何调用API接口构建一条单点登录到轻分析移动端H5页面的链接。

1. 获取accessToken接口

1. 服务器地址

https://q.kingdee.com/qing-lightapp/webApi/getAccessToken

1. 请求方式：POST
2. 参数说明

参数说明	必选	类型	说明
appId	是	string	移动办公平台id，由轻分析产品研发团队颁发
timestamp	是	string	Unix时间戳，单位：秒，形如：1552879016
sign	是	string	签名串，除sign外，其他参数均参与签名，签名规则：参数名按字典顺序，把参数值（不含参数名）连接起来，然后md5生成的32位小写字符串，如： md5(appId+appSecret+cipher+timestamp)，不含加号
cipher	是	string	请求业务数据集（json格式数据），是把json数据经过base64加密的字符串，另外，base64密文字符串还需要再进行utf8格式的urlencode处理。注意：参与签名时，需去掉urlencode

注：appId和appSecret获取方式见附录

1. cipher参数说明(json数据):

参数说明	必选	类型	说明
appUserId	是	string	产品端的用户标识（用户名）
appUserType	是	string	产品端的用户标识类型（UserName），与appUserId的值相关。

cipher参数格式：

{

    " appUserId ":"xxxxxxxxxxxx", 

    "appUserType":"UserName"

}

注：此cipher参数值(json)，需base64加密且密文要经过urlencode处理

1. 请求示例

POST  /qing-lightapp/webApi/getAccessToken  HTTP/1.1

Host: [serverUrl]

Content-Length: xxx

Content-Type: application/x-www-form-urlencoded

appId=xxx×tamp=xxx&sign=xxx&cipher=xxx

1. 返回参数说明（json格式数据）

返回值（失败）

{

  "errorCode": "XX",

  "errorMessage": "XXX"

}

返回值（成功）

{

“data”:

{

“accessToken”: “xxx”

}

}

注：accessToken和用户绑定，两个小时有效，每次调用如果当前用户已有accessToken并没过期则自动延期，有效期重新变为2小时。没有则创建新的accessToken。以后每次业务系统访问轻应用，都携带accessToken访问。

1. 构造轻分析移动端H5页面单点登录链接

1. H5页面链接

https://q.kingdee.com/qing-lightapp/index.html?accessToken=xxx&appType=thirdparty

1. 参数说明

参数说明	必选	类型	说明
accessToken	是	string	登录凭证
appType	是	string	APP类型，固定为thirdparty

注：二次开发代码可参考附录

• 附录

1. appId（移动办公平台ID）和appSecret获取方式

云之家联系郑裕侠获取，同时提供星空应用ID、星空应用密钥、产品唯一编码：

（1）第一步中星空新增第三方系统单点登录信息所获取的星空应用ID和星空应用密钥，用于轻分析移动端与星空平台之间的交互；

（2）产品唯一编码，用于检验appId是否填写正确。在第一步中添加移动办公平台所在界面，将鼠标移动到第一个红点，当鼠标变为手的形状，按下鼠标左键的同时按下[ctrl]键，下方便会出现产品唯一编码。

2、OA新增移动端

2.1：OA后端应用中心-移动引擎-新增移动应用(轻分析)

2.2：设计移动应用-源码-编写Javascript代码

2.3：获取轻分析链接在OA移动端访问（部分代码）：

 oa系统支持直接访问jsp代码执行后端功能逻辑处理。