移动办公-将平台集成到华为WeLink

关键词:华为WeLink办公,移动办公,O2OA WeLink办公,手机办公,WeLink办公

O2OA平台拥有配套的原生开发的安卓和IOS移动APP，可以以WeLink企业内部轻应用的方式集成，同步WeLink的通讯录作为本地组织人员架构，并且可以将待办等通知直接推送到WeLink进行消息提醒。本篇主要介绍如何将O2OA集成到华为WeLink实现移动办公。

如果O2OA成功接入WeLink，O2OA将会自动从WeLink拉取所有的人员和组织进行同步，O2OA的所有人员和组织以WeLink中创建的组织架构为准（本地已经创建的人员和组织将保留不会被删除，可能会造成人员和组织重复）。

一、前提条件

1、完成O2OA部署，平台可以正常访问

2、确保O2OA平台可以正常通过公网进行访问（不是内网）

二、注册华为WeLink

企业需要自行去华为云网站注册企业。注册地址：

https://register.welink.huaweicloud.com/welinkRegister.html?origin-type=webLoginRegister

三、创建轻应用

创建完成后，登录到管理平台，在应用管理中找到开放平台，去创建一个轻应用：

iShot2020-07-3114.54.45.png

填写应用名称和图标：

添加应用访问地址：

这里可以添加手机端地址、pc端地址，这些地址就是访问O2OA的地址，写入方式固定如下：

地址格式    ：http://[serverIp]:[port]/x_desktop/welinksso.html
(其中[serverIp]为您部署的O2OA公网IP或者域名。[port]是开放的web端口，默认为80不用填写。
地址后面还可以跟一个redirect参数，如：?redirect=portalmobile.html%3Fid%3D********** ，
就是登录成功后跳转到门户页面，星号代表门户的id)

开启权限：

上面修改首页地址的按钮下面还有一个设置接口权限的超链接，点击进入权限开启，开启如下：

四、O2OA接入配置参数

查看应用id等信息：

到应用的 基本信息 标签页，查看应用的client_id和client_secret 。

配置文件修改：

1）进入o2oa安装目录，从o2server/configSample 目录下拷贝 welink.json 到 o2server/config 目录（如果已经复制过了，请跳过此步骤）

2）使用文本编辑器打开welink.json进行编辑

{
  "enable": true,
  "clientId": "",
  "clientSecret": "",
  "syncCron": "10 0/10 * * * ?",
  "forceSyncCron": "10 45 8,12 * * ?",
  "oapiAddress": "https://open.welink.huaweicloud.com/api",
  "messageEnable": false,
  "workUrl": "",
  "messageRedirectPortal": "",
  "###enable": "是否启用.###",
  "###syncCron": "拉入同步cron,默认每10分钟同步一次.###",
  "###forceSyncCron": "强制拉入同步cron,默认在每天的8点和12点强制进行同步.###",
  "###oapiAddress": "api服务器地址###",
  "###clientId": "华为WeLink轻应用的client_id###",
  "###clientSecret": "华为WeLink轻应用的client_secret###",
  "###messageEnable": "推送消息到华为WeLink###",
  "###workUrl": "华为WeLink消息打开工作的url地址，如：http://dev.o2oa.net/x_desktop/###",
  "###messageRedirectPortal": "华为WeLink消息处理完成后跳转到特定的门户页面的Id###"
}

参数说明：

"enable": "是否启用WeLink接入: true | false",  
"clientId": "前面在WeLink应用基本信息中查看的client_id",
"clientSecret": "前面在WeLink应用基本信息中查看的client_secret",\
"syncCron": "拉入同步时间表达式, 默认每10分钟同步一次(10 0/10 * * * ?).",
"forceSyncCron": "强制拉入同步cron, 默认在每天的8点和12点强制进行同步(10 45 8,12 * * ?)",
"oapiAddress": "企业钉钉api服务器地址, 固定填写：https://open.welink.huaweicloud.com/api ",
"messageEnable": "是否允许推送消息到企业微信: true | false",
"workUrl":"这个参数是为了企业微信推送的工作消息开启超链接功能，这里配置o2oa服务器地址， 如：http://dev.o2oa.net/x_desktop/"
"messageRedirectPortal":"这个参数是配置一个门户id，是上面工作消息打开后处理完成跳转的门户页面"

3）按要求填写配置信息，保存后重启o2oa服务器即可。

集成效果：

五、手工从WeLink拉取组织人员数据

服务地址：http://localhost:20030/x_program_center/jest/index.html

服务名称：WeLinkAction.pullSync

如下图所示界面，点击GET之后，观察服务器控制台或者日志文件信息（o2server/logs），可以查看到同步日志。

请注意，不要多次点击GET，点击一次后控制台会有正在拉取组织人员信息相关的日志。