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

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

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

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


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

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

二、获取企业CropId信息

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


我的企业信息

三、获取syncSecret信息

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

管理工具

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

通讯录同步

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

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

企业微信管理控制台

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

应用与小程序


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


创建自建应用

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

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


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

应用创建完成

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

网页授权及JS-SDK

应用创建完成后需要验证域名,也就是O2OA服务器外网访问的域名需要如下验证。因为企业微信需要通过验证的证明这个域名地址是属于开发者所有。才能进行后续单点认证等操作。

工作台应用主页

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


五、获取CropSecret信息

第四步创建应用后,里面有一个secret,配置到O2OA里的CropSecret信息,具体参数说明在第六步:



六、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。

企业微信工作台

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

服务地址:http://o2oa服务器域名:20030/x_program_center/jest/index.html

服务名称:QiyeweixinAction.pullSync

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

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

中心服务器API界面


推荐文章:

密码管理-普通用户初始化密码设置
2021-02-25
O2OA可以配置新用户初始化密码的规则。本篇主要介绍如何配置新用户初始化密码的规则。
前端API-前端界面开发API文档
2021-03-02
O2OA使用前后端分离的模式进行系统设计,并且也开放了全部的后端API供开发者使用,开发者可以根据各类API组织出符合实际业务需求的新服务或者新业务。本文主要介
如何使用应用市场?
2021-02-18
工作管理,固定资产管理,移动门户,公文管理,用车管理,通知公告等,O2OA应用市场拥有丰富的可直接下载使用的模块。O2OA连接O2云之后,可以使用应用市场,免费
系统配置-开机自动启动O2Server
2021-02-19
O2OA开发平台允许将平台启动设置为跟随操作系统自动启动,这样避免服务器重启后,还需要手工启动O2Server的操作。本篇介绍如何在windows和Linux两
平台服务器主机架构配置推荐
2021-11-27
@平台部署@O2OA@开源办公系统@操作系统@集群架构 @服务器架构@主机架构图O2OA开发平台支持公有云,私有云和混合云部署,也支持复杂的网络结构下的分布式部
政务信息化协同平台演示环境
2021-08-27
概述政务信息化协同平台适用于政务部门、事业单位等。用户可以一目了然的看到政务工作中的待办事宜、通知公告等信息,也可以按用户的需要设置各类功能,如发文管理、收文管
系统配置-配置服务器连接O2云(V6.3后)
2021-09-13
@O2OA@开源办公系统@手机办公@O2云 @连接O2云O2OA拥有云端应用市场以及配套的移动办公APP,支持IOS和安卓端。用户可在连接O2云之后,使用APP
移动办公-钉钉扫码登录办公系统配置
2021-02-25
O2OA平台可以使用符合OAuth2标准的第三方认证进行平台的登录认证。本篇主要介绍如何将在O2OA中集成微信扫码登录功能。
系统配置-如何访问和操作内置数据库-H2
2021-02-25
O2OA平台内嵌了H2数据库,管理员可以通过支持JDBC的客户端对H2数据库进行访问和数据操作。本篇主要介绍如何访问H2数据库查询数据库信息以及操作数据。
业务开发-组织架构-下级组织创建操作
2021-02-26
O2OA提供多级组织架构设置能力,用户可以在系统内设置集团、分公司、部门、小组等多级企业组织结构来满足办公需要。本文主要介绍如何在O2OA中创建顶组织的下级组织

results matching ""

    No results matching ""