企业微信办公首页说明
本篇说明如何把 O2OA 平台作为自建应用接入企业微信，让通讯录与待办提醒在移动端形成闭环。文中按顺序给出准备企业微信账号、开启通讯录同步、创建应用并记录凭证、设置工作台主页与网页授权、填写平台配置文件的完整路径。接入后本地组织以企业微信架构为准，已建人员不会被删除，可能出现重复，需提前评估影响。同时提醒开启 HTTPS，并在凭证失效时改用同步专用密钥。
O2OA 平台可以以第自建应用的方式集成到企业微信，同步企业微信的企业通讯录作为本地组织人员架构，并且可以将待办等通知直接推送到企业微信进行消息提醒。
O2OA 办公开发平台基于 J2EE 分布式架构，支持移动办公、智能办公、私有化部署，并具备自适应负载能力；平台遵循 AGPL 协议开放源代码，可满足企业信息化系统的定制开发需求，能显著降低企业软件开发成本。
在首页的“平台下载”页面可直接下载该平台，本文主要介绍平台的企业微信办公功能。
功能概述
O2OA 平台可以以自建应用的方式集成到企业微信，同步企业微信的企业通讯录作为本地组织人员架构，并且可以将待办等通知直接推送到企业微信进行消息提醒。
O2OA 成功接入企业微信后，会自动从企业微信拉取全部人员和组织进行同步，本地的人员和组织以企业微信中创建的组织架构为准（本地已创建的人员和组织将保留、不会被删除，可能出现人员和组织重复）。
功能介绍
注册企业微信号（自行准备）
注册地址：https://work.weixin.qq.com/，此过程需要提供使用微信的企业相关信息。
注册成功后，需记住企业 id，后续配置会用到，如下图所示：
通讯录同步设置
打开通讯录同步，配置同步方式、权限，如下图所示：
添加 O2OA 为企业微信自建应用
创建应用
使用管理员账号登录企业微信，切换到“应用管理”页签，点击“创建应用”，如下图所示：
应用 LOGO：可自行制作合适大小的 LOGO，该 LOGO 将在企业微信中展示。
应用名称：应用的名称，可自行命名，如 O2OA、企业办公、XXOA 均可。
应用介绍：填写应用的具体用途。
可见范围：设定可使用此应用的人员范围，可选择组织和个人成员。
创建完成后，需记住 AgentId 和 Secret（此 secret 为 O2OA 配置文件 qiyeweixin.json 里 corpSecret 参数的值），后续配置会用到，如下图所示：
工作台应用主页设置
https://open.weixin.qq.com/connect/oauth2/authorize?appid=CORPID&redirect_uri=https%3A%2F%2F[host][port] %2Fx_desktop%2Fqiyeweixinsso.html%3Fredirect%3Dportalmobile.html%3Fid%3D*********&response_type= code&scope=snsapi_base&agentid=1000004&#wechat_redirect
appid : 企业id host : O2OA服务器提供服务的域名 port : O2OA服务器提供服务的端口 agentid : 应用的AgentId redirect_uri参数需要使用urlencode进行编码，不然会遇到50001错误，redirect_uri不是可信域名。 这个url是：http://[host]:[port]/x_desktop/qiyeweixinsso.html?redirect=portalmobile.html?id=************ 这样的形式。后面跟了一个redirect参数，就是需要跳转到一个门户页面，id就是门户（应用市场企业微信门户）标识
网页授权及 JS-SDK
授权文件放置路径：o2server/servers/webServer/
O2OA 接入配置
1、进入 o2oa 安装目录，从 o2server/configSample 目录拷贝 qiyeweixin.json 到 o2server/config 目录（如已复制，请跳过此步骤）；
2、使用文本编辑器打开 qiyeweixin.json 进行编辑：
{
"enable": false,
"syncCron": "10 0/10 * * * ?",
"forceSyncCron": "10 45 8,12 * * ?",
"apiAddress": "https://qyapi.weixin.qq.com",
"corpId": "",
"syncSecret": "",
"corpSecret": "",
"agentId": "",
"token": "",
"encodingAesKey": "",
"workUrl": "",
"messageRedirectPortal": "",
"messageEnable": false,
"scanLoginEnable": false,
"attendanceSyncEnable": false,
"attendanceSyncAgentId": "",
"attendanceSyncSecret": "",
"###enable": "是否启用.###",
"###syncCron": "拉入同步cron,默认每10分钟同步一次.###",
"###forceSyncCron": "强制拉入同步cron,默认在每天的8点和12点强制进行同步.###",
"###apiAddress": "api服务器地址###",
"###corpId": "企业微信corpId###",
"###syncSecret": "企业微信同步通讯录Secret###",
"###corpSecret": "企业微信corpSecret###",
"###agentId": "企业微信agentId###",
"###token": "回调token###",
"###encodingAesKey": "回调encodingAesKey###",
"###workUrl": "企业微信消息打开工作的url地址，如：http://dev.o2oa.net/x_desktop/###",
"###messageRedirectPortal": "企业微信消息处理完成后跳转到特定的门户页面的Id###",
"###messageEnable": "推送消息到企业微信###",
"###scanLoginEnable": "企业微信扫码登录###",
"###attendanceSyncEnable": "是否启用考勤信息###",
"###attendanceSyncAgentId": "企业微信考勤打卡应用id###",
"###attendanceSyncSecret": "企业微信考勤打卡应用secret###"
}token 和 encodingAesKey 可先填 1，否则无法保存，且对微信集成不会产生影响。
完成以上配置后重启 O2OA，即完成在企业微信中的接入，此时可在企业微信 - 工作台中看到已配置的企业应用。
注意企业微信同步通讯录 Secret 的配置：由于企业微信版本不同，若配置 corpSecret 无效，请改用 syncSecret。
syncSecret 位置如下图所示：
O2OA 集成到微信时，需要将 O2OA 的 HTTPS 开启。方法请参考《如何配置 O2OA 服务器来启用 HTTPS（SSL）》
手工从企业微信拉取组织人员数据
服务地址：http://localhost:20030/x_program_center/jest/index.html
服务名称：QiyeweixinAction.pullSync
在如下图所示界面点击 GET 后，观察服务器控制台或日志文件（o2server/logs），即可查看到同步日志。
GET 无需多次点击，点击一次后，控制台会出现正在拉取组织人员信息的相关日志。
相关问题讨论
如何将 O2OA 接入企业微信，在企业微信上使用移动办公
如果 O2OA 成功接入企业微信，O2OA 将会自动从企业微信拉取所有的人员和组织进行同步，O2OA 的所有人员和组织以企业微信中创建的组织架构为准（ 本地已经创建的人员和组织将保留不会被删除，可能会造成人员和组织重复 ）
查看原帖讨论 · 27,245 次浏览
相关内容
浙公网安备33010602013943号