開源OA協同辦公系統:O2OA搭建企業微信辦公首頁說明


O2OA辦公開發平台基於J2EE分布式架構,集成移動辦公、智能辦公、支持私有化部署,自適應負載能力。O2OA基於AGPL協議開放源代碼的企業信息化系統需求定制開發平台解決方案,能夠極大程度上節約企業軟件開發成本。

開源的O2OA平台能以自建應用的方式集成到企業微信,同步企業微信的企業通訊錄作為本地組織人員架構,並且可以將待辦等通知直接推送到企業微信進行消息提醒。

如果O2OA成功接入企業微信,O2OA將會自動從企業微信拉取所有的人員和組織進行同步,O2OA的所有人員和組織以企業微信中創建的組織架構為准( 本地已經創建的人員和組織將保留不會被刪除,可能會造成人員和組織重復 )

使用方法:

一、注冊企業微信號

第一步就是注冊企業微信(此過程需要提供使用微信的企業相關信息,可以提前進行准備)

注冊成功后,需記住企業id,下面配置需用到,位置如下圖所示:

二、通訊錄同步設置

打開通訊錄同步,配置同步方式、權限,如下圖所示:

三、添加O2OA為企業微信自建應用

1、創建應用

首先使用管理員賬號登錄企業微信,切換到“應用管理”頁簽,點擊“創建應用”,如下圖所示:

應用LOGO:可以自行制作合適大小的LOGO,此LOGO將在企業微信中展示。

應用名稱:此應用的具體名稱,可以隨意命名,如O2OA,企業辦公,XXOA都可以。

應用介紹:此應用的具體用途介紹。

可見范圍:可使用此應用的人員范圍設定,可以選擇組織和個人成員。

創建完成后,需記住AgentId和Secret(此secret為O2OA配置文件qiyeweixin.json里的corpSecret參數的值),下面配置有用到,如下圖所示:

2、工作台應用主頁設置

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接入配置

A、進入o2oa安裝目錄,從o2server/configSample 目錄下拷貝 qiyeweixin.json 到 o2server/config 目錄(如果已經復制過了,請跳過此步驟);

B、使用文本編輯器打開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###"

}

tokenencodingAesKey可以先填1,不然無法進行保存,對微信集成不會產生影響。

完成以上配置后重啟O2OA,即可完成O2OA在企業微信中的接入,可以在企業微信 - 工作台中看到自己配置的企業應用。

注意一下企業微信同步通訊錄Secret配置,由於企業微信本身的不同版本原因,如果配置corpSecret不行,請使用syncSecret。

syncSecret為如下圖所示:

備注:O2OA集成到微信時,需要將O2OA的HTTPS開啟。

五、從企業微信拉取組織人員數據

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

服務名稱:QiyeweixinAction.pullSync

如下圖所示界面,點擊GET之后,觀察服務器控制台或者日志文件信息(o2server/logs),可以查看到同步日志。

不要多次點擊GET,點擊一次后,控制台會有,正在拉取組織人員信息相關的日志。

六、企業微信效果展示


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM