关键词:移动办公,O2OA微信办公,企业微信办公,微信办公,手机办公

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


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

O2OA接入企业微信建议先配置好企业微信应用,待组织和人员从企业微信同步完成后,再进行组织和人员的信息编辑,避免人员和组织信息的重复创建。

一、注册企业微信号(自行准备)

注册地址:https://work.weixin.qq.com/,此过程需要提供使用微信的企业相关信息。

二、获取企业CropId信息

注册成功后,使用管理员账号登录企业微信,在[我的企业]信息最后一行可以获取企业的CropId,如下图所示:


我的企业信息

三、获取CropSecret信息

在管理工具 - 通讯录同步配置里进行API信息查询和配置


管理工具

配置同步方式、权限,并且获取Secret,该Secret就是后续需要配置到O2OA里的CropSecret信息:


通讯录同步

四、添加O2OA为企业微信自建应用

注册成功后,使用管理员账号登录企业微信,如下图所示:


企业微信管理控制台

点击[应用与小程序],如下图所示界面:


应用与小程序

如上图所示,点击[创建应用],继续在自建程序区域创建应用:


创建自建应用

填写好应用相关信息后进行应用创建:填写好应用相关信息后进行应用创建:

应用LOGO:可以自行制作合适大小的LOGO,此LOGO将在企业微信中展示。
应用名称:此应用的具体名称,可以随意命名,如O2OA,企业办公,XXOA都可以。
应用介绍:此应用的具体用途介绍。
可见范围:可使用此应用的人员范围设定,可以选择组织和个人成员。


应用创建完成后,如下图所示界面:

应用创建完成
您可以在界面中获取AgentId信息,这两个信息以及之前获取的CropId将配置到O2OA相关的接入配置中,请牢记此信息。

网页授权及JS-SDK

授权文件放置路径:o2server/servers/webServer/

工作台应用主页

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 : 企业的corpId
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就是门户的id,不配置这个参数也行,进入的是一个默认的待办列表页面。

五、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": "是否启用企业微信接入: true | false",
"syncCron": "拉入同步时间表达式, 默认每10分钟同步一次(10 0/10 * * * ?).",
"forceSyncCron": "强制拉入同步cron, 默认在每天的8点和12点强制进行同步(10 45 8,12 * * ?)",
"apiAddress": "企业微信api服务器地址, https://qyapi.weixin.qq.com",
"corpId": "企业微信参数corpId(从企业微信后台管理信息中获取 '企业ID')",
"syncSecret":"企业微信同步通讯录Secret",
"corpSecret": "企业微信参数corpSecret(从企业微信后台管理信息中获取 'Secret')",
"agentId": "企业微信参数agentId(从企业微信后台管理信息中获取 'AgentId')",
"messageEnable": "是否允许推送消息到企业微信: true | false",
"token":"回调token",
"encodingAesKey": "回调encodingAesKey###",
"workUrl":"这个参数是为了企业微信推送的工作消息开启超链接功能,这里配置o2oa服务器地址, 如:http://dev.o2oa.net/x_desktop/"
"messageRedirectPortal":"这个参数是配置一个门户id,是上面工作消息打开后处理完成跳转的门户页面"
"messageEnable": "推送消息到企业微信###",
"scanLoginEnable": "企业微信扫码登录###",
"attendanceSyncEnable": "是否启用考勤信息###",
"attendanceSyncAgentId": "企业微信考勤打卡应用id###",
"attendanceSyncSecret": "企业微信考勤打卡应用secret###"


tokenencodingAesKey可以先填1,不然无法进行保存,对微信集成不会产生影响。
完成以上配置后重启O2OA,即可完成O2OA在企业微信中的接入,可以在企业微信 - 工作台中看到自己配置的企业应用。

注意一下企业微信同步通讯录Secret配置,由于企业微信本身的不同版本原因,如果配置corpSecret不行,请使用syncSecret。


企业微信工作台

O2OA集成到微信时,需要将O2OA的HTTPS开启。方法请参考《如何配置O2OA服务器来启用HTTPS(SSL)》
**

、手工从企业微信拉取组织人员数据


服务地址:http://**localhost**:20030/x_program_center/jest/index.html
服务名称:QiyeweixinAction.pullSync
如下图所示界面,点击GET之后,观察服务器控制台或者日志文件信息(o2server/logs),可以查看到同步日志。
不要多次点击GET,点击一次后,控制台会有正在拉取组织人员信息相关的日志。


中心服务器API界面

推荐文章:

流程设计-流程设计与应用权限设置
2021-02-26
本文主要介绍如何在O2OA中进行审批流程或者工作流设计,O2OA主要采用拖拽可视化开发的方式完成流程的设计和配置,不需要过多的代码编写,业务人员可以直接进行修改
平台服务器版本升级操作说明
2021-02-25
O2OA信息化系统开发平台提供离线升级命令,用户可以下载最新的安装包到服务器进行服务器升级,系统升级时可以对旧程序进行备份,让升级操作更加可靠。
信息栏目-创建栏目和分类
2021-03-01
O2OA提供的信息管理功能可以帮助用户快速地配置信息发布栏目,如通知公告,公司动态,规章制度等。用户可以高效地完成信息栏目和配置。本文主要介绍如何在O2OA中完
系统安全-启用HTTPS(百度云版)
2021-02-25
为增加系统和用户的安全性,平台支持启用HTTPS,使用SSL对网络流量进行证书加密传输。本篇主要介绍如何将在O2OA中启用HTTPS。
组织人员同步-封装Api接口完成同步
2021-04-07
O2OA允许用户自定义接口和代码逻辑来完成系统与第三方业务系统的数据同步,人员和组织的同步。本文主要介绍组织人员同步的数据操作规范。
开发知识-React篇:在React应用中集成O2OA
2021-02-07
  在前面的章节中,我们介绍了两种在O2OA中使用React开发应用的方式,已经可以满足绝大多数的情况了。如果您考虑完全脱离O2的web服务器,自己搭建web服
平台服务器下载及安装部署-Windows系统
2021-02-25
O2OA信息化系统开发支持公有云,私有云和混合云部署,也支持复杂的网络结构下的分布式部署。O2OA开发平台安装部署非常方便,只需要简单的三步即可完成安装。平台内
源码编译-IOS客户端打包处理
2021-03-15
O2OA是真正全代码开源的应用开发平台,开发者可以直接使用从github或者gitee上clone的源码编译成IOS客户端,代码可以修改,安全可靠,无限制。本文
系统配置-消息提醒配置说明
2021-02-25
O2OA平台设计了灵活的消息提醒数据交互方式,开发者可以根据自己的需要,来消费消息提醒数据,也可以将消息提醒数据接入到Kafka消息中间件来实现消息的准实时提醒
组织人员导入-根据Excel模板导入组织人员数据
2021-03-03
O2OA允许管理员根据Excel模板批量对组织和人员数据进行导入导出操作。本文主要介绍如何在O2OA中完成组织和人员的导入导出操作。

results matching ""

    No results matching ""